MailValid for Claude: Verify Emails from Claude
Ask Claude to verify an address, clean a list or check your credits.
Same credits as the API · Reads are free · 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 MailValid to Claude Code
Run one terminal command to connect the hosted server.
claude mcp add --transport http \ mailvalid https://mailvalid.io/mcp \ --header "X-API-Key: mv_live_…"
-
3
Confirm, then ask
Run /mcp, then ask for your credit balance. It's free.
/mcp
ServermailvalidStatusconnectedTools6Ask Claude
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.
Just ask Claude
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 Claude Desktop?
Open Settings → Developer → Edit Config, add the @mailvalid/mcp launcher, then restart Claude Desktop.
Claude Desktop setup{
"mcpServers": {
"mailvalid": {
"command": "npx",
"args": ["-y", "@mailvalid/mcp"],
"env": { "MAILVALID_API_KEY": "mv_live_your_key_here" }
}
}
}
Three quick tips
Ask for your credit balance first. It's free and tests the key.
Run /context in Claude Code to see token usage per server.
Claude Desktop uses the @mailvalid/mcp launcher with your key.
Questions about MailValid for Claude
Which Claude apps work with MailValid?
Claude Code connects straight to https://mailvalid.io/mcp over HTTP. Claude Desktop uses the @mailvalid/mcp launcher, because it only supports local (stdio) servers.
What's the difference between the launcher and connecting directly?
The @mailvalid/mcp launcher runs locally over stdio. It's the only option for clients like Claude Desktop. If your client supports Streamable HTTP (like Claude Code), connect straight to https://mailvalid.io/mcp: it's simpler and skips the extra process.
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.
Let Claude verify your next 100 emails free
Create a key, add MailValid with one command and ask away. No card required.
Get your free API key