Tools Reference

Most tools are read-only and consume no credits. Three tools consume credits: person_lookup, profile_company_lookup, and company_lookup. These also add resolved contacts and companies to your My Contacts list.

person_search

Search RocketReach's database of 700M+ professional profiles by professional attributes. Returns matching profile summaries — name, current title, current employer, location, and profile ID. Does not return contact info (emails, phones); use person_lookup for that.

No credits consumed.

Input

Facets

Identity & job

Skills & education

Location

Contact

Current employer attributes

Healthcare

Other

Response

{
  "pagination": { "start": 1, "next": 11, "total": 4242 },
  "profiles": [
    { "id": 101, "name": "Ada Lovelace", "current_title": "Engineer", "current_employer": "Acme", "location": "London, UK" }
  ]
}

Each entry in profiles includes id, name, current_title, current_employer, and location. The id is the RocketReach profile ID — pass it to person_lookup to retrieve contact information.

company_search

Search RocketReach's company database. Returns matching company summaries — name, domain, industry, employee count, and company ID.

No credits consumed.

Input

Facets

Identity

Classification

Size & financials

Location

Technology

Other

Response

{
  "pagination": { "start": 1, "next": 11, "total": 87 },
  "companies": [
    { "id": 9001, "name": "Acme Corp", "domain": "acme.com", "industry_str": "Software", "employee_count": 250 }
  ]
}

Each entry in companies includes id, name, domain, industry_str, and employee_count.

Search signals

A few search facets filter by recent activity signals rather than static attributes. Each takes a value of the form Category::time_window — an exact category string, then ::, then exactly one time window. Pass an array to match any of several signals.

Time windows

• News and job-posting signals: one_week, one_month, three_months, six_months, one_year
• Job-change signals: one_week, one_month, three_months (job-change data only goes back three months)

job_change_signal — person_search

A person who recently changed jobs. Categories: Company Change, Promotion. Example: Company Change::one_month.

company_news_signal / news_signal — news event

A news event at the company (the person's current employer for person_search, the company itself for company_search). Example: Funding::one_month. Categories:

Attends Event, Award, Closes Offices, Competitor Identified, Decreases Headcount, Developing Product, Executive Departure, Executive Hire, Executive Promotion, Executive Retirement, Expands Facilities, Files Lawsuit, Funding, Increases Headcount, Integration, Invests Into, IPO, Launches Product, Mergers & Acquisitions, New Customer, Partnership, Purchases Assets, Recognition, Sells Assets, Vulnerability.

company_job_posting_signal / job_posting_signal — hiring activity

The company is actively hiring for a department. Example: Engineering Roles::one_month. Categories:

Accounting Roles, Administration Roles, Business Development Roles, Corporate Communications Roles, Customer Services Roles, Engineering Roles, Facilities Management Roles, Finance Roles, Human Resources Roles, Information Technology Roles, Legal Roles, Logistics Roles, Machine Learning Roles, Marketing Roles, Operations Roles, Procurement Roles, Production or Manufacturing Roles, Public Relations Roles, Quality Assurance Roles, Recruiting Roles, Research and Development Roles, Sales Roles, Strategy Roles.

person_lookup

Look up contact information for a specific person. Returns emails, phone numbers, and profile metadata. Charges credits and adds the contact to your My Contacts list with default tags (MCP Lookups plus the AI client name) and any tags you pass.

Consumes 1 lookup credit, plus 1 person export credit.

The lookup is asynchronous. If the result is not yet ready, the tool returns status: "pending" with a profile_id to poll via check_person_status. Polling is free.

Input

Provide at least one identifier: id, email, linkedin_url, npi_number, or name + current_employer.

Response — complete

{
  "profile_id": 101,
  "status": "complete",
  "name": "Ada Lovelace",
  "current_title": "Engineer",
  "current_employer": "Acme",
  "emails": [{ "email": "[email protected]", "grade": "A" }],
  "phones": [{ "number": "+1-555-0101", "type": "direct" }]
}

Response — pending

{
  "status": "pending",
  "profile_id": 101,
  "retry_after_seconds": 3,
  "name": "Ada Lovelace",
  "current_title": "Engineer",
  "current_employer": "Acme"
}

Call check_person_status with the profile_id once a few seconds have passed. Average resolution time is ~5 seconds.

profile_company_lookup

Retrieve contact information for a person and full details for their current company in a single call. The person side is asynchronous (returns pending/complete like person_lookup); the company side resolves immediately.

Consumes 1 lookup credit + 1 person export credit + 1 company export credit.

Adds the resolved contact and company to your My Contacts list.

Input

Same parameters as person_lookup: one of id, email, linkedin_url, npi_number, or name + current_employer as identifier, plus optional title, lookup_type, tags, and metadata.

Response — complete

{
  "profile_id": 101,
  "status": "complete",
  "name": "Ada Lovelace",
  "emails": [{ "email": "[email protected]", "grade": "A" }],
  "phones": [{ "number": "+1-555-0101", "type": "direct" }],
  "company": {
    "id": 9001,
    "name": "Acme Corp",
    "domain": "acme.com",
    "industry_str": "Software",
    "employee_count": 250
  }
}

Response — pending

The company data is already present in the pending response. Call check_person_status with the profile_id to retrieve the contact details.

{
  "status": "pending",
  "profile_id": 101,
  "retry_after_seconds": 3,
  "name": "Ada Lovelace",
  "company": { "id": 9001, "name": "Acme Corp", "domain": "acme.com" }
}

company_lookup

Retrieve full details for a specific company: description, industry, employee count, revenue, founded year, tech stack, social links, and more. Adds the company to your My Contacts list.

Consumes 1 company export credit.

Input

Provide at least one identifier.

Response — complete

Full company profile: id, name, domain, industry_str, employee_count, revenue, founded, description, techstack, social links, and more.

account

Retrieve the authenticated user's RocketReach account information: plan name, credit balances, rate-limit status, and daily API call usage.

No credits consumed.

Input

None.

Response

check_person_status

Poll the status of one or more in-progress person lookups. Use this after person_lookup returns status: "pending" to retrieve results once the lookup completes.

Wait at least 3 seconds between polls for the same profile_id. Lookups typically resolve within ~5 seconds.

No credits consumed.

Input

Response

Array of status records, one per profile_id:

ping

Liveness check. Returns the server name and version. Useful for verifying connectivity and auth before making tool calls.

Input

None.

Response

{
  "name": "rr-mcp-server",
  "version": "1.0.0",
  "message": "pong"
}