Let your AI agent verify emails
Works in
Claude
Cursor
any MCP app.
Connect once, then just ask.
100 free credits · No credit card required
Three steps, about a minute
-
1
Get a free API key
-
2mcp.json · Cursor
{ "mcpServers": { "mailvalid": { "url": "https://mailvalid.io/mcp", "headers": { "X-API-Key": "mv_live_your_key_here" } } } }Paste one config into your AI app
-
3
Ask in plain English
Using Claude Code, Claude Desktop, VS Code or Windsurf? Pick your app below
Your agent gets six new skills
-
Check one email
“Is anna@northwind.io a real inbox?”
1 creditverify_email -
Check a whole list
“Verify these 2,400 signups for me.”
1 credit eachsubmit_bulk_verification -
Track a list's progress
“How far along is my signup list?”
Freeget_bulk_job -
See past lists
“Which of my lists finished this week?”
Freelist_bulk_jobs -
Cancel a list
“Stop that job, it was the wrong file.”
Freecancel_bulk_job -
Check your credits
“How many credits do I have left?”
Freeget_credit_balance
Same credits as the API. Unknown results are free, and so are job and balance checks.
Pick your AI app
Same endpoint everywhere: https://mailvalid.io/mcp
- 1Copy your API key
- 2Run this command in your terminal
- 3Type
/mcpin Claude Code to confirm - Full Claude Code guide
claude mcp add --transport http mailvalid https://mailvalid.io/mcp \ --header "X-API-Key: mv_live_your_key_here"
- 1Settings → Developer → Edit Config
- 2Paste this, with your API key
- 3Fully quit and reopen Claude (needs Node.js 18+)
- Full Claude Desktop guide
{
"mcpServers": {
"mailvalid": {
"command": "npx",
"args": ["-y", "@mailvalid/mcp"],
"env": { "MAILVALID_API_KEY": "mv_live_your_key_here" }
}
}
}
- 1Settings → MCP → Add new global MCP server
- 2Paste this, with your API key
- 3Save and restart Cursor
- Full Cursor guide
{
"mcpServers": {
"mailvalid": {
"url": "https://mailvalid.io/mcp",
"headers": { "X-API-Key": "mv_live_your_key_here" }
}
}
}
- 1Create
.vscode/mcp.jsonwith this - 2Run
MCP: List Serversfrom the Command Palette - 3Start MailValid
- Full VS Code guide
{
"servers": {
"mailvalid": {
"type": "http",
"url": "https://mailvalid.io/mcp",
"headers": { "X-API-Key": "mv_live_your_key_here" }
}
}
}
- 1Settings → search MCP → View raw config
- 2Add this, with your API key
- 3Save and restart Windsurf
- Full Windsurf guide
{
"mcpServers": {
"mailvalid": {
"serverUrl": "https://mailvalid.io/mcp",
"headers": { "X-API-Key": "mv_live_your_key_here" }
}
}
}
- 1Server URL:
https://mailvalid.io/mcp - 2Send your key in the
X-API-Keyheader - 3stdio only? Use
npx -y @mailvalid/mcp - Full Other MCP apps guide
{
"mcpServers": {
"mailvalid": {
"url": "https://mailvalid.io/mcp",
"headers": { "X-API-Key": "mv_live_your_key_here" }
}
}
}
Questions about the MCP server
Which AI clients can use the MailValid MCP server?
Any client that connects to remote MCP servers over Streamable HTTP and lets you set a request header, including Claude Code, Cursor, VS Code (GitHub Copilot) and Windsurf. Claude Desktop connects through the @mailvalid/mcp launcher, which needs Node.js 18 or newer.
How does the agent authenticate?
With your MailValid API key, sent in the X-API-Key header (Authorization: Bearer mv_live_... also works). Create a key in the dashboard. There is no separate OAuth step.
What does a tool call cost?
The same as the REST API. verify_email costs 1 credit for a definitive result (valid, invalid, catch-all or do-not-mail) and unknown results are free. A bulk job reserves credits up front and settles on completion, with unknowns and duplicates free. Reading jobs, cancelling and checking your balance cost nothing.
How many emails can my agent verify in one bulk job?
Up to 10,000 addresses per job on any paid plan (MailValid Plus or pay-as-you-go). The free plan allows 100 per job.
How does my agent know when a bulk job is done?
It can poll get_bulk_job for status, progress and results, or pass a webhook_url to submit_bulk_verification and MailValid posts to it when the job completes.
Let your agent check its first email today
Paste one config, then ask in plain English. 100 free credits, no card needed.
Get your free API key