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

Related MCP server: GoHighLevel MCP Server

Setup

1. Clone the repo and install dependencies:

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

2. Create your .env file from the example:

cp .env.example .env

3. Edit .env with your WhatConverts API credentials:

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

4. Build:

npm run build

Docker Setup

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

1. Build the image:

docker build -t whatconverts-mcp-server .

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

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

3. 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

Accounts

Profiles

Users & Roles

Tracking & Recordings

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