> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reachhunt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Use ReachHunt inside Claude, ChatGPT, Cursor and other AI apps

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:

```txt Server URL icon="link" theme={"system"}
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**

**1. Open connectors**

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

**2. Add a custom connector**

Select **+ Add**, then **Add custom connector**.

**3. Enter the details**

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

**4. Keep the sign-in settings**

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

**5. Connect**

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

**6. Turn it on in a chat**

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

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

**ChatGPT**

**1. Open settings**

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

**2. Turn on developer mode**

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

**3. Create an app**

Go back to **Apps** and select **Create app**.

**4. Enter the details**

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

**5. Connect**

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

**Cursor**

**1. 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.

**2. Add ReachHunt**

Paste this into the file and save it:

```json mcp.json theme={"system"}
{
  "mcpServers": {
    "reachhunt": {
      "url": "https://mcp.reachhunt.ai/mcp"
    }
  }
}
```

**3. Sign in**

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**.

**Claude Code**

**1. Add the server**

Run this in your terminal:

```bash theme={"system"}
claude mcp add --transport http reachhunt https://mcp.reachhunt.ai/mcp
```

**2. Authenticate**

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

**3. Connect**

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

**Other apps**

**1. 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` |

**2. Add ReachHunt**

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

```json claude_desktop_config.json theme={"system"}
{
  "mcpServers": {
    "reachhunt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.reachhunt.ai/mcp"]
    }
  }
}
```

**3. 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**](https://app.reachhunt.ai/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**](https://app.reachhunt.ai/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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.