Topcalls MCP server
Connect Claude, ChatGPT, Cursor or Codex to your Topcalls account. Ask how today's calls went, read a transcript, or have the app draft a campaign that calls no one until you launch it.
Key takeaways
- The Topcalls MCP server connects AI apps that support MCP, including Claude, ChatGPT, Claude Code, Cursor and Codex, to one Topcalls account.
- To connect, add https://www.topcalls.ai/api/mcp to your AI app as a remote MCP server and sign in with your Topcalls login.
- Topcalls gives AI apps 18 tools: 10 that only read your calls, campaigns, leads, numbers and credit balance, and 8 that change things, such as saving a campaign draft or importing leads.
- Connect an AI app as read only and it can look at your Topcalls data but can't change anything.
- Topcalls marks the tools that can't be undone, such as launching or cancelling a campaign and placing a test call, so AI apps like Claude and ChatGPT can ask you before they run one.
- No Topcalls MCP tool can change prices, add credit or change billing settings.
Connect your AI app in three steps
https://www.topcalls.ai/api/mcp- 1
Add the server
In Claude, ChatGPT, Cursor or another AI app that supports MCP, add a custom connector or MCP server and paste the address above.
- 2
Allow access in Topcalls
Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.
- 3
Ask in your chat
Ask about your calls, campaigns and leads. The app picks the Topcalls tool that answers.
Steps for Claude, ChatGPT, Claude Code, Cursor and Codex are in the setup guide. Calls your AI app starts use your credit like any other call. What they cost is on the pricing page.
Prefer the terminal? The same tools run as commands with the Topcalls CLI.
What the 18 Topcalls MCP tools do
| Tool | Type | What it does |
|---|---|---|
| whoami | Reads | Shows which Topcalls account the connection uses, whether it's read only, and which app it was approved for. |
| get_balance | Reads | Shows the credit balance and whether it's frozen. With the billing permission it also shows billing settings such as auto-recharge. |
| list_calls | Reads | Lists calls, newest first, with status, direction, campaign, lead, start and end, billed seconds, cost and summary. Filters by campaign, status or dates. |
| get_call | Reads | Shows one call with its summary, status, timing, cost and transcript. The recording isn't included. |
| list_campaigns | Reads | Lists campaigns with their name, status and direction, and the numbers that answer for inbound ones. |
| get_campaign | Reads | Shows one campaign: status, direction, attempts per lead, its lead lists and the numbers that answer for it. |
| list_leads | Reads | Lists leads with name, status, phone, email, tags, notes and the lead lists each one is in. |
| get_lead_status_counts | Reads | Counts leads by status: New, Contacted, Converted and Unsubscribed. |
| list_phone_numbers | Reads | Lists phone numbers with label, status, capabilities and the campaign that answers inbound calls on each. |
| list_integration_flows | Reads | Lists the Integrations flows that can run as tools. |
| save_campaign_draft | Changes | Creates a campaign draft, or changes a draft or paused campaign. A draft calls no one until it's launched. It can also edit a running inbound campaign. |
| launch_campaign | Changes | Starts a draft campaign now or at a set time. Refused when the Launch checklist is incomplete, the safety review fails or the credit is too low. Places real calls that use credit. |
| pause_campaign | Changes | Pauses a running campaign. No new calls start until it's resumed. |
| resume_campaign | Changes | Resumes a paused campaign after the safety review runs again. Real calls start again and use credit. |
| cancel_campaign | Changes | Stops a campaign for good and cancels the calls it has not placed yet. |
| start_test_call | Changes | Places one real test call with a campaign's agent, to a lead of the account or the company's verified contact phone. No other number can be called. Uses credit. |
| import_leads | Changes | Adds leads to a lead list. A number already in the list is skipped. If any row is invalid, nothing is imported. |
| run_integration_flow | Changes | Runs one of the account's Integrations flows. A flow can change data in the apps it connects to. |
0
Tools in total
0
Tools that only read
0
Tools that change things
Capabilities
What's under the hood
Every feature is designed to work together, giving you a complete system out of the box.
Your Topcalls login
The AI app never sees your password. You sign in on Topcalls and approve the connection there.
One account per connection
Each connection works on the one Topcalls account you chose when you approved it.
Read only when you want it
Turn on Read only when you connect, and the app can look at your data but can't change anything. It doesn't even see the tools that change things.
Your role sets the limits
Every tool checks your role in the account each time it runs. If your role can't launch a campaign in Topcalls, your AI app can't launch one either.
Activity you can check
Topcalls records which tool ran, what it acted on, how it ended, which app and member used it, and when. It never records what was sent or returned.
End it any time
End one connection, or all of them, in Topcalls settings. The app stops on its next request. A connection also ends after 30 days without use.
Use Cases
Built for real workflows
Review today's calls
Ask "Summarize my Topcalls calls from today. How many were completed, and what did people say most often?" and see how the day went without opening a report.
Read a call
Ask for your latest completed call and get its transcript and three main points in the chat.
Draft a campaign
Describe the campaign you want, and the app saves it as a draft for you to check in Topcalls. A draft calls no one until you launch it, and a read-only connection can't save one.
Frequently asked questions
What is the Topcalls MCP server?
The Topcalls MCP server is the address AI apps use to work with your Topcalls account through MCP, the open standard for connecting AI apps to other services. Once you connect it, Claude, ChatGPT, Cursor, Codex and other MCP apps can read your calls, campaigns and leads, and with full access save drafts, launch campaigns and import leads.
How do I connect Claude to Topcalls?
In Claude, open Settings, then Connectors, choose Add custom connector and paste https://www.topcalls.ai/api/mcp. Claude sends you to Topcalls to sign in. Choose the account, decide whether the connection is read only, and select Allow access.
Can I use Topcalls from ChatGPT?
Yes. In ChatGPT, add a custom MCP server named Topcalls, paste the server address as the Server URL and set Authentication to OAuth. ChatGPT then sends you to Topcalls to sign in and allow access. The setup guide has every step.
Can an AI app spend my Topcalls credit?
Only on a full-access connection, and only when your role allows the action. Launching or resuming a campaign, placing a test call, and importing leads into a list that feeds a running campaign all lead to real calls that use credit. Topcalls refuses a launch when the credit is too low. Through MCP, a Topcalls account takes at most 10 campaign launches an hour and 30 a day; 20 test calls an hour and 100 a day, with 3 a day to the same lead; 20 campaign resumes an hour; and 10 lead imports an hour and 30 a day. Every AI app connected to the account counts toward the same limits.
Can the AI app change my prices or billing?
No. No Topcalls MCP tool changes prices, adds credit or changes billing settings. The balance tool only reads your credit balance. What calls cost is on the Topcalls pricing page.
How do I disconnect an AI app from Topcalls?
In Topcalls, open the Setup menu and go to the page where you connected the app, then select End connection. The app stops on its next request. The account owner can end every connection at once. A connection also ends by itself after 30 days without use.
Is there a Topcalls CLI?
Yes. The Topcalls CLI, @topcalls/cli on npm, runs the same tools from your terminal and can add the Topcalls MCP server to Claude Code, Cursor, Codex and VS Code for you.