# BillionVerify

> BillionVerify is a freemium MCP server for sales and crm. Email verification for AI agents: single and bulk checks, credit balance and job history. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://billionverify.com
- **Repository:** https://github.com/billionverify/billionverify-mcp
- **MCP Registry name:** io.github.BillionVerify/billionverify-mcp
- **Categories:** sales and CRM, marketing and SEO
- **Listing updated:** 2026-11-15

## About

The hosted server at mcp.billionverify.com signs you in with your BillionVerify account over OAuth 2.1 and rejects API keys; the npm package billionverify-mcp is the self-hosted route and takes a BILLIONVERIFY_API_KEY instead. Setup steps are given for ChatGPT developer mode, Claude custom connectors, Claude Code and Cursor.

Behind it is BillionVerify's checker, which runs syntax, domain, MX, SMTP and risk checks and returns valid, invalid, catch-all, disposable, role or unknown, with a reason. The tools cover real-time checks, batches of up to 50 addresses, account balance, paginated history, usage statistics over 7 days to a year, and polling and downloading results of asynchronous file jobs, plus webhook subscriptions for job completion.

On the website, valid, invalid, catch-all, disposable and role results cost one credit each and unknown results are free. It advertises 20 free credits a day, up to 600 a month, and one-time credit packs at about $0.001 per email, with credits that never expire.

## Features

- **Real-time single checks:** Verifies one address and returns a status with the reason.
- **Batches of 50:** Checks up to 50 addresses in one request.
- **Async file jobs:** Polls task status and fetches result download links with status filters.
- **History and stats:** Lists past verifications and aggregates 7-day to 1-year statistics.
- **Webhooks:** Subscribes to file completion events.
- **OAuth hosted option:** The hosted server uses account sign-in; self-hosting uses an API key.

## Good for

- Check a lead's email before an outbound sequence
- Clean a pasted list of addresses from a chat
- Check remaining credits before a big job
- Review recent verification history
- Get a notification when a file job finishes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http billionverify-mcp https://mcp.billionverify.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.billionverify.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "billionverify-mcp": {
      "type": "http",
      "url": "https://mcp.billionverify.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "billionverify-mcp": {
      "serverUrl": "https://mcp.billionverify.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "billionverify-mcp": {
      "type": "http",
      "url": "https://mcp.billionverify.com/mcp"
    }
  }
}
```

## Tools

- `verify_single_email`: Verifies a single email address in real time.
- `verify_batch_emails`: Verifies up to 50 emails in one request.
- `get_account_balance`: Checks the credit balance.
- `get_verification_history`: Lists verification history, paginated.
- `get_verification_stats`: Returns aggregated statistics for 7 days, 30 days, 90 days or a year.
- `get_task_status`: Polls the status of an async file verification job.
- `get_download_url`: Gets a download URL for results with status filters.
- `create_webhook`: Subscribes to file completion events.
- `list_webhooks`: Lists configured webhooks.

## FAQ

### Does the hosted server accept API keys?

No. It uses OAuth sign-in; use the self-hosted npm package with BILLIONVERIFY_API_KEY for key-based access.

### Which statuses can come back?

Valid, invalid, catch-all, disposable, role or unknown.

### Are unknown results charged?

No, the website says unknown results are free.

### How many addresses per batch?

Up to 50 per request.

### Is BillionVerify free?

BillionVerify has a free plan, with paid plans for more usage or features.

### How do I add BillionVerify to Claude Code?

Run this command in your terminal: claude mcp add --transport http billionverify-mcp https://mcp.billionverify.com/mcp

### What are the best alternatives to BillionVerify?

The closest alternatives to BillionVerify are Google Ads + Meta Ads + SEO/GEO MCP, Calven, CompanyData, MisarReach MCP Server and NeuralVerge.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/billionverify
