Integrations
Claude integration
Add our MCP server to Claude as a custom connector, then ask it to validate addresses or run a list from the chat. A connector added on claude.ai also works in Claude Desktop, and Claude Code connects with one command.
- Status: Setup guide
- claude.ai, Claude Desktop and Claude Code
claude mcp add --transport http email-validation https://api.email-validation.org/mcp \
--header "Authorization: Bearer $EV_API_KEY"At a glance.
- Status
- Setup guide. Not listed on a marketplace yet: you set it up yourself in a few steps, below and in the full guide.
- For
- Claude users who check addresses while they write, research or code, and developers who want Claude Code to validate the addresses in a project’s files.
- You need
- A Claude account (the Free plan allows one custom connector) and either a sign-in on our site or an API key made for it, with a daily credit cap. Bulk jobs need the Bulk permission.
- Costs
- 1 credit = 1 validated address, as with any API request. Free: unknown results, API errors, malformed addresses and test addresses on sandbox.email-validation.org.
- Full guide
- Read the full setup guide
Typical uses.
Check an address in a chat
Ask whether an address is a real mailbox before you add it to the CRM; Claude reads the status, reason and recommended action back to you.
Validate a list
Paste a few addresses and Claude checks each one. For a longer list it can start a bulk job and report the counts by status, with a key or sign-in that allows Bulk; the results file is in your dashboard.
From Claude Code
Let Claude Code check the addresses in a file of your project. A project .mcp.json reads the key from each person’s environment, so the file can be shared.
Set it up. 4 steps.
The short version of the full setup guide, which stays the reference when a step does not match what you see.
Add a custom connector
On claude.ai, go to Customize, Connectors and click Add custom connector. On Team and Enterprise plans an Owner adds it under Organization settings.
Enter the server URL
Name it, for example email-validation.org, and enter
https://api.email-validation.org/mcpas the MCP server URL.Sign in, or use a key
Choose a sign-in with the OAuth client set to Register automatically, or No sign-in with the request header
authorizationset toBearerand your key (request headers are a beta not every organization has yet).Turn it on in a chat
Click +, Connectors and turn it on for the conversation, then ask Claude to validate
accepted@sandbox.email-validation.org.
Good to know.
- Do not choose Use Claude’s published identity: our server does not support that method, and the sign-in fails.
- A connector’s authentication cannot be changed later: remove it and add it again.
- A signed-in app has no daily credit cap; connect with an API key that has one if you want a limit.
- In Claude Code, run
/mcpto check the server is connected. To sign in instead of using a key, leave out the--headerline. - Try it first with
accepted@sandbox.email-validation.organd the other test addresses: each returns the result its name says and costs nothing.
Updated · Maintained by the email-validation.org team