Connect to Retreaver MCP
Connect an AI assistant to your Retreaver account with one URL:
https://ai.retreaver.com/mcp
claude mcp add --transport http retreaver https://ai.retreaver.com/mcpcodex mcp add retreaver --url https://ai.retreaver.com/mcp
codex mcp login retreaver{
"mcpServers": {
"retreaver": {
"url": "https://ai.retreaver.com/mcp"
}
}
}{
"servers": {
"retreaver": {
"type": "http",
"url": "https://ai.retreaver.com/mcp"
}
}
}gemini mcp add --transport http retreaver https://ai.retreaver.com/mcp{
"mcpServers": {
"retreaver": {
"url": "https://ai.retreaver.com/mcp"
}
}
}Using Claude or ChatGPT on desktop or the web? Those are set up in the app, not with a command - jump to Claude or ChatGPT.
The first time your assistant uses the server, it opens a browser to sign you in to Retreaver. Authentication is OAuth: there is no key to generate, paste, or rotate.
Important
Switch into the right company before you approve. The connection binds to whichever company you’re signed into when you click Approve — the consent screen does not ask you to pick one. See MCP Authentication.
Prefer to let your agent do it? Paste this into a coding agent:
Add the Retreaver MCP server to this agent. It is a remote MCP server at
https://ai.retreaver.com/mcp (streamable HTTP, OAuth). Follow the setup guide at
https://learn.retreaver.com/guides/install-mcp-server.md, then start the sign-in
flow so I can approve it in my browser.
Before you start
- You’re an owner, superuser, or Retreaver admin on the company you want to connect. Collaborators can’t create an MCP connection.
- Your AI assistant supports remote MCP servers. Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, and most current clients do.
The Retreaver MCP server lets the assistant read campaigns, buyers, caller lists, and call reporting, and — if you allow it — make changes. Start with a read-only grant and keep your client’s tool-approval prompts on until you trust what it does.
Warning
First release. We ship to this constantly and may take it down briefly, without much notice. Don’t build a mission-critical flow on it yet.
Set up your client
Client menus move around. These steps were checked against each client’s own documentation in November 2026.
Claude Code
claude mcp add --transport http retreaver https://ai.retreaver.com/mcpBy default that adds Retreaver to the current project only. Add --scope user
to have it in every project:
claude mcp add --transport http retreaver --scope user https://ai.retreaver.com/mcpThen start Claude Code and run /mcp. Pick retreaver, choose
Authenticate, and finish the sign-in in your browser.

