Back to Browse

Billionverify MCP Server

Developer ToolsModerate7.1MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp.billionverify.com/mcp

Security Report

7.1
Moderate7.1Low Risk

This is a straightforward email verification MCP server that calls the BillionVerify API with an API key and needs only network and environment-variable access, which matches its purpose. The main concerns are that the API key can be supplied as a tool argument (so it passes through the AI conversation), and that job, task, and webhook IDs are interpolated into URL paths without encoding. None of these are severe, and the score reflects only minor issues. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

3 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your BillionVerify API keyRequired

Environment variable: BILLIONVERIFY_API_KEY

API base URL overrideOptional

Environment variable: BILLIONVERIFY_API_URL

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!