Black Friday Sale

Use code: BLACKFRIDAY50

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

Let your AI agent verify emails

Works in . Connect once, then just ask.

100 free credits · No credit card required

How it works

Three steps, about a minute

  1. 1

    Get a free API key

  2. mcp.json · Cursor
    {
      "mcpServers": {
        "mailvalid": {
          "url": "https://mailvalid.io/mcp",
          "headers": { "X-API-Key": "mv_live_your_key_here" }
        }
      }
    }
    2

    Paste one config into your AI app

  3. 3

    Ask in plain English

Using Claude Code, Claude Desktop, VS Code or Windsurf? Pick your app below

What you can ask

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.

Setup

Pick your AI app

Same endpoint everywhere: https://mailvalid.io/mcp

  1. 1Copy your API key
  2. 2Run this command in your terminal
  3. 3Type /mcp in Claude Code to confirm
  4. Full Claude Code guide
Terminal
claude mcp add --transport http mailvalid https://mailvalid.io/mcp \
  --header "X-API-Key: mv_live_your_key_here"
FAQ

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