Black Friday Sale

Use code: BLACKFRIDAY50

50% OFF on all prices
Ends in: 00d: 00h: 00m: 00s

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

How it works

Set up in three steps

  1. 1

    Create your API key

    Sign up free and create a key under API Keys.

    API Keys

    NameProduction
    Keymv_live_••••••••••••
    Create key
  2. 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. 3

    Confirm, then ask

    Run /mcp, then ask for your credit balance. It's free.

    /mcp

    Servermailvalid
    Statusconnected
    Tools6
    Ask Claude
Results

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.
What you can ask

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" }
    }
  }
}
Good to know

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.

FAQ

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