@anymailfinder/mcp-server

MCP server for the Anymail Finder API. Lets AI assistants (Claude, Cursor, ChatGPT, etc.) find and verify email addresses natively via the Model Context Protocol.

Prerequisites

• Node.js 20 or later -- check with node --version (download)
• Anymail Finder API key -- get one at anymailfinder.com

Available Tools

| Tool | Description | Credits | |---|---|---| | find_person_email | Find a person's email by name + company domain | Yes | | find_company_emails | Find up to 20 emails for a company domain | Yes | | find_email_by_linkedin | Find email from a LinkedIn profile URL | Yes | | find_decision_maker | Find a decision maker's email by role category | Yes | | verify_email | Check if an email is valid, risky, or invalid | Yes | | get_account_info | Check remaining API credits | No | | report_bad_email | Report an incorrect email | No |

Setup

Claude Desktop

Add to your config file:

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

Open it from a terminal:

# macOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "anymailfinder": {
      "command": "npx",
      "args": ["-y", "@anymailfinder/mcp-server"],
      "env": {
        "ANYMAIL_FINDER_API_KEY": "your-api-key"
      }
    }
  }
}

Fully quit and reopen Claude Desktop after saving (Cmd+Q on macOS).

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "anymailfinder": {
      "command": "npx",
      "args": ["-y", "@anymailfinder/mcp-server"],
      "env": {
        "ANYMAIL_FINDER_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Cursor after saving.

Development

cd mcp
yarn install
yarn build

# Test interactively with MCP Inspector
ANYMAIL_FINDER_API_KEY=your-key npx @modelcontextprotocol/inspector node build/index.js

# Run directly (stdio mode)
ANYMAIL_FINDER_API_KEY=your-key node build/index.js

License

MIT