# LeadReef MCP server: connect LeadReef to Claude, ChatGPT and other AI apps

> LeadReef (https://leadreef.ai) runs a remote MCP server. Claude, ChatGPT, Cursor and any other MCP client can search for local businesses with no website or a weak one, and read the leads, contacts and account balance, after the user signs in on leadreef.ai and approves the app.

Canonical page: https://leadreef.ai/mcp
Last updated: 2026-11-06
Technical reference (auth, limits, errors, all 9 tools): https://leadreef.ai/mcp/docs (Markdown: https://leadreef.ai/mcp/docs.md)

Server URL: https://api.leadreef.ai/mcp

## What you can do

- **Scan a city.** Pick any city and niche. Get businesses with no site or a weak one, scored and ranked. Example: "Find hair salons in Denver with no website."
- **Work your saved leads.** Filter and sort leads from past searches without opening the app. Example: "Which Lisbon leads have a 4.5+ rating?"
- **Pull contacts.** Phone, email, address and what is wrong with their site, ready for the AI to write the pitch. Example: "Write a cold email to the top 3."
- **Check your credits.** See your plan and how many credits are left before running a big search. Example: "How many searches can I still run?"

## Pricing

- Available on every LeadReef plan, including Free. No extra plan or fee.
- Reading leads, contacts and the account is free.
- A search costs the same credits as in the LeadReef app, from 2 credits, from the same balance. The free plan gets 1 search a day.
- Plans: https://leadreef.ai/pricing

## Connect your app

- [Claude](https://leadreef.ai/mcp/claude) — step-by-step guide
- [ChatGPT](https://leadreef.ai/mcp/chatgpt) — step-by-step guide
- [Cursor](https://leadreef.ai/mcp/cursor) — step-by-step guide

### Claude

Claude.ai and the Claude desktop app, on every plan. Free includes one custom connector.

1. **Open Customize → Connectors.** In Claude, open Customize, then Connectors.
2. **Click + Add → “Add custom connector”.** Name it LeadReef and paste the server URL.
3. **Sign in to LeadReef and click Allow.** A LeadReef window shows exactly what Claude will be able to do.
4. **Turn LeadReef on in a chat.** Click + at the lower left of the message box → Connectors, then ask for leads.

Server URL:

```
https://api.leadreef.ai/mcp
```

### ChatGPT

ChatGPT on the web. Custom MCP servers are not available in the mobile apps.

1. **Open ChatGPT Plugins.** Go to chatgpt.com/plugins and click +, then “Add custom MCP server”.
2. **Paste the server URL.** Name it LeadReef, paste the URL under Connection, choose OAuth, then “Create as a plugin”.
3. **Sign in to LeadReef and click Allow.** You come back to ChatGPT once it is connected.
4. **Pick LeadReef in a chat.** Type @ in the message box, choose LeadReef, then ask for leads.

Server URL:

```
https://api.leadreef.ai/mcp
```

### Mistral Vibe

Mistral Vibe (formerly Le Chat), in Work.

1. **Open Work → Connectors.** In Mistral Vibe, open the Connectors page.
2. **+ Add Connector → Custom MCP Connector.** Name it leadreef, paste the server URL, click Connect.
3. **Sign in to LeadReef and click Allow.** Vibe detects the sign-in method on its own.
4. **Ask for leads.** Use the connector in a Work chat.

Server URL:

```
https://api.leadreef.ai/mcp
```

### Claude Code

Anthropic's coding agent in your terminal.

1. **Add the server.** Run the command below in your terminal.
2. **Open the MCP menu.** Start Claude Code and type /mcp.
3. **Authenticate.** Pick leadreef → Authenticate. Your browser opens LeadReef.
4. **Approve and ask.** Click Allow, go back to the terminal and ask for leads.

Terminal:

```
claude mcp add --transport http leadreef https://api.leadreef.ai/mcp
```

### Cursor

Cursor agent, in any project.

1. **Open Customize → MCP servers.** Add a custom MCP server. It opens mcp.json.
2. **Paste the block below.** Save the file. leadreef appears in the server list.
3. **Sign in when asked.** Cursor opens LeadReef in your browser.
4. **Approve and ask.** Click Allow, then ask the agent for leads.

~/.cursor/mcp.json:

```
{
  "mcpServers": {
    "leadreef": {
      "url": "https://api.leadreef.ai/mcp"
    }
  }
}
```

### VS Code

GitHub Copilot agent mode in VS Code.

1. **Add the server.** Command Palette → “MCP: Add Server” → HTTP, or paste the block below.
2. **Start it.** Save mcp.json. VS Code starts the server when the agent needs it.
3. **Sign in when asked.** VS Code opens LeadReef in your browser. Click Allow.
4. **Ask the agent.** Open Copilot Chat and ask for leads.

.vscode/mcp.json:

```
{
  "servers": {
    "leadreef": {
      "type": "http",
      "url": "https://api.leadreef.ai/mcp"
    }
  }
}
```

### Devin Desktop

Devin Desktop (formerly Windsurf), Devin Local agent.

1. **Add the server.** Run the commands below, or Customize → MCPs → open the config and paste the block.
2. **Authenticate.** leadreef shows “Needs authentication”. Click Authenticate.
3. **Approve in the browser.** Your browser opens LeadReef. Click Allow.
4. **Ask Devin.** LeadReef tools show up in the MCP list.

Terminal:

```
devin mcp add leadreef https://api.leadreef.ai/mcp
devin mcp login leadreef
```

~/.config/devin/mcp_config.json:

```
{
  "mcpServers": {
    "leadreef": {
      "url": "https://api.leadreef.ai/mcp"
    }
  }
}
```

### Gemini CLI

Google's open-source agent in your terminal.

1. **Add the server.** Paste the block into your settings file.
2. **Authenticate.** Start gemini and run the command below.
3. **Approve in the browser.** Click Allow on the LeadReef page.
4. **Ask for leads.** Type /mcp to check the tools are listed.

~/.gemini/settings.json:

```
{
  "mcpServers": {
    "leadreef": {
      "httpUrl": "https://api.leadreef.ai/mcp"
    }
  }
}
```

Inside Gemini CLI:

```
/mcp auth leadreef
```

### Codex

OpenAI Codex CLI and IDE extension.

1. **Add the server.** Paste the block into your Codex config.
2. **Log in.** Run the command below. Your browser opens LeadReef.
3. **Approve.** Click Allow.
4. **Ask for leads.** Start codex and ask.

~/.codex/config.toml:

```
[mcp_servers.leadreef]
url = "https://api.leadreef.ai/mcp"
```

Terminal:

```
codex mcp login leadreef
```

## Example prompts

- "Find 20 dentists in Austin with no website and rank them by how much they need one." (1 search)
- "Show my leads from the Lisbon search that have a phone number." (free)
- "Take the top 5 restaurants from my Manchester search and write each a 3-line cold email." (free)
- "Which of my saved leads have 4.5+ stars on Google but no site?" (free)
- "Get the email and phone for Bella Vista Trattoria." (free)
- "How many credits do I have left this month?" (free)

## Security

- **Sign-in happens on LeadReef.** The AI app never sees your password. You sign in on leadreef.ai and approve the app there.
- **Read and search only.** Apps can read leads and run searches. They cannot send messages, delete data or touch billing.
- **One click to disconnect.** Settings → Connected apps lists every app with last use. Disconnect cuts access immediately.

## FAQ

### What is MCP?

Model Context Protocol is an open standard that lets AI apps use tools from other services. LeadReef runs an MCP server, so any MCP client can search for leads and read your account after you allow them.

### Do I need a paid AI plan?

Depends on the app. Claude works on every plan (Free gets one custom connector). ChatGPT needs Business, Enterprise or Edu for full access, Pro gets read-only tools. Mistral Vibe, Cursor, VS Code, Devin Desktop, Gemini CLI and Codex let you add MCP servers on their regular plans.

### Does it cost anything extra?

No. Reading your leads, contacts and balance is free. Searches use the same credits as in LeadReef, from the same balance. The free plan gets 1 search a day here too.

### Can the AI send emails or change my account?

No. A connected app can see your searches, leads, contacts, plan and credit balance, and run searches. It cannot send messages, delete leads, change billing or publish sites.

### How do I disconnect an app?

Go to Settings → Connected apps in LeadReef and click Disconnect. The app loses access right away.

### Which apps work?

Claude, ChatGPT, Mistral Vibe, Claude Code, Cursor, VS Code with Copilot, Devin Desktop (formerly Windsurf), Gemini CLI, Codex, and any other client that supports remote MCP servers with OAuth sign-in.