claude mcp list shows the connection state — ✔ Connected means you’re done.
Claude Desktop, Claude on the web, and Cowork
Retreaver isn’t in Claude’s Connectors Directory yet — we plan to publish there soon — so for now you add it as a custom connector. Custom connectors work on every plan; Free plans allow one.
Individual plans
- Open Customize → Connectors (or claude.ai/settings/connectors).
- Click + Add → Add custom connector.
- Name it Retreaver and paste the server URL:
https://ai.retreaver.com/mcpSwipe horizontally for full code - Click Continue. Keep the suggested sign-in and OAuth client options — Retreaver registers the client automatically — then click Add.
- Complete the Retreaver sign-in.
- In a chat, use + → Connectors and enable Retreaver for that conversation.
Team and Enterprise
An Owner adds the connector once; each member then connects as themselves.
- Owner: Organization settings → Connectors → Add → Custom → Web, paste
https://ai.retreaver.com/mcp, click Add. - Each member: Customize → Connectors, find Retreaver, click Connect, and complete the Retreaver sign-in.
The connector is shared. The access is per person, bound to the company that person is signed into when they approve.
ChatGPT
Retreaver isn’t in ChatGPT’s plugin directory yet — we plan to publish there soon — so for now you add it as a custom MCP server. This works in ChatGPT on the web.
- Go to chatgpt.com/plugins and click + → Add custom MCP server.
- Name it Retreaver and paste the server URL:
https://ai.retreaver.com/mcpSwipe horizontally for full code - Choose OAuth as the authentication method.
- Tick I understand and want to continue, then click Create as a plugin.
- Install it and complete the Retreaver sign-in when prompted.
- In a new chat, type
@and pick Retreaver.
If you don’t see Add custom MCP server, custom servers are switched off for your account or workspace: turn on Developer mode in ChatGPT’s settings, or ask your workspace admin to allow it.
Write tools in ChatGPT ask for confirmation before they run. Start with a read-only Retreaver grant anyway — see MCP Authentication.
Codex
codex mcp add retreaver --url https://ai.retreaver.com/mcp
codex mcp login retreaverThe second command opens the browser sign-in. The Codex CLI, IDE extension, and desktop app share this configuration.
Cursor
Add Retreaver to Cursor — one click, then confirm in Cursor.
Or add it yourself to ~/.cursor/mcp.json (or the project’s
.cursor/mcp.json):
{
"mcpServers": {
"retreaver": {
"url": "https://ai.retreaver.com/mcp"
}
}
}Then open Settings → MCP and click Connect (or Login) next to Retreaver to authorize it.
VS Code
Add Retreaver to VS Code — one click, then review and install.
Or add it yourself to the workspace .vscode/mcp.json:
{
"servers": {
"retreaver": {
"type": "http",
"url": "https://ai.retreaver.com/mcp"
}
}
}VS Code prompts you to sign in the first time the server is used. You can also use Command Palette → MCP: Add Server → HTTP and paste the same URL.
Gemini CLI
gemini mcp add --transport http retreaver https://ai.retreaver.com/mcpThen start Gemini CLI and run /mcp auth retreaver to sign in.
Any other MCP client
Most clients — Zed, Windsurf, and others — take a name and a URL:
{
"mcpServers": {
"retreaver": {
"url": "https://ai.retreaver.com/mcp"
}
}
}If your client asks for a transport, choose streamable HTTP (some clients
spell it http, others streamable-http). If it asks for an authentication
method, choose OAuth — Retreaver registers your client automatically.
Only if your client can’t connect to remote servers at all, bridge to the endpoint with a local process:
npx -y mcp-remote https://ai.retreaver.com/mcpConfirm it worked
Ask your assistant:
“Which Retreaver company am I connected to, and what can I do?”
That runs account.whoami, which reports the company the connection is bound
to, who you’re acting as, your role, and the access level you approved:
{
"company": { "id": 47291, "name": "Advance Client Solutions LLC" },
"user": { "name": "Jane Operator", "email": "jane@example.com" },
"role": "owner",
"scopes": ["mcp:basic", "mcp:operations:read", "mcp:operations:manage"]
}Read the company name before you ask for anything else — especially if you manage more than one. That line is which account the assistant is about to act on.
Try your first questions
Start with reads. They’re safe, and they show you what the assistant can see:
- “How many calls came in yesterday, broken down by buyer?”
- “Show me the routing settings and active buyers for the Auto Insurance campaign.”
- “List my paused buyers.”
When you’re ready to change something, ask for a preview first:
“Add a buyer called Sunrise Insurance to the Auto Insurance campaign and cap it at 50 concurrent calls — show me a dry run first.”
More ideas in MCP Use Cases.
Troubleshooting
| What you see | What it means | What to do |
|---|---|---|
| “Only an admin, owner, or superuser on this company can connect it to an MCP client.” | Your role on the company you’re currently signed into is too low. | Switch to a company where you’re an owner or superuser, or ask an owner to grant you access. |
| “You must be signed in with a normal web session to connect an MCP client.” | You aren’t signed into retreaver.com in that browser, or the client tried to authenticate with an API key. | Sign in at retreaver.com in the same browser, then retry. |
| “You’re signed in as another user through an admin (‘become’) session.” | Retreaver admins can’t mint a connection while impersonating someone. | Leave the become session and connect as yourself. |
| The assistant reports the wrong company | The connection was approved while you were switched into a different company. | Switch company in Retreaver, then re-authenticate. See MCP Authentication. |
| “MCP is temporarily disabled” (HTTP 503) | We’ve taken the server down briefly — see the warning at the top of this page. | Try again in a few minutes. |
tool_call_limit_exceeded |
A single long session hit the per-connection call cap. | Start a fresh chat with your assistant. |
| The assistant doesn’t know about a tool you read about | Assistants load the tool list when a session starts and hold it for that session. | Start a new session — it reconnects and picks up everything new. |
Next steps
- MCP Authentication and Switching Companies — one connection maps to one company, who can connect, and how to switch.
- MCP Use Cases — prompts that work well.
Help us improve this article or request new support guides.