Black Friday Sale

Use code: BLACKFRIDAY50

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

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

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 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. 3

    Save, restart, verify

    Restart Cursor. The MailValid tools are ready, no OAuth step.

    MCP servers

    mailvalidenabled
    Tools6 available
    AuthAPI key
    Restart Cursor
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

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

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.

FAQ

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