Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Hunter MCP server

Vendor MCP
Open markdown

The Hunter MCP connector routes your AI agent's tool calls to Hunter's own MCP server through Scalekit. Each user signs in to Hunter once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 112 tools.

Tools
112
What they doRead · write · destructive
43 · 32 · 3743 read32 write37 destructive
Users sign in with
OAuth app
Your own Hunter MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Hunter MCP connection

    In AgentKit > Connections, create a Hunter MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Hunter MCP server connections use your own OAuth app. Register one with Hunter MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Hunter MCP connection.

  5. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'huntermcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Hunter MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'huntermcp_find_people',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • huntermcp_email_countUse this when the user wants the count of email addresses Hunter has indexed for a domain, optionally split by personal vs generic.Read-only

    Email Count

    Use this when the user wants the count of email addresses Hunter has indexed for a domain, optionally split by personal vs generic. Free to call. Do not use this as a substitute for Domain-Search; this returns a count only, not the email list itself.

    Inputs

    domainstringrequired
    Domain name to count email addresses for
    typestring
    Type of email addresses to countone of personalgeneric
  • huntermcp_find_companiesUse this when the user wants to search for companies that match natural-language criteria such as location, industry, size, type, or technologies.Read-only

    Find Companies

    Use this when the user wants to search for companies that match natural-language criteria such as location, industry, size, type, or technologies. Returns up to 100 matching companies per page; use `limit` and `offset` to paginate. Plans without Discover paging get only the first page. The response includes `meta.permalink` — a link to the same query on hunter.io that the user can open to view all results with the inferred filters applied. Free to call.

    Inputs

    querystringrequired
    Your search query
    limitinteger
    Maximum number of companies to return (default 100, max 100)
    offsetinteger
    Number of companies to skip (default 0, max 10000). Plans without Discover paging get only the first page: any offset above 0 is rejected, so use `limit` for a smaller page.
  • huntermcp_find_peopleCount the people that can be extracted from companies — the bridge from Find-Companies to actual contacts; call it right after a Find-Companies result when the user says 'now get me the people at these companies'.Read-only

    Count People at Companies

    Count the people that can be extracted from companies — the bridge from Find-Companies to actual contacts; call it right after a Find-Companies result when the user says 'now get me the people at these companies'. For each matching company it reports how many email addresses Hunter's public index holds: `emails_count.personal` counts addresses tied to a named person (the people you can actually extract), `emails_count.generic` counts role-based addresses such as info@ or sales@, and `emails_count.total` combines both. `meta.total_emails` aggregates the same three counters across ALL companies matching the search — not just the current page — so use it to size a prospecting batch upfront. This tool returns counts only, from Hunter's public index: to reveal the actual email addresses, names, and positions at a company, call Domain-Search with that company's domain (uses credits). Provide either `query` (natural-language criteria, translated to filters exactly like Find-Companies) or `domains` (exact company domains, e.g. lifted from a Find-Companies result); when both are given, `query` takes precedence and `domains` is not sent. Free (no credits).

    Inputs

    domainsarray
    Exact company domains to extract people counts for (e.g. from a Find-Companies result). Ignored when `query` is provided.
    limitinteger
    Maximum number of companies to return (default 100, max 100)
    offsetinteger
    Number of companies to skip (default 0). Plans without Discover paging get only the first page: any offset above 0 is rejected, so use `limit` for a smaller page.
    querystring
    Natural-language company search criteria, translated to Discover filters exactly like Find-Companies. Example: 'fintech startups in France with 11-50 employees'
  • huntermcp_find_similar_companiesFind companies similar to a seed, ranked by `similarity_score` (0-100, higher is closer).Read-only

    Find Similar Companies

    Find companies similar to a seed, ranked by `similarity_score` (0-100, higher is closer). Seed with exactly one of `company_list_id` (a static company list; List-Company-Lists shows each list's `type`) or `domain` (one company). `industry` and `size` are hard filters. `industry` must match a LinkedIn industry name exactly (case-insensitive), so reuse the `industry` values from earlier results. `country` is a ranking preference, not a filter: same-country companies rank higher, but other countries and companies with no known country can still appear, so check each result's `country` before saying all results are in one country. There is no paging. An empty `data` array means the domain is not in Hunter's index, the list has no companies, nothing similar was found, or the `industry`/`size` filters removed every result; say which is likely instead of saying nothing similar exists. A dynamic list returns an invalid_input error (field unsupported_list_type): use a static company list or a `domain` seed instead. This feature is not available on free plans. A feature_not_in_plan error means the user's plan does not include it: tell the user that and do not ask the user to reconnect. An unauthorized error is an authentication problem. To save results, call Save-Company for each chosen domain to get its company id. For one or two companies, then call Add-Company-To-List; for more, add all the ids in one Bulk-Copy-Companies call. A company that is already in the target list counts as saved (Add-Company-To-List returns `already_in_list: true`); continue with the next one. Free (no credits).

    Inputs

    company_list_idinteger
    ID of a static company list to seed from. Provide this or `domain`, not both.
    countrystring
    ISO 3166 alpha-2 country code, e.g. FR. Ranks same-country companies higher; it does not filter.
    domainstring
    Domain or website URL of one company to seed from, e.g. stripe.com. Provide this or `company_list_id`, not both.
    industryarray
    Keep only these industries (exact LinkedIn industry names, case-insensitive)
    limitinteger
    Maximum number of companies to return (default 20, max 100)
    sizearray
    Keep only these employee-count buckets
  • huntermcp_get_account_detailsUse this when the user asks about their Hunter account, plan, team, or remaining credits.Read-only

    Get Account Details

    Use this when the user asks about their Hunter account, plan, team, or remaining credits. Returns plan name, team info, and per-product credit balances (search, verification, enrichment). Free to call.

    Inputs

    This tool takes no inputs.

  • huntermcp_get_briefingGet a short summary of what is new in the user's Hunter account.Read-only

    Get Briefing

    Get a short summary of what is new in the user's Hunter account. It answers open questions such as "What should I do in Hunter today?" or "What is new in Hunter?". It returns the number of new lead signal events (funding rounds, technology changes, new contacts and executives, job posts, hiring and headcount changes, and contacts who moved or changed position, in the team's lists), the number of new events from the team's Monitored Signals, the number of this week's opportunities (groups of people or companies like the ones the team saved), and the plan and remaining credits. Each item has a status: ok, unavailable (it could not be read now; try again later), or no_access (the plan does not include it, or a team setting turned it off; reason gives the error id). When count_exact is false, count is a lower bound. Each item's next_call names the tool (mcp_tool) and the arguments (params) that read its details, such as List-Signals or List-Opportunities. By default it counts the last 7 days; since counts only what happened after it, at most 30 days back. To check again later, pass meta.next_since as since. Free (no credits), and it marks nothing as seen.

    Inputs

    leads_sincestring
    Like since, for the lead signals item only: pass that item's last next_since.
    monitored_sincestring
    Like since, for the Monitored Signals item only: pass that item's last next_since.
    sincestring
    ISO 8601 date-time, not in the future, such as 2026-11-01T00:00:00Z. Count only what happened after it. Default: 7 days ago. A value older than 30 days reads as 30 days ago.
  • huntermcp_get_company_listGet a single company list by ID, including its `name`, `type` (static or dynamic), `filters` (for dynamic lists), `company_list_folder_id`, `created_at`, and `companies_count` (the number of companies currently in the list).Read-only

    Get Company List

    Get a single company list by ID, including its `name`, `type` (static or dynamic), `filters` (for dynamic lists), `company_list_folder_id`, `created_at`, and `companies_count` (the number of companies currently in the list). Returns a not-found error if the list does not exist or belongs to another team. Free (no credits).

    Inputs

    idintegerrequired
    ID of the company list to retrieve
  • huntermcp_get_connected_appGet a single connected app by ID, including its `attribute_mappings` — the list of `target_field` ↔ `source_field` pairs that map Hunter fields to the integration's fields.Read-only

    Get Connected App

    Get a single connected app by ID, including its `attribute_mappings` — the list of `target_field` ↔ `source_field` pairs that map Hunter fields to the integration's fields. Each mapping may also include a `direction` (`export` to the integration, `import` into Hunter, or `both`) and a `conflict_policy` for imports (`crm_wins` overwrites the Hunter value, `fill_if_empty` only fills an empty one; null for export-only mappings). Also returns the `provider`, resolved `name`, `category`, `provider_email`, and `connected_at` / `updated_at` timestamps. Returns a not_found error if the app does not exist or belongs to a different team. Free (no credits).

    Inputs

    idintegerrequired
    ID of the connected app to retrieve