BillionVerify MCP Server — TypeScript

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

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

Claude Desktop config (self-hosted)

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

Install globally

npm install -g billionverify-mcp
billionverify-mcp

Install from source

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

Environment Variables

Available Tools

License

MIT