English Français العربية

BillionVerify

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http billionverify 'https://mcp.billionverify.com/mcp'
إعداد JSON (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 (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"
            }
        }
    }
}

متغيرات البيئة

  • BILLIONVERIFY_API_KEY إلزامي سري Your BillionVerify API key
  • BILLIONVERIFY_API_URL API base URL override

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو BillionVerify؟

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

كيف أثبّت BillionVerify؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http billionverify 'https://mcp.billionverify.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج BillionVerify إلى مفتاح API؟

نعم. يتطلب BILLIONVERIFY_API_KEY، وتضبطها في إعداداته.

هل BillionVerify مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون BillionVerify؟

ينشره BillionVerify. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.