leads-mcp

Lead generation MCP server for AI agents. Find emails, verify contacts, enrich profiles, and search prospects using Hunter.io, Apollo.io, and Abstract API.

BYOK (Bring Your Own Keys) — you supply your own API keys. No data leaves your machine except direct API calls to the services you configure.

Install

npx -y leads-mcp

Claude Code

claude mcp add leads-mcp -- npx -y leads-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "leads-mcp": {
      "command": "npx",
      "args": ["-y", "leads-mcp"],
      "env": {
        "HUNTER_API_KEY": "your-hunter-key",
        "APOLLO_API_KEY": "your-apollo-key",
        "ABSTRACT_API_KEY": "your-abstract-key"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json with the same config format as above.

API Keys

All keys are optional — tools gracefully tell you which key is needed when you try to use them.

Key	Service	Get it at
HUNTER_API_KEY	Hunter.io — email finding & verification	https://hunter.io/api-keys
APOLLO_API_KEY	Apollo.io — person/company enrichment & search	https://app.apollo.io/#/settings/integrations/api
ABSTRACT_API_KEY	Abstract API — company enrichment	https://app.abstractapi.com/api/company-enrichment

Tools

find-email

Find someone's email address given their name and company domain.

Params: firstName, lastName, domain API: Hunter.io | Key: HUNTER_API_KEY

verify-email

Verify an email address for deliverability — MX records, SMTP, disposable, catch-all.

Params: email API: Hunter.io | Key: HUNTER_API_KEY

domain-search

Find all email addresses associated with a company domain.

Params: domain, type?, department?, seniority?, limit? API: Hunter.io | Key: HUNTER_API_KEY

enrich-person

Get a full professional profile — title, company, social links, phone.

Params: firstName?, lastName?, email?, domain?, linkedinUrl? API: Apollo.io | Key: APOLLO_API_KEY

enrich-company

Get comprehensive company intelligence — industry, size, funding, tech stack.

Params: domain API: Apollo.io + Abstract API | Key: APOLLO_API_KEY or ABSTRACT_API_KEY

search-people

Search for people by job title, company, location, and seniority.

Params: personTitles?, organizationName?, locations?, seniorities?, limit? API: Apollo.io | Key: APOLLO_API_KEY

search-companies

Search for companies by name, industry, location, and employee count.

Params: query?, industries?, locations?, employeeRanges?, limit? API: Apollo.io | Key: APOLLO_API_KEY

lead-report

Generate a comprehensive lead report combining all available APIs. Uses Promise.allSettled for partial results.

Params: firstName, lastName, domain API: All available | Key: Any configured key

Example Prompts

• "Find the email for John Smith at stripe.com"
• "Verify if hello@example.com is deliverable"
• "Find all engineering contacts at openai.com"
• "Get the full profile for the CEO of anthropic.com"
• "Tell me everything about acme.com"
• "Search for CTOs at startups in San Francisco"
• "Find B2B SaaS companies with 50-200 employees"
• "Generate a full lead report for Jane Doe at tesla.com"

Development

git clone <repo-url>
cd leads-mcp
pnpm install
pnpm dev        # Run with tsx (hot reload)
pnpm build      # Compile TypeScript
pnpm start      # Run compiled JS

License

MIT