BillionVerify MCP Server — TypeScript

Connect any AI assistant to BillionVerify email verification via the Model Context Protocol. Built with the official MCP TypeScript SDK.

Also available in Go and Python.

Option 1 — Online Server (No Installation)

Use BillionVerify's hosted MCP server at https://mcp.billionverify.com/mcp. No setup required — just add your API key.

Get your API key from the BillionVerify Dashboard.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Claude Code

claude mcp add billionverify -- curl --stdio "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"

Cursor

Go to Settings → MCP and add the same JSON configuration as Claude Desktop above.

Option 2 — Self-Hosted (TypeScript / Node.js)

Run your own MCP server using this TypeScript implementation.

Prerequisites

• Node.js 18+

Run via npx (no install)

BILLIONVERIFY_API_KEY=your_api_key npx @billionverify/mcp-server

Claude Desktop config (self-hosted)

{
  "mcpServers": {
    "billionverify": {
      "command": "npx",
      "args": ["-y", "@billionverify/mcp-server"],
      "env": {
        "BILLIONVERIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Install globally

npm install -g @billionverify/mcp-server
billionverify-mcp

Install from source

git clone https://github.com/BillionVerify/typescript-mcp-server.git
cd typescript-mcp-server
npm install
npm run build
npm start

Environment Variables

| Variable | Description | Default | |---|---|---| | BILLIONVERIFY_API_KEY | Your BillionVerify API key | — | | BILLIONVERIFY_API_URL | API base URL override | https://api.billionverify.com |

Available Tools

| Tool | Description | |---|---| | verify_single_email | Verify a single email address in real-time | | verify_batch_emails | Verify up to 50 emails in one request | | get_account_balance | Check your credit balance | | get_task_status | Poll the status of an async file verification job | | get_download_url | Get download URL for results with status filters | | create_webhook | Subscribe to file completion events | | list_webhooks | List all configured webhooks | | delete_webhook | Remove a webhook | | health_check | Check server health |

License

MIT