Connect ReachRobin to your AI tool
ReachRobin exposes an MCP (Model Context Protocol) endpoint so any compatible AI tool - Claude Code, ChatGPT, Claude Desktop, Cursor, Windsurf, or your own agent - can read your data and act on your behalf. Below is everything you need to plug it in.
https://mcp.reachrobin.com/api/mcp(Old endpoint https://app.reachrobin.com/api/mcp works during transition, 4-6 weeks.)1. Create a token
Sign in to ReachRobin and go to Settings → MCP tokens. Click New token, give it a label, and hit Create. The raw token is shown exactly once. Copy it before closing the dialog.
2. Paste into your AI tool
Right after creation, we show two ready-to-paste JSON snippets — pick the one that matches your tool. Tokens are prefixed rr_mcp_.
Claude Code (one-liner CLI — easiest)
If you use the Claude Code CLI, skip the JSON. Run:
claude mcp add --transport http reachrobin \ https://mcp.reachrobin.com/api/mcp \ --header "Authorization: Bearer YOUR_TOKEN"
ChatGPT (custom connector)
In ChatGPT, open Settings → Connectors → Add custom connector. Paste https://mcp.reachrobin.com/api/mcp as the URL and Bearer YOUR_TOKEN as the authorization header. No JSON editing required.
Cursor / Windsurf / Claude Code .mcp.json
Native Streamable-HTTP clients. Drop this into ~/.cursor/mcp.json, project-level .cursor/mcp.json, or .mcp.json for Claude Code. The type: "http" field is required by Claude Code (Cursor accepts it harmlessly):
{
"mcpServers": {
"reachrobin": {
"type": "http",
"url": "https://mcp.reachrobin.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}Claude Desktop
Claude Desktop’s claude_desktop_config.json is stdio-only — it does not accept a bare url field for remote servers. To reach ReachRobin from the desktop app you bridge through the mcp-remote npm package, which runs locally as a stdio MCP server and proxies to our HTTPS endpoint. You need Node.js installed:
{
"mcpServers": {
"reachrobin": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.reachrobin.com/api/mcp",
"--header",
"Authorization:Bearer YOUR_TOKEN"
]
}
}
}Note the colon-without-space in Authorization:Bearer — spaces inside argsaren’t always escaped by Claude Desktop.
Alternatively, if you use claude.ai in the browser, add ReachRobin as a Custom Connector under Settings → Connectors — point it at https://mcp.reachrobin.com/api/mcp and paste the token when prompted; no JSON editing required.
Restart the AI tool after saving. You should see the ReachRobin tools appear in its tool list. So far we’ve verified the Cursor snippet against Cursor v1.0+ and the Claude Desktop snippet via mcp-remote; other clients (Windsurf, Zed, custom agents) generally accept one of these two shapes.
3. Available tools
Your token has access to 50tools, grouped by domain. Every tool respects your plan limits and role — if your AI tries something you don’t have permission for, you’ll get a clear error back.
Identity
whoamiIdentity echo
Outreach campaigns
add_clients_to_campaignAdd clients (companies) to a campaignarchive_outreach_campaignArchive (delete) an outreach campaigncreate_outreach_campaignCreate an outreach campaignget_outreach_campaignGet an outreach campaignget_outreach_campaign_clientsList enrolled companies in a campaignget_outreach_campaign_pending_recommendationsList AI drafts awaiting approval in a campaignget_outreach_campaign_progressGet campaign enrichment + sequence progressget_outreach_campaign_timelineGet campaign event timelinelist_outreach_campaignsList outreach campaignspause_outreach_campaignPause an outreach campaignremove_clients_from_campaignRemove clients from a campaignresume_outreach_campaignResume an outreach campaignset_campaign_sequenceSwap the sequence template of a campaign (requires feature.sequencing.ui)trigger_campaign_enrichmentForce-refresh enrichment for a campaignupdate_outreach_campaignUpdate name / brand of an outreach campaign
Prospect campaigns
get_prospect_campaignGet a prospect campaignlist_prospect_campaignsList prospect-research campaignslist_prospect_leadsList prospect leads in a campaignlist_prospect_to_outreach_candidatesList prospect leads ready to convert
Clients
get_clientGet a clientget_client_activityGet a client activity feedlist_clientsList clients/prospectslist_recommendations_historyList the user message recommendations history
LinkedIn accounts
get_linkedin_account_healthGet LinkedIn account health and recent eventslist_linkedin_accountsList connected LinkedIn accounts
Brands & sequences
get_brandGet a brand profileget_brand_sequenceGet the default sequence for a brand (requires feature.sequencing.ui)get_sequenceGet a sequence detail (requires feature.sequencing.ui)list_brandsList brand profileslist_sequencesList sequences (requires feature.sequencing.ui)
Conversations & messaging
approve_pending_recommendationApprove and send an AI-drafted DMget_conversationGet a conversation threadlist_conversationsList inbox conversationssend_dmSend a DM in an existing LinkedIn conversation
Plan & usage
get_plan_infoGet current plan + entitlementsget_rate_limit_statusGet current rate-limit usagelist_top_upsList top-up history
Other
canvas_archiveMCP: archive a campaign canvascanvas_attach_channelMCP: attach a LinkedIn channel to a canvascanvas_attach_sourceMCP: attach an audience source to a canvascanvas_commitMCP: commit a new canvas definitioncanvas_create_from_briefMCP: create a campaign canvas from a briefcanvas_getMCP: read a campaign canvascanvas_get_historyMCP: get campaign canvas event historycanvas_get_statsMCP: get campaign canvas statscanvas_launchMCP: launch a campaign canvascanvas_listMCP: list campaign canvasescanvas_pauseMCP: pause a campaign canvascanvas_resumeMCP: resume a paused campaign canvas
Limits
- 200 requests per minute per token (shared with all tool calls).
- 80 direct messages per day across your LinkedIn accounts.
- 40 enrichment calls per day (applies to AI recommendations and campaign enrichment).
- Invitations are not sent directly via MCP. They flow through campaign automation, which is capped at 100 new invitations per LinkedIn account per week.
When you hit a limit the tool returns 429 with a resetAt timestamp. Your AI can wait and retry automatically.
Privacy & security
- Tokens are scoped to your organization. A token issued by you can only read or modify data your own login can see.
- We store only a hash of the token — the raw value is shown once at creation and is unrecoverable afterwards. Lose it? Revoke and create a new one.
- Tokens expire after 90 days.You’ll see the expiry date on the tokens list; rotate before then.
- Revoke any token instantly from the tokens page in Settings. Revocation takes effect on the next authenticated request — typically within a few minutes.
- Every MCP call is logged with the token id, tool name, status, and duration. If you suspect a compromised token, revoke it immediately and contact support.