{
  "markdown": "# Verifox MCP Server\n\n[![smithery badge](https://smithery.ai/badge/verifox-ai/email-verifier)](https://smithery.ai/servers/verifox-ai/email-verifier)\n\nMCP (Model Context Protocol) server that gives Claude and other AI assistants the **Verifox** API — **verify email deliverability** and **find business emails**, both single and in bulk.\n\n## Quick start (published package)\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`) or Claude Code MCP config — no install needed, `npx` fetches it:\n\n```json\n{\n  \"mcpServers\": {\n    \"verifox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"verifox-mcp\"],\n      \"env\": {\n        \"VERIFOX_API_KEY\": \"foxkey_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nGet a free API key (1,000 credits) at **https://verifox.ai/dashboard/api**. Restart Claude Desktop and ask it to \"verify these emails\".\n\n## Tools\n\n| Tool            | Does                                                                                    | Credits      |\n| --------------- | --------------------------------------------------------------------------------------- | ------------ |\n| `verify_email`  | Verify ONE email — SMTP deliverability, catch-all, disposable, role, free + 0-100 score | 1 / email    |\n| `verify_emails` | Bulk-verify a LIST — submits, waits, returns one result per email                       | 1 / email    |\n| `find_email`    | Find ONE business email from name + company domain (best match or not_found)            | 10 / find    |\n| `find_emails`   | Bulk-find emails for a LIST of contacts (name + domain each)                            | 10 / contact |\n| `get_credits`   | Check the account's remaining Fox Credit balance                                        | free         |\n| `get_job`       | Poll a long-running `verify_emails` / `find_email` / `find_emails` job for results      | —            |\n\nVerify and find are async for large lists: the bulk tools wait ~55s inline, and hand back a `jobId` to finish via `get_job` if a job runs longer. Cached verifications cost 0 credits.\n\n## Local development\n\nRun straight from source with Bun (no build):\n\n```bash\ncd mcp\nbun install\n```\n\n````json\n{\n  \"mcpServers\": {\n    \"verifox\": {\n      \"command\": \"bun\",\n      \"args\": [\"run\", \"/FULL/PATH/TO/Verifox-api/mcp/src/index.ts\"],\n      \"env\": {\n        \"VERIFOX_API_URL\": \"https://api.verifox.ai\",\n        \"VERIFOX_API_KEY\": \"foxkey_your_key_here\"\n\n```json\n{\n  \"mcpServers\": {\n    \"verifox\": {\n      \"command\": \"bun\",\n      \"args\": [\"run\", \"/FULL/PATH/TO/Verifox-api/mcp/src/index.ts\"],\n      \"env\": {\n        \"VERIFOX_API_URL\": \"https://api.verifox.ai\",\n        \"VERIFOX_API_KEY\": \"foxkey_your_key_here\"\n      }\n    }\n  }\n}\n````\n\n`VERIFOX_API_URL` defaults to `https://api.verifox.ai` when unset. For local\ndevelopment against the API on port 8001, set it to `http://localhost:8001`.\n\n### 3. Restart Claude Desktop\n\nThe tools will appear in Claude's tool list.\n\n## Remote (HTTP) mode\n\nThe same server also runs as a **streamable-HTTP** MCP endpoint (for Smithery,\nclaude.ai connectors, and other remote MCP clients). Set `MCP_TRANSPORT=http`\n(or a `PORT`) and it listens on `POST /mcp` with a `GET /health` check:\n\n```bash\nMCP_TRANSPORT=http PORT=8080 node dist/index.js\n# or: docker build -t verifox-mcp . && docker run -p 8080:8080 verifox-mcp\n```\n\nIn HTTP mode the Verifox API key is read **per request** from the\n`Authorization: Bearer <foxkey>` header (also accepts `x-api-key` or `?api_key=`)\n— so one hosted endpoint serves many users, each on their own credits.\n\n## Usage Examples\n\nIn Claude Desktop, just ask:\n\n- \"Scan stripe.com for security issues\"\n- \"Check if john@google.com is a valid email\"\n- \"Score these emails: admin@stripe.com, test@mailinator.com, john.doe@microsoft.com\"\n- \"Find the email for Patrick Collison at stripe.com\"\n- \"Run OSINT on tesla.com — find subdomains and emails\"\n- \"Test the email server for turnix.co\"\n- \"Check DMARC policy for google.com\"\n\n## Environment Variables\n\n| Variable          | Default                  | Description                                        |\n| ----------------- | ------------------------ | -------------------------------------------------- |\n| `VERIFOX_API_URL` | `https://api.verifox.ai` | Verifox API base URL                               |\n| `VERIFOX_API_KEY` | (empty)                  | Per-user API key (`foxkey_*`), sent as `x-api-key` |\n\nGenerate a `foxkey_*` key from the Verifox dashboard (API Keys). The key\nauthenticates every tool call and is the account whose Fox Credits are charged\n(verify and find cost 1 credit each; scoring and DNS scans are free).\n",
  "bytes": 4620,
  "sha": "e5520cab947c854bd84198a8a4d098069eb01a0a1743717954ce10052b45610d",
  "repo_slug": "verifoxturnix1/verifox-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_verifox_email_verifier_a06211ea/readme"
}