WhatConverts MCP Server

An MCP (Model Context Protocol) server that connects Claude to the WhatConverts API, giving Claude access to your leads, accounts, profiles, tracking numbers, and more.

Prerequisites

Node.js 18+
A WhatConverts Master Account API Key (requires Agency plan)
- Generate one from Master Account > Master Integrations in WhatConverts

Setup

Clone the repo and install dependencies:

git clone <repo-url>
cd whatconverts-mcp-server
npm install

Create your .env file from the example:

cp .env.example .env

Edit .env with your WhatConverts API credentials:

API_TOKEN=your-token-here
API_SECRET=your-secret-here

Build:

npm run build

Docker Setup

If you prefer Docker, you can skip the Node.js install entirely.

Build the image:

docker build -t whatconverts-mcp-server .

Create your .env file (if you haven't already):

cp .env.example .env
# Edit .env with your API_TOKEN and API_SECRET

Run it (reads credentials from your .env file):

docker run --rm -i --env-file .env whatconverts-mcp-server

See the Configuration section below for how to wire this into Claude Code or Claude Desktop.

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "whatconverts": {
      "command": "node",
      "args": ["/absolute/path/to/whatconverts-mcp-server/dist/index.js"]
    }
  }
}

Claude Desktop

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

{
  "mcpServers": {
    "whatconverts": {
      "command": "node",
      "args": ["/absolute/path/to/whatconverts-mcp-server/dist/index.js"]
    }
  }
}

Claude Code (Docker)

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "whatconverts": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/absolute/path/to/whatconverts-mcp-server/.env",
        "whatconverts-mcp-server"
      ]
    }
  }
}

Claude Desktop (Docker)

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

{
  "mcpServers": {
    "whatconverts": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/absolute/path/to/whatconverts-mcp-server/.env",
        "whatconverts-mcp-server"
      ]
    }
  }
}

Then restart Claude Code or Claude Desktop.

Available Tools

Leads

Tool	Description
`list_leads`	List leads with filters (type, status, date range, source, etc.)
`get_lead`	Get a single lead by ID
`create_lead`	Create a new lead
`update_lead`	Update an existing lead

Accounts

Tool	Description
`list_accounts`	List all accounts
`get_account`	Get a single account by ID
`create_account`	Create a new account
`update_account`	Update an existing account
`delete_account`	Delete an account

Profiles

Tool	Description
`list_profiles`	List all profiles
`get_profile`	Get a single profile by ID
`create_profile`	Create a new profile
`update_profile`	Update an existing profile
`delete_profile`	Delete a profile

Users & Roles

Tool	Description
`list_users`	List all users (requires Master key)
`list_roles`	List all roles

Tracking & Recordings

Tool	Description
`list_tracking_numbers`	List all tracking phone numbers
`get_recording`	Get a call recording for a lead

API Rate Limits

Master Account API Key: 10,000 requests per day
Concurrency: Up to 20 concurrent requests

Security

Never commit your .env file (it's in .gitignore)
Share credentials via a password manager, not Slack/email
Ideally, each team member should use their own API key