RocketReach Local MCP

A local Model Context Protocol server for RocketReach that uses the REST API and an API key. It replaces the official OAuth MCP when that endpoint is flaky or rate-limited.

Setup

1. Install dependencies

pip install -r requirements.txt

2. Add your API key

Store your key in your user config folder (recommended):

Windows

mkdir $env:USERPROFILE\.rocketreach
Set-Content $env:USERPROFILE\.rocketreach\api_key "YOUR_API_KEY"

macOS / Linux

mkdir -p ~/.rocketreach
echo "YOUR_API_KEY" > ~/.rocketreach/api_key
chmod 600 ~/.rocketreach/api_key

Alternative locations (checked in order):

Priority	Location
1	`~/.rocketreach/api_key` — plain text file
2	`~/.rocketreach/.env` — `ROCKETREACH_API_KEY=...`
3	Project `.env` — `ROCKETREACH_API_KEY=...`
4	`ROCKETREACH_API_KEY` environment variable

Get your key from RocketReach Account → API.

3. Connect in Cursor

Add to %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "rocketreach": {
      "command": "python",
      "args": ["C:\\path\\to\\RocketReach MCP\\server.py"],
      "cwd": "C:\\path\\to\\RocketReach MCP"
    }
  }
}

Reload MCP servers in Cursor (Settings → MCP → refresh).

Tools

Tool	Description	Credits
`ping`	Liveness check	No
`account`	Plan, credits, rate limits	No
`person_search`	Search 700M+ profiles	No
`company_search`	Search companies	No
`person_lookup`	Emails/phones for a person	Yes
`company_lookup`	Full company profile	Yes
`check_person_status`	Poll async person lookups	No

Usage examples

In Cursor chat

Check my RocketReach account credits

Find VPs of Engineering at SaaS companies in New York

Look up person id 531625233

CLI tests

# Test REST client (account + sample search)
python test.py --local

# Credits and rate limits only
python test.py --usage

# Official MCP OAuth smoke test (optional)
python test.py --smoke

Python client

from rocketreach_mcp.client import RocketReachClient

client = RocketReachClient()

print(client.account())

results = client.person_search(
    {"current_title": ["VP Engineering"], "location": ["New York"]},
    page_size=5,
)
print(results["pagination"], len(results["profiles"]))

MCP server (stdio)

python server.py

Person search query examples

{"name": ["Jane Doe"]}
{"current_title": ["Software Engineer"], "current_employer": ["Google"]}
{"location": ["\"San Francisco\"::~50mi"], "management_levels": ["director", "vp"]}
{"skills": ["python", "machine learning"]}

Use quotes inside values for exact match: "\"IBM\"".

Company search query examples

{"domain": ["stripe.com"]}
{"industry": ["Software"], "employees": ["100-500"]}
{"techstack": ["Salesforce"]}

Person lookup

Provide one identifier:

id — RocketReach profile ID from search
email
linkedin_url
name + current_employer
npi_number

If status is progress, call check_person_status with the profile ID.

Project layout

RocketReach MCP/
├── server.py              # MCP server entrypoint
├── rocketreach_mcp/
│   ├── client.py          # REST API client
│   └── config.py          # ~/.rocketreach credential loading
├── test.py                # CLI tests
├── requirements.txt
└── README.md

Notes

Search endpoints do not consume credits; lookups do.
The client retries on HTTP 429 using Retry-After or backoff.
Keep ~/.rocketreach/api_key out of git; it is user-local only.

RocketReach Local MCP