Developer docs: MCP server

Ask your calls from Claude, ChatGPT, Cursor and more.

MCP (Model Context Protocol) is the standard way for AI assistants to use outside tools. Connect the ListenFox MCP server and your assistant can look up calls, callers and follow-ups, and answer questions from them.

What it does

Once it’s connected, you can ask your assistant things like:

  • “Which hot leads from this week still don’t have a follow-up?”
  • “Why did conversions drop last month compared with the month before?”
  • “Pull the evidence on yesterday’s call from +1 512 555 0143 for a dispute.”
  • “Create a follow-up to call Maria back on Thursday.”

The assistant picks the right tools, and every answer links back to the calls in ListenFox.

Server address

MCP server URL
https://listenfox.com/api/mcp

It uses the streamable HTTP transport. Most apps sign in with OAuth: you log in to ListenFox, pick the workspace, choose what the assistant may do, and click Allow.

Anyone in a workspace can connect an app with Read only, and it sees the same calls they do; Automations and Full need an admin. Apps that can’t sign in can send an API key instead, in the Authorization: Bearer header. See Authentication.

Add it to your app

Ask Claude, ChatGPT and other AI apps about your calls. Each app asks you to sign in to ListenFox and choose what it can see.

Cursor (opens in a new tab)VS Code
More apps: Grok, Hermes Agent, OpenClaw, Codex, Gemini CLI and 7 more
  • GrokThe address and a link to Grok’s connectors.
  • Hermes AgentOpens the Hermes app, or copy a command.Add to Hermes Agent
  • OpenClawA command for the openclaw CLI.
  • CodexA command for the Codex CLI.
  • Gemini CLIA command for Gemini CLI.
  • WindsurfNow Devin Desktop. A command or a config.
  • GooseOpens Goose Desktop and adds it.Add to Goose
  • LM StudioA config with an API key.
  • ZedThe address for Zed’s MCP settings.
  • RaycastThe address for Install MCP Server.
  • PerplexityThe address for a custom connector.
  • Copilot StudioThe address for a Microsoft Copilot Studio agent.

Zapier, Make and n8n apps are coming soon. Until then, connect them with an API key.

Claude and ChatGPT

Both add the server in their own settings: Claude as a custom connector, ChatGPT as a custom MCP server on Business, Enterprise and Edu. Each signs in with OAuth. The click-by-click steps, and which plans allow it, are in the help article Connect ListenFox to Claude, ChatGPT and other AI apps.

Menu names change. Claude’s guide to custom connectors and OpenAI’s guide to custom MCP servers have the latest steps.

Cursor

Add ListenFox to ~/.cursor/mcp.json (for all projects) or .cursor/mcp.json in one project. Cursor asks you to sign in the first time it uses a tool.

mcp.json
{
  "mcpServers": {
    "listenfox": {
      "url": "https://listenfox.com/api/mcp"
    }
  }
}

To use an API key instead of signing in, add a header:

mcp.json
{
  "mcpServers": {
    "listenfox": {
      "url": "https://listenfox.com/api/mcp",
      "headers": {
        "Authorization": "Bearer lf_live_..."
      }
    }
  }
}

Claude Code

Terminal
claude mcp add --transport http listenfox https://listenfox.com/api/mcp

Then type /mcp in Claude Code, pick listenfox and sign in. To use an API key instead:

Terminal
claude mcp add --transport http listenfox https://listenfox.com/api/mcp \
  --header "Authorization: Bearer $LISTENFOX_API_KEY"

Other apps

Each of these can use a remote MCP server and sign in with OAuth, except LM Studio, which needs an API key. Checked October 2026; menu names change, so each app’s own docs have the latest steps.

