1. Open Cursor Settings → MCP → Add new global MCP server
2. Paste the configuration below, then save and restart Cursor

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

The verify_email tool and the rest are available immediately — no separate OAuth step, since auth is your API key.

1. Create a .vscode/mcp.json file in your workspace with the config below
2. Open the Command Palette (Ctrl/Cmd+Shift+P) and run MCP: List Servers
3. Start the MailValid server — tools are available immediately

{
  "servers": {
    "mailvalid": {
      "type": "http",
      "url": "https://mailvalid.io/mcp/",
      "headers": { "X-API-Key": "mv_live_your_key_here" }
    }
  }
}

Claude Desktop only supports local (stdio) MCP servers, so use the @mailvalid/mcp launcher — it reads your key from the env var and bridges to the hosted server, so there’s no URL or header to manage.

1. Open Settings → Developer → Edit Config
2. Add the server below, then restart Claude Desktop

{
  "mcpServers": {
    "mailvalid": {
      "command": "npx",
      "args": ["-y", "@mailvalid/mcp"],
      "env": { "MAILVALID_API_KEY": "mv_live_your_key_here" }
    }
  }
}

1. Open Windsurf Settings and search for MCP
2. Select View raw config to open mcp_config.json
3. Add the server below, then save and restart Windsurf

{
  "mcpServers": {
    "mailvalid": {
      "serverUrl": "https://mailvalid.io/mcp/",
      "headers": { "X-API-Key": "mv_live_your_key_here" }
    }
  }
}

If your client supports remote MCP servers, connect over Streamable HTTP (include the trailing slash to avoid a redirect). For stdio-only clients, use the @mailvalid/mcp launcher instead.

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

{
  "mcpServers": {
    "mailvalid": {
      "command": "npx",
      "args": ["-y", "@mailvalid/mcp"],
      "env": { "MAILVALID_API_KEY": "mv_live_your_key_here" }
    }
  }
}

Field names vary slightly between clients (some use servers instead of mcpServers) — check your client’s MCP docs.