MailVeri MCP v2

Add the server definition to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Add MailVeri MCP to Anthropic's Claude Code CLI via Hosted Streamable HTTP (recommended, zero local install) or local uvx:

• Project-scoped (shared via repo): .mcp.json (at project root)
• User-scoped (global for all projects): ~/.claude.json

claude mcp add --transport http --scope project \
  mailveri https://mcp.mailveri.com/mcp \
  --header "Authorization: Bearer YOUR_MAILVERI_API_KEY"

Or configure Hosted Streamable HTTP directly in .mcp.json / ~/.claude.json (include "type": "http"):

{
  "mcpServers": {
    "mailveri": {
      "type": "http",
      "url": "https://mcp.mailveri.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Alternatively, run locally via uvx (stdio):

claude mcp add \
  --scope project \
  --env MAILVERI_API_KEY=YOUR_MAILVERI_API_KEY \
  mailveri -- \
  uvx mailveri-mcp

Configure MailVeri MCP in your Codex assistant or agent configuration file. The official Codex CLI uses TOML format:

• Global CLI config: ~/.codex/config.toml
• Project CLI config: .codex/config.toml
• Alternative / GUI integrations: ~/.codex/config.json

[mcp_servers.mailveri]
command = "uvx"
args = ["mailveri-mcp"]

[mcp_servers.mailveri.env]
MAILVERI_API_KEY = "YOUR_MAILVERI_API_KEY"

If using JSON configuration:

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Add MailVeri MCP via GUI under Cursor Settings > Features > MCP, or add directly to your configuration files:

• Project-level: .cursor/mcp.json
• Global user-level: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Configure via GUI in Windsurf Settings > Cascade > MCP Servers, or directly edit the configuration file:

• Configuration path: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Configure under global user settings or per-workspace settings:

• Global config: ~/.gemini/antigravity/mcp_config.json
• Workspace config: .gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

OpenCode discovers configuration files in the following precedence order:

• Global (Home): ~/.opencode.json
• Global (XDG): ~/.config/opencode/.opencode.json
• Project directory: ./.opencode.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Configure MailVeri MCP in your Pi AI assistant settings:

• Global Agent config: ~/.pi/agent/mcp.json or ~/.pi/config.json
• Project config: .pi/mcp.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Configure in Oh My Pi MCP registry:

• Global config: ~/.omp/mcp.json
• Project config: ./.omp/mcp.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Configure via the Cline extension MCP settings tab, or edit cline_mcp_settings.json directly:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      },
      "disabled": false,
      "autoApprove": [
        "mailveri_verify_email",
        "mailveri_get_balance"
      ]
    }
  }
}

Verifies the existence and deliverability of a single target email address. Checks MX existence, connects to the destination mail exchanger via SMTP handshake, evaluates catch-all configurations, disposable email providers, and role accounts.

Input Arguments

Output JSON Schema

{
  "mail": "[email protected]",
  "email": "[email protected]",
  "status": "VALID",
  "is_deliverable": true,
  "balance": 999,
  "credits_used": 1,
  "quality_score": 98,
  "is_forwarding": false,
  "message": "Verified [email protected] successfully"
}

Deliverability Status Enum

Checks the current verification credits remaining in your MailVeri account. Takes no arguments.

Output JSON Schema

{
  "balance": 4820,
  "message": "You have 4820 credits"
}

Queues a list of emails (minimum 2 unique email addresses) for asynchronous, distributed bulk verification. Returns an identifier id to monitor job progress.

Input Arguments

Output JSON Schema

{
  "id": "sample_batch_id_9x8y7z",
  "job_id": "sample_batch_id_9x8y7z",
  "count": 250,
  "status": "QUEUED",
  "message": "Batch submitted successfully"
}

Polls progress percentage, status state, and download links for an active or completed bulk verification job.

Input Arguments

Output JSON Schema

{
  "id": "sample_batch_id_9x8y7z",
  "job_id": "sample_batch_id_9x8y7z",
  "status": "DONE",
  "percent": 100,
  "download_link": "https://api.mailveri.com/v1/download-zip/?id=sample_batch_id_9x8y7z",
  "is_finished": true
}

Returns the direct authenticated download URL for batch verification results. Supports downloading the full ZIP archive (via /v1/download-zip/) or a custom filtered CSV file (via /v1/download-result/?format=csv).

Input Arguments

Output JSON Schema (ZIP Archive - Default)

{
  "id": "bX9K3LwZqP2YtR8vN4mQ",
  "job_id": "bX9K3LwZqP2YtR8vN4mQ",
  "format": "zip",
  "download_url": "https://api.mailveri.com/v1/download-zip/?id=bX9K3LwZqP2YtR8vN4mQ",
  "message": "Download result ZIP archive at: https://api.mailveri.com/v1/download-zip/?id=bX9K3LwZqP2YtR8vN4mQ (requires API key header)"
}

Output JSON Schema (Filtered CSV Export)

{
  "id": "bX9K3LwZqP2YtR8vN4mQ",
  "job_id": "bX9K3LwZqP2YtR8vN4mQ",
  "format": "csv",
  "download_url": "https://api.mailveri.com/v1/download-result/?id=bX9K3LwZqP2YtR8vN4mQ&format=csv&status=VALID%2CROLE_ACCOUNT&columns=original",
  "message": "Download result CSV (VALID,ROLE_ACCOUNT) at: https://api.mailveri.com/v1/download-result/?id=bX9K3LwZqP2YtR8vN4mQ&format=csv&status=VALID%2CROLE_ACCOUNT&columns=original (requires API key header)"
}

Deletes a finished or canceled verification batch and its associated result files (destructiveHint: true). Batches that are still queued or processing cannot be deleted; wait for completion or cancel them from the MailVeri Dashboard first.

Input Arguments

Output JSON Schema

{
  "id": "bX9K3LwZqP2YtR8vN4mQ",
  "job_id": "bX9K3LwZqP2YtR8vN4mQ",
  "message": "List leads.csv was deleted successfully"
}

Q: uvx: command not found error

Make sure uv is installed and available in your shell's PATH, or switch to the zero-install hosted Streamable HTTP endpoint (https://mcp.mailveri.com/mcp). If Claude Desktop doesn't find uvx, provide the full absolute path in your config (e.g. /usr/local/bin/uvx or /Users/<user>/.local/bin/uvx).

Q: Rate limit warnings on single verification

Single email verification (mailveri_verify_email) allows up to 10 requests per second (up to 5 concurrent checks) per account. For lists containing 50 or more emails, instruct your AI agent to use mailveri_verify_batch for asynchronous bulk processing.

Q: Tool call returns {"error": 1, "message": "Invalid API key"}

Verify that your MAILVERI_API_KEY environment variable is correctly set in your client's config file and that your key is active in your MailVeri Dashboard.