AppHow to add ListenFox
GrokOn grok.com/connectors, click New Connector, then Custom, and paste the address. On Business and Enterprise, an admin adds it first.
Hermes AgentClick Add next to Hermes Agent under More apps to open the desktop app, or run hermes mcp add listenfox --url https://listenfox.com/api/mcp --auth oauth.
OpenClawRun openclaw mcp add listenfox --url https://listenfox.com/api/mcp --transport streamable-http --auth oauth, then openclaw mcp login listenfox. Or, in the Control UI, go to Settings → MCP → Add server.
CodexRun codex mcp add listenfox --url https://listenfox.com/api/mcp. Codex opens your browser to sign in; if it doesn’t, run codex mcp login listenfox.
Gemini CLIRun gemini mcp add --transport http -s user listenfox https://listenfox.com/api/mcp. It signs in the first time it uses ListenFox; /mcp auth listenfox signs in again.
Windsurf (Devin Desktop)For Devin Local, run devin mcp add -s user listenfox https://listenfox.com/api/mcp, then devin mcp login listenfox. For Cascade, add "listenfox": {"serverUrl": "https://listenfox.com/api/mcp"} under mcpServers in ~/.config/devin/mcp_config.json.
GooseClick Add next to Goose under More apps to open Goose Desktop, or in the CLI run goose configure → Add Extension → Remote Extension (Streamable HTTP).
LM StudioIn the Program tab, choose Install → Edit mcp.json and paste the API key config under Any MCP app.
ZedOpen Settings → AI → MCP Servers, click Add Server, then Add Remote Server, and paste the address.
RaycastRun Install MCP Server, choose HTTP, paste the address and set OAuth to Dynamic.
PerplexityOpen Settings → Connectors, click + Custom connector, choose Remote, paste the address and choose OAuth.
Microsoft Copilot StudioIn your agent, open Tools → Add a tool → New tool → Model Context Protocol, paste the address and choose OAuth 2.0, then Dynamic discovery.

Any MCP app

Any app that supports remote MCP servers over streamable HTTP works the same way: give it the address, and it asks you to sign in the first time it uses ListenFox. Most apps take a config like this:

mcp.json
{
  "mcpServers": {
    "listenfox": {
      "url": "https://listenfox.com/api/mcp"
    }
  }
}

Some apps want the transport named:

mcp.json
{
  "mcpServers": {
    "listenfox": {
      "type": "http",
      "url": "https://listenfox.com/api/mcp"
    }
  }
}

If the app can’t sign in with OAuth, create a key under Settings → API keys and send it in a header. X-API-Key: YOUR_API_KEY works too.

mcp.json
{
  "mcpServers": {
    "listenfox": {
      "url": "https://listenfox.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tools

Each tool needs a scope. If you allowed the Read only preset, the assistant can look but can’t change anything or spend credits.

ToolWhat it doesKindScope
search_callsFinds calls by date, caller, source, lead band, outcome or words said.Readscalls:read
get_callOne call: summary, findings, key moments and a shortened transcript.Readscalls:read
find_contactFinds a caller by phone number, email or name.Readscontacts:read
get_contactOne caller with their lead card and recent calls.Readscontacts:read
list_followupsOpen or done follow-ups, soonest due first.Readsfollowups:read
get_metricsCalls, hot leads, orders and conversion for a period, compared with the one before.Readsinsights:read
top_objectionsThe objections callers raised most.Readsinsights:read
unmet_demandWhat callers asked for that you don’t offer.Readsinsights:read
agent_scorecardsCalls and scores per person who answers your phones.Readsinsights:read
ask_callsAsks a question across your calls, the same as Ask in the app, with links to the moments.Uses creditsask
analyze_callAnalyzes a call that hasn’t been analyzed yet, such as one imported without analysis.Uses creditsanalyze
create_followupAdds a follow-up to a call or a caller.Changes datafollowups:write
complete_followupMarks a follow-up as done.Changes datafollowups:write
label_callAdds or removes labels on a call.Changes datacalls:write
update_contactChanges a caller’s name, email, status or custom fields.Changes datacontacts:write

Prompts

Prompts are ready-made requests your assistant can offer you, usually from a menu or by typing /.

  • weekly_brief: the last 7 days in a page. Calls, hot leads, what changed and what to do next.
  • why_conversions_changed: compares this period with the one before and looks for the reasons in the calls.
  • dispute_pack: for one call, gathers the evidence you need to dispute it with a buyer or publisher: outcome, key moments and the exact lines.

What the assistant can and can’t do

  • It sees only the workspace you chose when you connected, and only what your chosen preset allows.
  • It acts as you, with your current role. If you’re removed from the workspace, the connection stops working.
  • Tools that change data or use credits are marked as such, so your assistant can ask you before it uses them.
  • It can’t delete anything, and it can’t change what ListenFox found in a call.
  • Long transcripts are shortened in answers. The assistant gets a link to open the full call in ListenFox.
  • To cut it off, disconnect it in ListenFox under Settings → Connected apps, or remove the connector in your assistant.