English Français العربية

BillionVerify

Official registry Productivity

Email verification for AI agents: verify single or bulk emails, check credits and history.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http billionverify 'https://mcp.billionverify.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "billionverify": {
            "type": "http",
            "url": "https://mcp.billionverify.com/mcp"
        }
    }
}
NPM package billionverify-mcp
Claude Code 
claude mcp add billionverify -e 'BILLIONVERIFY_API_KEY=<your billionverify_api_key>' -e 'BILLIONVERIFY_API_URL=https://api.billionverify.com' -- npx -y billionverify-mcp@1.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "billionverify": {
            "command": "npx",
            "args": [
                "-y",
                "billionverify-mcp@1.1.1"
            ],
            "env": {
                "BILLIONVERIFY_API_KEY": "<your billionverify_api_key>",
                "BILLIONVERIFY_API_URL": "https://api.billionverify.com"
            }
        }
    }
}

Environment variables

  • BILLIONVERIFY_API_KEY required secret Your BillionVerify API key
  • BILLIONVERIFY_API_URL API base URL override

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BillionVerify MCP Server — TypeScript
  2. Option 1 — Hosted Server (No Installation)
  3. Option 2 — Self-Hosted (TypeScript / Node.js)
  4. Available Tools
  5. License

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 — Hosted Server (No Installation)

Use BillionVerify's hosted MCP server. There is nothing to install and no API key to paste: you sign in with your BillionVerify account over OAuth, and the connection is tied to that account.
Server URLhttps://mcp.billionverify.com/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 (sign in with your BillionVerify account)

The hosted server does not accept API keys (?api_key=, BV-API-KEY or Authorization: Bearer <api key> are all rejected). If you want to use an API key, use Option 2.

Detailed step-by-step guide: docs/connect-chatgpt-claude.md.

ChatGPT (web)
  1. Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
  2. Settings → Apps & Connectors → Create.
  3. Name BillionVerify, MCP server URL https://mcp.billionverify.com/mcp, authentication OAuth → create.
  4. Sign in to BillionVerify in the window that opens and approve access.
  5. In a new chat, click + → Developer mode → enable BillionVerify.
Claude (claude.ai / Claude Desktop)
  1. Customize → Connectors → + → Add custom connector.
  2. Name BillionVerify, URL https://mcp.billionverify.com/mcp → Add (leave Advanced settings empty).
  3. Click Connect, sign in to BillionVerify and approve access.
  4. In a chat, click + → Connectors and make sure BillionVerify is on.

Team / Enterprise: an Owner adds the connector under Organization settings → Connectors, then each member clicks Connect.

Claude Code
claude mcp add --transport http billionverify https://mcp.billionverify.com/mcp

Then run /mcp inside Claude Code, select billionverify and finish the sign-in in your browser.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), then click Connect next to the server in Settings → MCP:

{
  "mcpServers": {
    "billionverify": {
      "url": "https://mcp.billionverify.com/mcp"
    }
  }
}

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
VariableDescriptionDefault
BILLIONVERIFY_API_KEYYour BillionVerify API key—
BILLIONVERIFY_API_URLAPI base URL overridehttps://api.billionverify.com

Available Tools

ToolDescription
verify_single_emailVerify a single email address in real-time
verify_batch_emailsVerify up to 50 emails in one request
get_account_balanceCheck your credit balance
get_verification_historyList verification history (paginated)
get_verification_statsAggregated statistics for 7d / 30d / 90d / 1y
get_task_statusPoll the status of an async file verification job
get_download_urlGet download URL for results with status filters
create_webhookSubscribe to file completion events
list_webhooksList all configured webhooks
delete_webhookRemove a webhook
health_checkCheck server health

License

MIT

Frequently asked questions

What is BillionVerify?

Email verification for AI agents: verify single or bulk emails, check credits and history.

How do I install BillionVerify?

It runs as a remote server. In Claude Code: claude mcp add --transport http billionverify 'https://mcp.billionverify.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does BillionVerify need an API key?

Yes. It expects BILLIONVERIFY_API_KEY, which you set in its configuration.

Is BillionVerify open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains BillionVerify?

It is published by BillionVerify. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.