WhatConverts MCP Connector

Plain-language MCP server for WhatConverts leads, accounts, and attribution.

Same Claude OAuth + Cloud Run pattern as meta-mcp-connector. Ask about leads, sources, campaigns, and sales value in natural language.

Features

• Live data from the WhatConverts API

• List agency accounts / profiles (master key) or query leads with a profile key

• Lead summary, daily trend, and breakdowns (source, medium, campaign, type, …)

• Search by email or phone; update quote / sales values

• Leads dashboard (leads-dashboard.html)

• Claude.ai OAuth when deployed to Cloud Run (MCP_PUBLIC_URL)

Related MCP server: mcp-gads

Project structure

whatconverts-mcp-connector/
├── whatconverts_mcp_server.py   # MCP server + HTTP routes
├── whatconverts_tools.py        # All MCP tools (full API coverage)
├── whatconverts_api.py          # WhatConverts API client
├── whatconverts_oauth.py        # Claude-compatible OAuth provider
├── leads-dashboard.html
├── test-accounts.html
├── setup.html                   # How to get API Token + Secret
├── requirements.txt
├── Dockerfile
├── deploy-cloudrun.ps1
├── .env.example
└── .cursor/mcp.json

Setup (local)

1. Install

cd whatconverts-mcp-connector
python -m venv .venv

# Windows
.venv\Scripts\activate

pip install -r requirements.txt
copy .env.example .env

2. Configure .env

WHATCONVERTS_API_TOKEN=your_token
WHATCONVERTS_API_SECRET=your_secret
WHATCONVERTS_ACCOUNT_ID=
WHATCONVERTS_PROFILE_ID=

Credentials

1. Sign in at app.whatconverts.com

2. Profile key: Tracking → Integrations → API Keys → Generate

3. Master key (agency): Master Integrations → API Keys

4. Copy Token + Secret into .env

Auth is HTTP Basic (token:secret). See /setup after starting the server.

3. Start the server

python whatconverts_mcp_server.py --http

4. Cursor MCP config

.cursor/mcp.json:

{
  "mcpServers": {
    "whatconverts": {
      "url": "http://127.0.0.1:8001/mcp"
    }
  }
}

Reload MCP in Cursor settings after starting the server.

MCP tools

Full WhatConverts API coverage (accounts, profiles, leads, recordings, tracking, users, roles).

Example prompts

• How many leads this week?

• Break down leads by source for the last 14 days

• Show phone calls from google / cpc yesterday

• Find leads for email jane@example.com

• What's our sales value this month by campaign?

Cloud Run

.\deploy-cloudrun.ps1 -ProjectId "YOUR_GCP_PROJECT_ID" -Service "whatconverts-mcp"

Claude custom connector URL: https://YOUR-SERVICE.run.app/mcp
Leave OAuth Client ID empty (DCR + CIMD).

Security

• Never commit .env

• Rotate API Token/Secret if exposed

• Claude connector OAuth is separate from WhatConverts API auth