Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the RocketReach MCP server

Vendor MCP
Open markdown

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

Tools
13
What they doRead · write · destructive
6 · 0 · 76 read0 write7 destructive
Users sign in with
OAuth app
Your own RocketReach 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 RocketReach MCP connection

    In AgentKit > Connections, create a RocketReach 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

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

    Then enter the app's Client ID and Client Secret on the RocketReach 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 = 'rocketreachmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize RocketReach 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: 'rocketreachmcp_account',
    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
  • rocketreachmcp_accountRetrieve the authenticated user's RocketReach account info: plan name and limits, credit balances, lifetime usage, daily API call count and limit, and rate-limit status.Read-only

    Account

    Retrieve the authenticated user's RocketReach account info: plan name and limits, credit balances, lifetime usage, daily API call count and limit, and rate-limit status. The `credit_usage` field is a per-type breakdown showing which of the seven credit types are issued on this account (`standard_lookup`, `premium_lookup`, `phone_lookup`, `person_enrich`, `person_export`, `company_export`, `email_verification`) and how many are allocated, used, and remaining. `allocated: 0` means the user does not have that credit type issued: a user with only `standard_lookup` credits will not receive phone numbers from `person_lookup`; a user without `company_export` will receive `insufficient_credits` from `company_lookup` and `profile_company_lookup`; a user without `email_verification` will receive `insufficient_credits` from `email_verify`. The rollup field `person_export_credit_balance` may be the string `'inf'` — a v2 convention meaning "not tracked on this account; doesn't apply," not infinite credits available. No credits consumed.

    Inputs

    This tool takes no inputs.

  • rocketreachmcp_check_person_statusCheck the status of in-flight person lookups returned with `status: "pending"` by `person_lookup`, `profile_company_lookup`, or `bulk_person_lookup`.Read-only

    Check Person Status

    Check the status of in-flight person lookups returned with `status: "pending"` by `person_lookup`, `profile_company_lookup`, or `bulk_person_lookup`. Pass exactly one of: `profile_id` — a single id or an array of up to 100 — or `rr_request_id` — the batch id returned by `bulk_person_lookup`, which retrieves every profile in that batch in one call. Returns the current state for each profile: `complete` with full contact data, `pending` with profile metadata only, or `failed` if the search ran to completion but no contact info was found. A scalar `profile_id` returns a single record; an array or an `rr_request_id` returns `{ records: [...] }` — re-poll until no record is still `pending`. An `rr_request_id` returns one record per query, each with its `query_index` (its position in the bulk request); a `failed` record there carries a `failure_reason`: `no_match` (no profile matched the query), `suppressed` (the profile is on the team's suppression list), `not_processed` (the query was not attempted, e.g. the account ran out of credits), `profile_unavailable` (the matched profile is no longer available), or `no_contact_info`. Lookups typically resolve within ~5 seconds (longer for a bulk batch, or when the system is degraded). Wait at least 3 seconds between polls. No credits consumed and no changes to the user's RocketReach contacts.

    Inputs

    profile_idarray
    One or more RocketReach profile IDs to check. A single number or an array of up to 100. Omit when passing `rr_request_id`.
    rr_request_idstring
    The `rr_request_id` returned by `bulk_person_lookup`; returns every profile in that batch. Omit when passing `profile_id`.
  • rocketreachmcp_list_filter_valuesList the exact values a faceted search field accepts, fuzzy-matched against `query` (use one or two key words; leave it empty to list the field's values).Read-only

    List Filter Values

    List the exact values a faceted search field accepts, fuzzy-matched against `query` (use one or two key words; leave it empty to list the field's values). Call this before `person_search` / `company_search` instead of guessing: a guessed value silently returns fewer results or none. Pass the returned `value` to the search field exactly; `label` is only for display. `country` takes the ISO code (US, GB). `state` takes a US/Canada region code and has no country, so a code like WA also matches Western Australia; add `country` to narrow. `location` lists presets but also takes free-text cities and zip codes. An industry group covers all its sub-industries; an unrecognized industry is silently remapped to the nearest one. `country`, `state`, `department` and `management_levels` exist on `person_search` only (`company_search` ignores them; use `location` for company HQ). Signal values also need a `::<timeframe>` suffix, as the search field describes. No credits consumed.

    Inputs

    fieldstringrequired
    The search field to list values for, by its facet name.one of industrycompany_industryprimary_industrymanagement_levelsdepartmentcountrystatelocationnews_signalcompany_news_signaljob_posting_signalcompany_job_posting_signalsec_filing_signalcompany_sec_filing_signalwebsite_intelligence_signalcompany_website_intelligence_signalproduct_review_signalcompany_product_review_signalseo_website_traffic_signalcompany_seo_website_traffic_signaljob_change_signal
    limitinteger
    Maximum values to return (default 25, max 502).
    querystring
    Text to match, e.g. "united states", "vp", "engineering". Empty lists all values.
  • rocketreachmcp_pingLiveness check.Read-only

    Ping

    Liveness check. Takes no input and returns the server name, version, and "pong".

    Inputs

    This tool takes no inputs.

  • rocketreachmcp_bulk_person_lookupLook up contact information for up to 100 people in one call.Destructive

    Bulk Person Lookup

    Look up contact information for up to 100 people in one call. Each entry in `queries` identifies one person the same way as `person_lookup`: RocketReach profile ID, email, LinkedIn URL, NPI number (US healthcare), or name plus current employer (optionally narrowed with `title`), plus an optional per-query `lookup_type` and `metadata`. Each query is charged exactly as a single `person_lookup` would be (1 lookup credit, type depending on the user's plan or the forced `lookup_type`). Every query is validated before the batch is submitted: one invalid entry (e.g. no identifier) rejects the whole call with no credits charged. Resolved contacts are added to the user's RocketReach "My Contacts" and to the profile list named by `profile_list_name` (v2 default: "API Bulk Lookup"). Unlike `person_lookup`, bulk lookups can't apply tags. The batch is asynchronous: this returns `status: "pending"` with an `rr_request_id`. Pass that `rr_request_id` to `check_person_status` to retrieve every profile in the batch in a single call (polling is free — no credits); re-poll until no record is still `pending`.

    • Idempotent

    Inputs

    queriesarrayrequired
    People to look up (1–100). Each needs one of: id, email, linkedin_url, npi_number, or name + current_employer.
    profile_list_namestring
    Name of a profile list to add the contacts to (v2 default: "API Bulk Lookup").
  • rocketreachmcp_company_lookupRetrieve full details for a specific company — description, industry, employee count, revenue, founded year, tech stack, social links, and more — identified by domain, RocketReach company ID, name, stock ticker, or LinkedIn URL.Destructive

    Company Lookup

    Retrieve full details for a specific company — description, industry, employee count, revenue, founded year, tech stack, social links, and more — identified by domain, RocketReach company ID, name, stock ticker, or LinkedIn URL. Charges 1 `company_export` credit and requires the user to have `company_export` credits issued and available — if not, fails with `insufficient_credits` (`credit_type: "company_export"`). The `account` tool's `credit_usage` array reports whether the user has `company_export` credits issued. Adds the company to the user's RocketReach "My Companies" with default tags (`MCP Lookups` plus the AI client name) plus any tags passed via the `tags` parameter.

    • Idempotent

    Inputs

    domainstring
    Company website domain, e.g. acme.com.
    idinteger
    RocketReach company ID.
    linkedin_urlstring
    Company LinkedIn URL.
    namestring
    Company name.
    tagsarray
    Tags to apply to the resolved company, in addition to the MCP default tags.
    tickerstring
    Stock ticker symbol.