MCP server - ReachHunt

The ReachHunt MCP server lets an AI app work in your workspace. Ask it to read your conversations, reply to a lead, build a lead list or start a campaign, and it does the work through your connected X and LinkedIn accounts. You connect by signing in to ReachHunt from your AI app. You don’t copy a key.

Server URL

Paste this URL into your AI app:

Server URL

https://mcp.reachhunt.ai/mcp

What your AI app can do

Area	What it can do
Workspace	See which workspace you’re connected to, your connected accounts and their sending limits, your credits, and an activity summary
Inbox	List and read conversations and message requests, mark them read, close and reopen them, and answer requests
Messages	Read, send and react to messages, and schedule or cancel scheduled messages
Conversation details	Set tags, status, notes, assignee and deal value, and add internal notes
Leads and lead lists	Search people on X and LinkedIn, create lead lists, add and import leads, and update a lead’s tags, status, note and value
Campaigns	Create and edit campaigns, start, pause, resume and stop them, and follow their targets and activity
AI agents	Create, train and publish agents, assign them to accounts, pause and resume them, and test them
Pipeline, templates, tags and statuses	Read your pipeline, and list and create templates, tags and statuses

An AI app can’t delete anything. Conversations, messages, lead lists, campaigns, agents, templates, tags and statuses stay in place. It can stop a campaign and cancel a scheduled message.

Before you start

An AI app that supports MCP, such as Claude, ChatGPT, Cursor or Claude Code.
Full access to every section of the ReachHunt workspace.
A workspace with an active plan.

Connect your AI app

Claude
ChatGPT
Cursor
Claude Code
Other apps

Open connectors

In Claude, on claude.ai or the desktop app, open Customize, then Connectors.

Add a custom connector

Select + Add, then Add custom connector.

Enter the details

Enter ReachHunt as the name, paste https://mcp.reachhunt.ai/mcp and select Continue.

Keep the sign-in settings

Keep the sign-in settings Claude suggests, select Continue, then select Add.

Connect

Select Connect next to ReachHunt. A ReachHunt page opens in your browser. Choose your workspace and select Connect.

Turn it on in a chat

In a chat, select +, open Connectors and turn on ReachHunt.

On a Team or Enterprise plan, an owner first adds ReachHunt in Organization settings → Connectors. Then each member selects Connect in Customize → Connectors.

Open settings

In ChatGPT, select your profile at the bottom left and open Settings.

Turn on developer mode

Open Apps, then Advanced settings, and turn on Developer mode.

Create an app

Go back to Apps and select Create app.

Enter the details

Enter ReachHunt as the name, paste https://mcp.reachhunt.ai/mcp as the MCP server URL, choose OAuth and select Create.

Connect

A ReachHunt page opens in your browser. Choose your workspace and select Connect.

Open your MCP file

Open ~/.cursor/mcp.json to connect every project, or .cursor/mcp.json inside one project. Create the file if it doesn’t exist.

Add ReachHunt

Paste this into the file and save it:

mcp.json

{
  "mcpServers": {
    "reachhunt": {
      "url": "https://mcp.reachhunt.ai/mcp"
    }
  }
}

In Cursor Settings, open MCP and select the sign-in button next to reachhunt. A ReachHunt page opens in your browser. Choose your workspace and select Connect.

Add the server

Run this in your terminal:

claude mcp add --transport http reachhunt https://mcp.reachhunt.ai/mcp

Authenticate

Start Claude Code, type /mcp, choose reachhunt and select Authenticate.

Connect

A ReachHunt page opens in your browser. Choose your workspace and select Connect.

Open the config file

Open your app’s MCP config file. For Claude Desktop, it is here:

System	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Add ReachHunt

Paste this into the file and save it. It needs Node.js on your computer:

claude_desktop_config.json

{
  "mcpServers": {
    "reachhunt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.reachhunt.ai/mcp"]
    }
  }
}

Restart and connect

Restart the app. A ReachHunt page opens in your browser. Choose your workspace and select Connect.

What happens when you connect

The ReachHunt page that opens shows the app’s name and a workspace picker. Select Connect to approve. The app can then read and act in that workspace, including sending messages from its accounts. Each app you connect gets its own API key, named after the app with (MCP) after it. You can see it in Settings → API. To check that it works, ask your AI app: “Which ReachHunt workspace am I connected to?”

Limits

Tools that only read data are marked read-only, so your AI app can run them without asking. Tools that change data, send messages or reach real people are marked as such, so your AI app can ask you first.
List tools return 20 items unless your AI app asks for more.
A result longer than 60,000 characters is cut off.
The connection acts as the workspace owner, with full access to the workspace.

Disconnect an app

Delete the app’s key in Settings → API. The app loses access right away, and its tools answer that access was removed. If you connect the same app again, ReachHunt replaces its earlier connection and revokes the old key.

Troubleshooting

You see	What to do
You need full access to this workspace to connect an app	Choose another workspace, or ask its owner for full access
This workspace has no active plan	Choose another workspace, or renew the plan
This request has expired	Go back to your AI app and start connecting again
Your session ended	Log in to ReachHunt again, then connect
You are not in a workspace yet	Create a workspace in ReachHunt, then connect again

​Server URL

​What your AI app can do

​Before you start

​Connect your AI app

​What happens when you connect

​Limits

​Disconnect an app

​Troubleshooting

Server URL

What your AI app can do

Before you start

Connect your AI app

What happens when you connect

Limits

Disconnect an app

Troubleshooting