Hunter MCP

السجل الرسمي البحث والويب

Hunter.io MCP: domain search, email finder and verifier, enrichment, discovery, leads. 11 tools.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @scalably-io/hunter-mcp
Claude Code
claude mcp add hunter-mcp -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'HUNTER_API_BASE=<HUNTER_API_BASE>' -e 'HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS>' -e 'HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS>' -- npx -y @scalably-io/hunter-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "hunter-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@scalably-io/hunter-mcp@1.0.0"
            ],
            "env": {
                "HUNTER_API_KEY": "<your hunter_api_key>",
                "HUNTER_API_BASE": "<HUNTER_API_BASE>",
                "HUNTER_TIMEOUT_MS": "<HUNTER_TIMEOUT_MS>",
                "HUNTER_RETRY_BASE_MS": "<HUNTER_RETRY_BASE_MS>"
            }
        }
    }
}

متغيرات البيئة

  • HUNTER_API_KEY إلزامي سري Hunter.io API key from hunter.io/api-keys
  • HUNTER_API_BASE Hunter API base URL, default https://api.hunter.io/v2
  • HUNTER_TIMEOUT_MS Per-request timeout in milliseconds, default 30000
  • HUNTER_RETRY_BASE_MS Base delay in milliseconds for the GET retry backoff, default 500
MCPB package https://github.com/scalably-io/hunter-mcp/releases/download/v1.0.0/hunter-mcp.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Hunter MCP
  2. Install
  3. Setup
  4. Tools (11)
  5. Configuration
  6. Reply shape
  7. Limits
  8. Verify
  9. Privacy Policy
  10. License

Hunter MCP

Hunter.io MCP server. 11 tools cover domain search, email finding and verification, enrichment, company discovery, and lead management.

Install

Claude Code:

claude mcp add hunter -e HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcp

Codex:

codex mcp add hunter --env HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcp

Claude Desktop: download hunter-mcp.mcpb from the latest GitHub release and open it.

Setup

  1. Create an API key at hunter.io/api-keys.
  2. create_lead writes to your Hunter leads list and is the only non-read tool; the other 10 tools are read-only.

Tools (11)

ToolWhat it does
account_infoRead the Hunter v2 account plan and exact current credit usage, including remaining unified or per-type balances
domain_searchSearch Hunter v2 emails for one domain/company with current people, verification, location, job-title, decision-maker, aggregation, and offset filters
email_finderFind and automatically verify the most likely professional email from a company/domain plus name, or directly from a LinkedIn handle
email_verifierVerify one email address with Hunter v2 and return exact deliverability, score, SMTP/MX, accept-all, webmail, disposable, and source evidence
email_countCount Hunter email coverage for a domain/company, optionally limited to personal or generic addresses, without returning addresses
email_enrichmentEnrich a person from an email address or LinkedIn handle using Hunter v2, optionally in Clearbit-compatible format
company_enrichmentEnrich a company from its domain using Hunter v2, optionally in Clearbit-compatible format
combined_enrichmentEnrich both a person and their company from one email using Hunter v2, optionally in Clearbit-compatible format
discoverUse Hunter Discover v2 to find companies from current natural-language or structured organization, location, industry, headcount, type, year, keyword, technology, and funding filters
create_leadCreate one Hunter lead from a required email and optional current lead fields, list placement, and custom attributes. This is a single-attempt mutation
list_leadsList Hunter leads with current list, identity, company, status, verification, activity/date, location, tag, campaign, user, confidence, custom-attribute, query, and offset filters

Configuration

VariableRequiredPurpose
HUNTER_API_KEYyesHunter.io API key from hunter.io/api-keys
HUNTER_API_BASEnoOverride the Hunter API base URL (default https://api.hunter.io/v2)
HUNTER_TIMEOUT_MSnoPer-request timeout in milliseconds (default 30000)
HUNTER_RETRY_BASE_MSnoBase delay in milliseconds for the GET retry backoff (default 500)

Reply shape

Every tool returns plain JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures throw a plain error string: <code>: <message> <hint>.

Limits

Hunter's per-plan request quotas surface in account_info.

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the packed tarball on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

الأسئلة الشائعة

ما هو Hunter MCP؟

Hunter.io MCP: domain search, email finder and verifier, enrichment, discovery, leads. 11 tools.

كيف أثبّت Hunter MCP؟

يعمل على جهازك. في Claude Code: claude mcp add hunter-mcp -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'HUNTER_API_BASE=<HUNTER_API_BASE>' -e 'HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS>' -e 'HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS>' -- npx -y @scalably-io/hunter-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Hunter MCP إلى مفتاح API؟

نعم. يتطلب HUNTER_API_KEY، وتضبطها في إعداداته.

هل Hunter MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Hunter MCP؟

ينشره scalably-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.