@anymailfinder/mcp-server

@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