RocketReach

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.

account

Check the status of one or more in-flight person lookups returned with `status: "pending"` by `person_lookup` or `profile_company_lookup`. Accepts a single `profile_id` or an array of up to 100 `profile_id`s, and returns the current state for each: `complete` with full contact data, `pending` with profile metadata only, or `failed` if the search ran to completion but no contact info was found. Lookups typically resolve within ~5 seconds but can take longer when the system is degraded. Wait at least 3 seconds between polls for the same `profile_id`. No credits consumed and no changes to the user's RocketReach contacts.

check_person_status

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 Contacts" with default tags (`MCP Lookups` plus the AI client name) plus any tags passed via the `tags` parameter.

company_lookup

Search RocketReach for companies. Supports filtering by: identity (name, domain, website URL, email domain, social links, phone); classification (industry, primary industry, industry tags / keywords, SIC, NAICS, website category); size & financials (employee count, revenue, total funding, growth, publicly-traded indicator); location (HQ city/state/country with optional radius); technology (techstack); plus other signals (keyword, description, company_tag, news signals, hiring/job-posting signals, SEC filings, website-intelligence changes, product-review themes, website-traffic shifts, patent activity, intent, competitors). Any facet can also be excluded via the `exclude` parameter. Numeric facets (employees, revenue, total_funding) support operators — 1000+, <5000, 100-500. Returns matching company summaries (name, domain, industry, employee count, company ID). No credits consumed and no changes to the user's RocketReach contacts.

company_search

Look up contact information for a specific person, identified by RocketReach profile ID, email, LinkedIn URL, NPI number (US healthcare), or name plus current employer (optionally narrowed with `title`). NPI number is a standalone identifier — use it for any US healthcare lookup. Charges 1 lookup credit — the type depends on the user's plan (`standard_lookup` returns email only; `premium_lookup` or `phone_lookup` returns email + phone; `person_enrich` returns profile metadata only, no contact info) — plus 1 `person_export` credit when the user has them issued (skipped otherwise). `lookup_type` forces a specific lookup credit type; omit to use the user's configured order. Adds the resolved contact to the user's RocketReach "My Contacts" with default tags (`MCP Lookups` plus the AI client name) and any tags passed in `tags`; `profile_list_name` additionally adds it to a named profile list. Arbitrary key/value `metadata` can be attached to the lookup record. The lookup is asynchronous: this returns either complete contact data, or `status: "pending"` with a `profile_id` to retrieve via `check_person_status` once it resolves (polling is free — no credits).

person_lookup

Search RocketReach for people by professional attributes. Supports filtering by: identity (name, profile ID); job & employer (current/previous title, current/previous employer, department, management level / seniority, years of experience, recent job-change signals); skills (any-of or all-of); education (school, degree, major); location (city/state/country, optional radius like "Boston"::~25mi); contact (email, email confidence grade, phone, phone confidence grade, contact method, LinkedIn URL); current-employer attributes (company size, revenue, industry, SIC/NAICS, tags, saved-list membership, competitors, intent signals, company news signals, hiring/job-posting signals); healthcare (NPI number, medical license, specialization, credentials); plus free-text keyword. Any facet can also be excluded via the `exclude` parameter (e.g., exclude a specific current employer). Numeric facets support operators — 1000+, <5000, 3-7. Returns matching profile summaries (name, current title, current company, location, profile ID); does not return contact info. `person_lookup` returns emails and phone numbers. No credits consumed and no changes to the user's RocketReach contacts.

person_search

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

ping

Retrieve contact information for a person and full details for their current company in a single call. Total cost is 1, 2, or 3 credits depending on the user's plan: 1 lookup credit (always), 1 `person_export` credit (only if the user has them issued), and 1 `company_export` credit (required — fails with `insufficient_credits` if the user has no company exports issued or available). Adds both the person and the company to the user's RocketReach "My Contacts" with default tags (`MCP Lookups` plus the AI client name) plus any tags passed via the `tags` parameter. `person_lookup` and `company_lookup` are the equivalent single-side calls; this combined tool charges the credits for both sides. The company side is resolved immediately; the person side is asynchronous and may return `status: "pending"` with a `profile_id` — when that happens, the company data is already included in the response and the `profile_id` resolves to contact data via `check_person_status` once ready.

profile_company_lookup