verfi-mcp-server

@verfi/mcp-server

MCP server for Verfi — TCPA consent verification tools for AI agents.

Tools

| Tool | Description | |------|-------------| | verfi_verify_consent | Check if a lead has valid consent. The primary tool for compliance verification. | | verfi_get_proof | Get full machine-readable consent proof for a session. | | verfi_search_session | Look up a session by Verfi ID with optional PII hash verification. | | verfi_claim_session | Claim a session (starts 3-year retention). | | verfi_unclaim_session | Release a claimed session. | | verfi_list_sessions | List your claimed sessions (paginated). | | verfi_update_expiration | Update a claimed session's expiration date. | | verfi_add_sdk | Get SDK integration snippet and setup instructions. |

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "verfi": {
      "command": "npx",
      "args": ["-y", "@verfi/mcp-server"],
      "env": {
        "VERFI_API_KEY": "sk_your_secret_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP config:

{
  "verfi": {
    "command": "npx",
    "args": ["-y", "@verfi/mcp-server"],
    "env": {
      "VERFI_API_KEY": "sk_your_secret_key_here"
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | VERFI_API_KEY | Yes | Your Verfi secret API key (sk_...) | | VERFI_API_URL | No | API base URL (defaults to https://api.verfi.io/tenant/v1) |

Quick Start

Developer: "Check if lead VF-a1b2c3d4 has valid TCPA consent"

Agent calls: verfi_verify_consent({ verfiID: "VF-a1b2c3d4" })

→ { consent_valid: true, tcpa_compliant: true, proof_url: "..." }

API Key Scopes

Your API key's scopes determine which tools are available:

• sessions:search → verfi_search_session
• sessions:proof → verfi_get_proof, verfi_verify_consent
• sessions:claim → verfi_claim_session
• sessions:unclaim → verfi_unclaim_session
• sessions:expiration → verfi_update_expiration

Generate API keys in the Verfi dashboard under Integration > API Keys.

License

MIT