Model Context Protocol

MCP Server

emailvalidation.io runs a hosted Model Context Protocol (MCP) server. AI agents and assistants (Claude, Cursor, VS Code and any other MCP-capable client) can call the API as native tools, no SDK or glue code required.

https://api.emailvalidation.io/mcp
Get a free API key MCP documentation
  • Hosted, nothing to install
  • Streamable HTTP
  • Same quota as the API

Setup

Connect your MCP client

With this setup, all requests, including listing the available tools, need your API key. Send it as the apikey header. Clients that support MCP sign-in can sign in instead of sending a key (see Details).

Get a free API key
claude mcp add --transport http emailvalidation \
  https://api.emailvalidation.io/mcp \
  --header "apikey: YOUR-API-KEY"

Available tools

Each tool maps to one REST endpoint and returns the same JSON and the same machine-readable errors.

getInfo

Validate an email address

GET /v1/info

createBulkJob

Submit a list for bulk verification

POST /v1/bulk

listBulkJobs

List your bulk jobs

GET /v1/bulk

getBulkJob

Get a bulk job’s status

GET /v1/bulk/{job_id}

deleteBulkJob

Delete a bulk job

DELETE /v1/bulk/{job_id}

getStatus

Account quota status

GET /v1/status

Details

Sign in instead of an API key

MCP clients that support sign-in (OAuth), such as Claude’s custom connectors, can sign in instead of sending a key. In Claude, open Settings → Connectors → Add custom connector and enter https://api.emailvalidation.io/mcp. The client opens a sign-in page on app.emailvalidation.io: sign in or sign up, and approve the connection (as the team’s owner or an admin). The client then holds a key of your team that lasts an hour and renews itself; its tool calls count against your plan like any other request. You can disconnect it at any time under API keys → Connected apps in the dashboard. For your own code, use an API key.

Bulk jobs

Every bulk endpoint is a tool except the results download: a completed job’s results can run to 100,000 rows, too large for a tool result, so download them from the job’s links.results over the REST API. createBulkJob takes the list as the emails array; CSV and TXT file uploads are only available over the REST API.

Tool calls are metered like regular API requests and return the same machine-readable errors, so your agent always knows how to proceed. Full details in the MCP documentation.

Email MCP server FAQ

Which AI clients can use the MCP server?

Any MCP-capable client: Claude, Claude Code, Cursor, VS Code and others. The server is hosted at https://api.emailvalidation.io/mcp, so there is nothing to install.

Can I sign in instead of using an API key?

Yes, with a client that supports MCP sign-in (OAuth), such as Claude’s custom connectors. You sign in on app.emailvalidation.io and approve the connection; the client then holds a key of your team that lasts an hour and renews itself. Disconnect it at any time under API keys → Connected apps.

Do MCP tool calls cost extra?

No. Tool calls are metered like regular API requests, so they use the same quota as the REST API. The free plan includes 100 credits a month (one per validation).

Can an agent validate a whole list?

Yes. createBulkJob takes the list as the emails array, and getBulkJob follows the job. CSV and TXT file uploads are only available over the REST API.

How does the agent get the results of a bulk job?

A completed job’s results can run to 100,000 rows, too large for a tool result, so they are downloaded from the job’s links.results over the REST API.

Start validating emails for free

100 free validations every month. No credit card required. Upgrade when you need more.