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