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. Faceted fields (industry, primary_industry) match exact stored values only. `list_filter_values` returns the accepted values for each. 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

Verify a single email address with RocketReach's email verifier: it checks the address's format, confirms the domain accepts mail, and probes the mailbox on the receiving mail server. Example prompt: "Verify john@acme.com". Charges 1 `email_verification` credit — except when the result is `unknown`, where the credit is refunded and `credits_charged` comes back 0. `status` is one of: `valid` (the mailbox exists and accepts mail), `invalid` (the mailbox does not exist or the domain rejects mail — don't send to it), `catchall` (the domain accepts mail for any address, so this specific mailbox can't be confirmed either way — the same state `person_lookup` reports as `accept-all` in an email's `smtp_valid`), or `unknown` (the receiving server gave no usable answer, so the result is inconclusive; at most one retry, later, is worth attempting — an immediate retry will not resolve it). `checks` reports the individual signals behind that status, each `true`, `false`, or `null` when it couldn't be determined: `format_valid` (syntactically well-formed), `domain_valid` (the domain exists and accepts mail), `disposable` (a throwaway/temporary email provider), and `catchall` (the domain accepts any address). `mx_record` is the domain's primary MX host, or `null` when the domain publishes none. Verifies one address per call. If the user has no email verification credits the call fails with `insufficient_credits` and a message carrying a link to purchase more; the `account` tool's `credit_usage` array reports the `email_verification` balance.

email_verify

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.

list_filter_values

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