# RocketReach MCP

> RocketReach lets your AI agent find verified emails and direct phone numbers for professionals and companies. It searches people by title, looks up company details, and manages account credits—all within your chat interface. Stop jumping between LinkedIn and spreadsheets; get the data you need instantly.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** b2b-database, contact-enrichment, verified-emails, prospecting, sales-intelligence, data-retrieval

## Description

Look, you're gonna need this server connected to your AI agent if you wanna stop wasting time jumping between LinkedIn, spreadsheets, and ten different tabs. This whole setup lets your agent find verified emails and direct phone numbers for professionals and companies, right inside the chat window. You get detailed company data and searchable people profiles without leaving your workflow.

### Finding Leads and Company Data

To start finding leads, you'll use `search_people` to search professional profiles by name, title, or what company they work for. If you know a specific person, `lookup_person` lets the agent pull verified contact details—like their email and phone number—using just one credit. For companies, you can run `search_companies` to find businesses that fit criteria like industry or employee count. Then, if you need deep background on a specific organization, `lookup_company` pulls detailed profile information based on the company's name or domain.

### Checking Account Status and Billing

The agent keeps track of your account status for you. You can run `get_credit_usage` to see exactly how many credits you have left and check out your usage history so you don't blow through your budget unexpectedly. If you need to look at the financials, `get_billing_info` fetches all the current billing details for your linked RocketReach account. You can also ask for general account status using `get_account_info`, which retrieves basic metadata about your profile.

### Managing Your Workflow and Webhooks

When you're setting up automated data pipelines, the server gives you full control. To set up a webhook so external actions trigger when specific data changes, you use `create_webhook`. If that automation needs to stop, `delete_webhook` removes the configured endpoint, stopping future data transmissions. You can review everything currently active using `list_webhooks`, which displays every webhook setup on your account. For quick reference, `list_recent_searches` shows the last few searches you performed so you don't have to re-type queries.

### Monitoring Tasks and History

The agent handles task status updates through several tools. If you request a contact lookup and need to know if it’s done yet, `check_lookup_status` tells you if the process is finished or still running in the background. You can also see all available webhooks by calling `list_webhooks`, giving you a clear list of what's set up.

This setup lets your agent do everything: it pulls specific contact info, researches whole industries, and manages the backend plumbing so you just focus on asking for the data you need.

## Tools

### check_lookup_status
Checks if a previously requested contact lookup is finished or still running.

### create_webhook
Sets up an external webhook endpoint to receive data when certain events happen in your account.

### delete_webhook
Removes a configured webhook from the server, stopping future data transmissions.

### get_account_info
Retrieves basic metadata about your connected RocketReach account profile.

### get_billing_info
Fetches current billing details for the linked RocketReach account.

### get_credit_usage
Shows real-time statistics on your remaining credit and usage history to prevent overspending.

### list_recent_searches
Lists the last few searches you performed, allowing quick reference without repeating queries.

### list_webhooks
Displays all webhooks currently set up and active on your account for review.

### lookup_company
Gets detailed profile information about a specific company based on its name or domain.

### lookup_person
Uses one credit to pull verified contact details (email, phone) for an individual.

### search_companies
Searches the database to find companies matching specific criteria like industry or employee count.

### search_people
Searches for professional profiles by name, title, or company affiliation.

## Prompt Examples

**Prompt:** 
```
Search for 'John Doe' who works at 'Google'.
```

**Response:** 
```
I've performed the search. I found a match for 'John Doe' (Lead Software Engineer) at Google. Would you like me to look up his verified contact information?
```

**Prompt:** 
```
Search for VP of Engineering contacts at Series B SaaS companies in San Francisco.
```

**Response:** 
```
Found 23 VP of Engineering profiles matching criteria. Top results: James Park (VP Engineering, CloudScale, 120 employees, Series B $24M). Email: j.park@cloudscale.io (verified). Sarah Chen (VP Engineering, DataForge, 85 employees, Series B $18M). Email: sarah@dataforge.com (verified). Alex Rivera (VP Platform Engineering, APIFirst, 200 employees, Series B $35M). Email: alex.r@apifirst.io (verified). 20 additional results available. Email accuracy: 94%. Phone numbers found for 18 of 23 contacts.
```

**Prompt:** 
```
Look up the complete profile and contact information for the CEO of Meridian Corp.
```

**Response:** 
```
Profile found: David Chen, CEO & Co-founder, Meridian Corp. Email: d.chen@meridiancorp.com (verified, last validated 3 days ago). Phone: +1-415-555-0198 (direct line). LinkedIn: linkedin.com/in/davidchen-meridian. Location: San Francisco, CA. Company: Meridian Corp (Enterprise SaaS, 340 employees, Series C $52M). Previous: CTO at DataFlow (2018-2021), Senior Engineer at Google (2014-2018). Education: Stanford CS MS, MIT BS. Board member: 2 advisory roles.
```

## Capabilities

### Search for Leads and Companies
The server lets your AI client search for specific professionals (`search_people`) or detailed company profiles (`lookup_company`).

