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
https://listenfox.com/api/mcpIt 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.
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.
{
"mcpServers": {
"listenfox": {
"url": "https://listenfox.com/api/mcp"
}
}
}To use an API key instead of signing in, add a header:
{
"mcpServers": {
"listenfox": {
"url": "https://listenfox.com/api/mcp",
"headers": {
"Authorization": "Bearer lf_live_..."
}
}
}
}Claude Code
claude mcp add --transport http listenfox https://listenfox.com/api/mcpThen type /mcp in Claude Code, pick listenfox and sign in. To use an API key instead:
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.
| App | How to add ListenFox |
|---|---|
| Grok | On grok.com/connectors, click New Connector, then Custom, and paste the address. On Business and Enterprise, an admin adds it first. |
| Hermes Agent | Click 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. |
| OpenClaw | Run 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. |
| Codex | Run 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 CLI | Run 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. |
| Goose | Click 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 Studio | In the Program tab, choose Install → Edit mcp.json and paste the API key config under Any MCP app. |
| Zed | Open Settings → AI → MCP Servers, click Add Server, then Add Remote Server, and paste the address. |
| Raycast | Run Install MCP Server, choose HTTP, paste the address and set OAuth to Dynamic. |
| Perplexity | Open Settings → Connectors, click + Custom connector, choose Remote, paste the address and choose OAuth. |
| Microsoft Copilot Studio | In 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:
{
"mcpServers": {
"listenfox": {
"url": "https://listenfox.com/api/mcp"
}
}
}Some apps want the transport named:
{
"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.
{
"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.
| Tool | What it does | Kind | Scope |
|---|---|---|---|
search_calls | Finds calls by date, caller, source, lead band, outcome or words said. | Reads | calls:read |
get_call | One call: summary, findings, key moments and a shortened transcript. | Reads | calls:read |
find_contact | Finds a caller by phone number, email or name. | Reads | contacts:read |
get_contact | One caller with their lead card and recent calls. | Reads | contacts:read |
list_followups | Open or done follow-ups, soonest due first. | Reads | followups:read |
get_metrics | Calls, hot leads, orders and conversion for a period, compared with the one before. | Reads | insights:read |
top_objections | The objections callers raised most. | Reads | insights:read |
unmet_demand | What callers asked for that you don’t offer. | Reads | insights:read |
agent_scorecards | Calls and scores per person who answers your phones. | Reads | insights:read |
ask_calls | Asks a question across your calls, the same as Ask in the app, with links to the moments. | Uses credits | ask |
analyze_call | Analyzes a call that hasn’t been analyzed yet, such as one imported without analysis. | Uses credits | analyze |
create_followup | Adds a follow-up to a call or a caller. | Changes data | followups:write |
complete_followup | Marks a follow-up as done. | Changes data | followups:write |
label_call | Adds or removes labels on a call. | Changes data | calls:write |
update_contact | Changes a caller’s name, email, status or custom fields. | Changes data | contacts: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.