Deprecated

This package is no longer maintained. Anymail Finder now runs a hosted MCP server, so there is nothing to install and no API key to paste:
https://api.anymailfinder.com/mcp
Add that URL as a custom MCP server in Claude, Cursor, ChatGPT or any other MCP client, and sign in when prompted. Setup instructions for each client are in the help article.

Moving over is not a drop-in swap. The hosted server replaces the stdio transport and ANYMAIL_FINDER_API_KEY environment variable with a URL and a sign-in, and some tools were renamed:

This package Hosted server
find_person_email find_person_email
find_email_by_linkedin find_person_email, using linkedin_url
find_company_emails find_company_emails
find_decision_maker find_decision_maker_email
verify_email verify_email
get_account_info get_account_details
report_bad_email report_bad_email

This package will keep working, but will not receive fixes or new features.

This package	Hosted server
`find_person_email`	`find_person_email`
`find_email_by_linkedin`	`find_person_email`, using `linkedin_url`
`find_company_emails`	`find_company_emails`
`find_decision_maker`	`find_decision_maker_email`
`verify_email`	`verify_email`
`get_account_info`	`get_account_details`
`report_bad_email`	`report_bad_email`

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