Model Context Protocol

The EmailCheckPro MCP server lets an AI assistant run email address checks

Connect an MCP-compatible client and it can run single checks, run multi checks on small lists, list available products, and read your balance. No second account or credential is required. Asynchronous bulk tasks are not exposed over MCP because they start from a file upload; use the dashboard or the REST API for those.

Get your API key View API docs

MCPStreamable HTTP4 tools

What is MCP?

The Model Context Protocol lets AI applications call external tools during a conversation. Ask your assistant to check an email address or review a batch without writing a separate API integration.

MCP is a protocol adapter. It uses the same products, balance, billing, concurrency limits, timeouts, and result semantics as the REST API.

Authentication

Use the exact same API key as the REST API and add it as a Bearer token in your MCP client configuration.

Authorization header

Authorization: Bearer YOUR_API_KEY

Keep your API key privateOnly add the key to your own trusted client configuration. Never expose it in browser code or public prompts.

Server URL

Point your client to the official Streamable HTTP endpoint. No local MCP process is required.

MCP endpointStreamable HTTP

https://emailcheckpro.com/mcp

Requests use JSON-RPC over Streamable HTTP and the same API-key middleware as REST.

Connect your client

Choose the configuration format your client supports. Replace the placeholder with your API key.

Claude Code

Add the remote server from your terminal.

claude mcp add --transport http emailcheckpro https://emailcheckpro.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor / Claude Desktop

Add this server entry to the client's MCP configuration.

{
  "mcpServers": {
    "emailcheckpro": {
      "url": "https://emailcheckpro.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Other MCP clients

Use Streamable HTTP with the endpoint and Bearer header above.

URL: https://emailcheckpro.com/mcp
Authorization: Bearer YOUR_API_KEY

Available tools

The tools are scoped to the app that owns your API key. Call list_products first when you need to discover valid product codes.

list_products

Lists products, prices, billing multipliers, and response fields.

No parameters

check_number

Checks one email address synchronously. registered is the primary result.

service_type · string · required
identifier · string · required

check_numbers

Checks 1–100 email addresses with one service_type and preserves input order.

service_type · string · required
identifiers · string[] · required · max 100

get_balance

Reads the current account balance without charging it.

No parameters

Example prompts

After connecting, ask your assistant in plain language:

“Check whether name@example.com is registered with its mailbox provider.”
“Check these 20 email addresses and summarize the results.”
“How much balance is left before I run this batch?”

Error handling

Tool failures use isError=true and the same code, msg, data contract as the API.

Example tool error

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}

40000

Invalid product or field

Unsupported service_type or conflicting fields.

40002

Invalid email address

The submitted email address is not a valid format.

40100

Missing or invalid API key

Check the Bearer header and confirm the key is active.

40200

Insufficient balance

The request is rejected before processing when the full batch amount cannot be covered.

42200

Undetermined

The email address could not be determined at this time. No result is returned, and this call is not charged.

42901

Concurrency budget full

All five in-flight request slots are busy, or a multi check is already running on this account. Not charged; retry once one finishes.

50303

Service at capacity

Too many checks are in progress platform-wide. Not charged; wait for the Retry-After seconds and resubmit.

50400

Check timed out

Did not finish in time. Not charged; a timed-out multi check fails as a whole and is refunded in full.

50300

Service maintenance

Retry later.

Ready to connect your AI assistant?

Create an account, copy your API key, and start checking from your preferred MCP client.

Create a free account View REST API docs