Connect AI agents (MCP)

What is MCP

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools directly. Once connected, your AI agent can enrich profiles, search people and companies, and more, all through natural conversation.

ReverseContact exposes 8 tools via MCP. Same data, same credits, same rate limits as the REST API.

Prerequisites

• A ReverseContact account
• An MCP-compatible client (claude.ai, Cowork, Claude Desktop, Claude Code, ChatGPT, Codex, Cursor, etc.)

Two ways to authenticate:

• Sign in with your account (OAuth): clients with OAuth support (claude.ai, Cowork, Claude Desktop, Claude Code, mobile, ChatGPT) connect with no API key. The first connection opens your browser, you approve the access, and a dedicated API key named MCP - {app} is created in your workspace automatically.
• API key: every other client authenticates with an active API key (rc_*) in the Authorization header. Create one from API Keys.

Server details

Setup by client

For clients using an API key, replace rc_your_api_key with your actual key in the examples below.

Claude.ai, Claude Desktop, Cowork and mobile

ReverseContact is published in the Claude connector directory, so there is nothing to paste and no API key involved:

1. Open our page in the Claude connector directory.
2. Click Connect: your browser opens the ReverseContact consent page. Sign in if needed, pick the workspace shown, and approve.

The connector is then available in claude.ai chats, Claude Desktop, Cowork, Claude Code on the web and the mobile apps. To revoke it later, delete its MCP - {app} key from API Keys.

Prefer to add it by hand, or your organization restricts the directory? Open Settings > Connectors > Add custom connector, paste https://api.reversecontact.com/mcp as the URL, confirm, then click Connect and approve the same consent page.

Claude Code

Claude Code supports HTTP MCP servers natively. The fastest path is one command in your terminal, no API key needed:

claude mcp add --transport http reversecontact https://api.reversecontact.com/mcp

Then start a Claude Code session and run /mcp: select reversecontact and authenticate. Your browser opens the consent page, you approve, and the tools come online.

For headless or CI environments where the browser flow is not an option, pass an API key explicitly instead:

claude mcp add --transport http reversecontact \
  https://api.reversecontact.com/mcp \
  --header "Authorization: Bearer rc_your_api_key"

Alternatively, add a .mcp.json file at the root of your project to share the server with your team:

{
  "mcpServers": {
    "reversecontact": {
      "type": "http",
      "url": "https://api.reversecontact.com/mcp",
      "headers": {
        "Authorization": "Bearer rc_your_api_key"
      }
    }
  }
}

ChatGPT

ReverseContact is published in the ChatGPT plugin directory, so there is nothing to paste and no API key involved:

1. Open our page in the ChatGPT plugin directory.
2. Click Add: your browser opens the ReverseContact consent page. Sign in if needed, pick the workspace shown, and approve.

The connector is then available in ChatGPT. Enable it from the composer (plus menu) in any chat. To revoke it later, delete its MCP - {app} key from API Keys.

Prefer to add it by hand, or your organization restricts the directory? Enable Developer mode under Settings > Connectors > Advanced settings (paid ChatGPT plan: Plus, Pro, Business, Enterprise or Edu), then Create a connector: name it ReverseContact, paste https://api.reversecontact.com/mcp as the URL, keep Authentication on OAuth, and approve the same consent page.

Codex

The Codex CLI reads the bearer token from an environment variable, so the key never lands in a config file:

export RC_API_KEY="rc_your_api_key"
codex mcp add reversecontact \
  --url https://api.reversecontact.com/mcp \
  --bearer-token-env-var RC_API_KEY

Add the export line to your shell profile so the variable is set whenever Codex launches. This writes the server to ~/.codex/config.toml:

[mcp_servers.reversecontact]
url = "https://api.reversecontact.com/mcp"
bearer_token_env_var = "RC_API_KEY"

Cursor

Create a .cursor/mcp.json file at the root of your project. Cursor connects over HTTP natively, keyed on url (no type field):

{
  "mcpServers": {
    "reversecontact": {
      "url": "https://api.reversecontact.com/mcp",
      "headers": {
        "Authorization": "Bearer rc_your_api_key"
      }
    }
  }
}

Gemini CLI

Gemini CLI supports remote Streamable HTTP MCP servers. Add ReverseContact to ~/.gemini/settings.json for your user account, or .gemini/settings.json for one project:

{
  "mcpServers": {
    "reversecontact": {
      "httpUrl": "https://api.reversecontact.com/mcp",
      "headers": {
        "Authorization": "Bearer rc_your_api_key"
      }
    }
  }
}

Run gemini mcp list to check the connection. The Gemini app’s custom connector surface is separate and does not support this setup yet.

Other clients (mcp-remote)

Most clients that support HTTP MCP servers accept the same URL and Authorization: Bearer rc_your_api_key header through their own config format. If your MCP client only supports stdio transport, use mcp-remote as a bridge:

npx mcp-remote https://api.reversecontact.com/mcp \
  --header "Authorization: Bearer rc_your_api_key"

This works with any client that supports stdio-based MCP servers.

Available tools

Enrichment

Search

Utility (free)

Example prompts

Once the MCP server is connected, ask your AI agent in natural language. These examples map to the tools above and use the same credits as the REST API.

1. Enrich a person from an email

   Enrich the LinkedIn profile for [email protected] and summarize current title, company, and recent experience.

2. Enrich a company from a domain

   Look up the company for domain stripe.com and return industry, employee range, headquarters, and a one-paragraph description.

3. Search people with filters

   Find people who are Heads of Sales or VPs of Sales at SaaS companies in the United States. Return the first page of results with name, title, and company.

4. Search companies with filters

   Search for fintech companies with 50 to 200 employees headquartered in France. List name, domain, and size.

5. Check usage before a batch

   Check my ReverseContact credit balance and rate limit status before I run a larger enrichment batch.

6. Async live enrichment workflow

   Live-enrich the LinkedIn profile https://www.linkedin.com/in/example with enrich_person_live and, if the tool returns a task id, poll until the result is ready, then summarize the profile.

Tip: for live enrichments the agent receives a taskId from enrich_person_live or enrich_company_live and should call check_task until status is succeeded or errored. You usually do not need to manage that loop yourself.

Async workflow

The live tools (enrich_person_live, enrich_company_live) run asynchronously. They return a taskId instead of data:

{
  "taskId": "abc123",
  "status": "processing",
  "message": "Scraping LinkedIn profile. Poll with check_task in ~10 seconds."
}

Use check_task with the taskId to poll for results. Tasks typically complete in 10–60 seconds.

Status flow: in_progress → succeeded or errored

When succeeded, check_task returns the full data payload. Your AI agent handles this polling automatically. Just ask for what you need.

Credits and rate limits

MCP tools consume the same credits and respect the same rate limits as the REST API. That means:

• MCP calls use the same endpoint pricing as REST.
• MCP calls count toward the same gateway RPM limits as REST API calls.
• Agent LLM turns are different: they consume credits but do not affect gateway RPM until the Agent triggers a real tool call.

Use check_usage to inspect your current balance before expensive operations.

See Rate limits & credits for details on quotas and throttling.

Troubleshooting