### Retrieve Verified Contact Details
You can get verified emails and direct phone numbers for an individual using their profile metadata or a known URL.

### Manage Account Metrics
The agent reports on your account status, including usage credits (`get_credit_usage`) and billing details (`get_billing_info`).

### Automate Data Pipelines
You can set up or delete webhooks using `create_webhook` or `delete_webhook` to trigger external actions when data changes.

## Use Cases

### Targeting a new industry vertical.
A recruiter needs 5 VP-level contacts in Fintech, but the company is unknown. They ask their agent: 'Find me VPs of Engineering at Series B SaaS companies in New York.' The agent runs `search_people`, filters the list by job title and location, and then uses multiple `lookup_person` calls to build a vetted contact list.

### Validating a competitor's leadership.
A sales manager hears about 'GlobalTech Inc.' but can't find their CTO. They ask the agent: 'Look up GlobalTech Inc.' The agent runs `lookup_company` to get core metadata, then uses that data in `search_people` to pinpoint the specific executive and run a `lookup_person` for their contact details.

### Building an automated lead pipeline.
The marketing team wants every time they update a lead list spreadsheet, it automatically triggers a check on that person's status. They use the agent to configure `create_webhook`, connecting the server’s data flow directly into their internal task management system.

### Reviewing outreach history for compliance.
An operations manager needs to prove which leads were looked up last month. They use the agent to run `list_recent_searches` and then check the full audit trail using `list_webhooks`, ensuring every action is logged and traceable.

## Benefits

- **Find verified emails on demand.** Instead of manually scraping LinkedIn, use the `lookup_person` tool to get a person's confirmed email and phone number immediately. It costs credit, but it saves hours of painful searching.
- **Research companies instantly.** Need to validate a target firm? Use `lookup_company` or `search_companies`. You retrieve structured metadata like domain names and employee counts right in the chat, not on a separate dashboard.
- **Keep track of your spending.** Never run out of leads because you forgot how many credits you had. The `get_credit_usage` tool shows your real-time usage so your campaigns stay optimized.
- **Automate data triggers.** Need to notify another system when a lead is found? Use `create_webhook`. This lets the server talk to your CRM or database without manual steps.
- **Manage large outreach lists.** If you're working with many prospects, use `list_recent_searches` to review what you already looked up. It keeps your entire research history centralized.

## How It Works

The bottom line is: Your AI agent handles complex B2B research tasks without you ever leaving your conversation window.

1. Subscribe to the server and provide your unique RocketReach API Key within your AI client's settings.
2. Your AI agent sends a natural language request, such as 'Find me contacts at Acme Corp.'
3. The server executes the necessary tools (e.g., `search_people` then `lookup_person`) and returns structured data to your chat.

## Frequently Asked Questions

**How do I use the lookup_person tool with RocketReach MCP Server?**
You ask your agent to run `lookup_person` and provide it with a LinkedIn URL or profile ID. The server consumes one credit and returns verified contact details.

**What is the difference between search_people and lookup_company using RocketReach MCP Server?**
`search_people` finds individual profiles based on criteria (like title/location). `lookup_company` gets detailed metadata about an organization, like its domain or employee count.

**Can I automate data flow with create_webhook using RocketReach MCP Server?**
Yes. You can use `create_webhook` to tell the server to send data (like a new lead's info) automatically to an external system every time it finds a match.

**How do I check my billing details with RocketReach MCP Server?**
Use the `get_billing_info` tool. It fetches your current financial standing, letting you manage budget concerns without logging into another system.

**How do I monitor my usage and track remaining credits using the `get_credit_usage` tool?**
It provides a real-time breakdown of your account's credit balance. You can see how many lookups you've performed, how many are remaining, and your overall spending history to keep outreach optimized.

**If I run an asynchronous lookup, what is the process for checking results with `check_lookup_status`?**
You pass the job ID from the initial request into `check_lookup_status`. This tool reports on the status of the data—whether it's still processing or if it completed successfully—so you don't have to wait in the chat.

**Can I use `list_recent_searches` to audit or review my previous professional searches?**
Yes, this tool retrieves a log of your last search requests. It helps you confirm which leads you've already checked, which is critical for maintaining data integrity across multiple sessions.

**What specific function does `search_companies` perform compared to using `lookup_company`?**
`search_companies` finds companies based on broad criteria like industry or employee count. `lookup_company`, conversely, requires a known domain or company name to pull the full, detailed profile.

**Can my AI automatically enrich a person's contact info using their LinkedIn URL?**
Yes! Use the `person_lookup` tool. Provide the `linkedin_url`, and your agent will return the verified email addresses and phone numbers associated with that professional profile instantly.

**How do I check how many RocketReach credits I have left?**
Simply ask the agent to run the `get_account_info` or `get_usage_stats` action. It will retrieve your current plan details and remaining search/lookup credits.

**How do I find my RocketReach API Key?**
Log in to your RocketReach account, navigate to **Account** > **API Usage & Settings**, and you will find your unique secret API key there.