MailValid for Cursor: Verify Emails from Your Editor
Verify addresses and clean lists without leaving your code.
Works in Cursor, VS Code & Windsurf · Same credits as the API · 100 free credits
Set up in three steps
-
1
Create your API key
Sign up free and create a key under API Keys.
API Keys
NameProductionKeymv_live_••••••••••••Create key -
2
Add a global MCP server
Paste the MailValid config in Cursor Settings → MCP.
"mailvalid": { "url": "https://mailvalid.io/mcp", "headers": { "X-API-Key": "mv_live_…" } } -
3
Save, restart, verify
Restart Cursor. The MailValid tools are ready, no OAuth step.
MCP servers
mailvalidenabledTools6 availableAuthAPI keyRestart Cursor
What you get back
Every email comes back with one of five statuses, a score and the reason.
- validKeep. The mailbox exists and accepts mail.
- invalidRemove. It will bounce.
- catch_allSend carefully. The domain accepts every address.
- do_not_mailSkip. Disposable or role-based, like info@.
- unknownFree. The server didn't answer; try later.
Ask from your editor
Every tool uses your API key and bills like the REST API.
- Verify one email 1 credit. Free when the result is unknown.
- Clean a whole list Queues a bulk job and reserves the credits.
- Check a bulk job Free. Progress and results.
- List recent jobs Free.
- Cancel a job Free. Reserved credits are released.
- Check your balance Free. Balance and lifetime usage.
Using VS Code or Windsurf?
VS Code: put this in .vscode/mcp.json and start MailValid from MCP: List Servers. Windsurf: add the same server in its raw config with serverUrl instead of url.
VS Code and Windsurf setup{
"servers": {
"mailvalid": {
"type": "http",
"url": "https://mailvalid.io/mcp",
"headers": { "X-API-Key": "mv_live_your_key_here" }
}
}
}
Three quick tips
Ask for your credit balance first. It's free and tests the key.
Some clients use servers instead of mcpServers. Check their docs.
/mcp/ with a trailing slash also works.
Questions about MailValid for Cursor
Which editors work with MailValid?
Cursor and VS Code connect straight to https://mailvalid.io/mcp over Streamable HTTP. Windsurf is set up in its raw MCP config with serverUrl. Any other MCP client works too.
Does billing work the same as the REST API?
Yes. The MCP tools call the same verification engine and draw from the same credit balance as the REST API and web dashboard. A verify_email call costs exactly what a single verification costs: 1 credit, and unknown results are free. Reads like get_credit_balance are free.
How do I check the connection without spending credits?
Ask for your credit balance. get_credit_balance is free, so it confirms the connection and the key without using a credit.
Is there a discovery endpoint for agents?
Yes: /.well-known/mcp.json and /.well-known/mcp/server-card.json.
Is there a separate sign-in step?
No. Auth uses your API key in the X-API-Key header (or Authorization: Bearer mv_live_...), so there's no separate OAuth step.
Verify your next 100 emails from Cursor free
Create a key, paste one config and your editor can verify emails. No card required.
Get your free API key