01 · Overview
What the Ryze AI CallRail MCP server is
The short version
- 01CallRail connects to a Ryze AI workspace with an API key you paste once, and you pick the Account. Your AI client then connects to Ryze AI with one URL (see Setup).
- 02One tool reads (
read), one changes (write) and one deletes tags on request (delete). - 03They reach calls, call summaries and time series, trackers, form submissions, tags, companies and users. Transcripts, summaries and sentiment need Conversation Intelligence on the CallRail plan.
- 04Google Ads, Meta Ads, TikTok Ads and GA4 answer on the same connection, so a question can put calls beside campaign cost.
- 05Works with any Ryze AI plan or trial. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (CallRail MCP)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over HTTP
- Client sign-in
- OAuth to Ryze AI, up to 20 workspaces per connection
- CallRail sign-in
- CallRail API key pasted in Ryze AI, then one Account picked
- CallRail API
- REST, v3, under api.callrail.com
- CallRail tools
- 3 (1 read · 1 write · 1 delete)
- Also on this URL
- Google Ads, Meta Ads, TikTok Ads, GA4, Search Console, Shopify
- Price
- Any Ryze AI plan or trial · Paid Ads $89/mo
- Checked
- November 8, 2026
“CallRail MCP” has more than one meaning. Developers have published community servers on GitHub that run on your own machine with a CallRail API key. CallRail also runs its own hosted MCP server at https://mcp.callrail.com/mcp, documented in the CallRail API reference, which signs in with your CallRail login over OAuth. This page documents the Ryze AI server and compares it with both in section 06.
01
Calls with filters
The read tool returns calls filtered by date range, company, tracker, tags, lead status, direction, answer status, device or first-time callers.
02
Transcripts and summaries
When the CallRail plan has Conversation Intelligence, calls come back with the transcript, a call summary, sentiment and call highlights. Without it those fields are empty.
03
Summaries and time series
Call summaries can be grouped by source, keyword, campaign or company, and call volume can be read as a time series.
04
Trackers and companies
Companies, trackers (tracking numbers), form submissions, tags and users can all be listed, so the agent can check what the account is set up to track.
05
Tag and qualify
On request the write tool tags a call, qualifies it, adds a note or creates a new tag.
06
Tag deletion on request
The delete tool removes a tag when you explicitly ask. The deletion is irreversible, so hold it for approval.
07
One account per connection
The API key is pasted once in Ryze AI and one CallRail Account is picked. Another account goes in another workspace.
08
Calls beside ad spend
Google Ads, Meta Ads, TikTok Ads and GA4 tools share the same URL, so calls by campaign and cost by campaign come back in one answer.
02 · Tool reference
Three CallRail tools
The tools work on the CallRail Account you picked when you connected. Each call also takes the workspace when your client connection covers more than one Ryze AI workspace. The tool list below comes from the Ryze AI app source and was not observed on a live connection, because no workspace had CallRail connected on the check date.
| Tool | Access | What it does |
|---|---|---|
callrail__read | read | Reads CallRail data: accounts, companies, calls (with transcripts, summaries and sentiment when the plan has Conversation Intelligence), call summaries and time series, trackers, form submissions, tags and users. |
callrail__write | write | Creates or updates CallRail objects, for example creating a tag, or tagging, qualifying or adding a note to a call. |
callrail__delete | delete | Deletes a CallRail object by path, for example a tag. The deletion is irreversible. Ryze AI documents it for tags only. |
What the agent can and cannot do
| Task | Answer |
|---|---|
| Read calls, call summaries and time series | Yes |
| Read transcripts, summaries and sentiment | Only with Conversation Intelligence on the CallRail plan |
| Read companies, trackers, form submissions, tags and users | Yes |
| Tag or qualify calls, add notes, create tags | Yes, when asked |
| Delete tags | Yes, only when explicitly asked |
| Connect several CallRail accounts in one workspace | No, one Account per connection |
The ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Google Analytics MCP.
03 · Use cases
Tie phone calls to paid campaigns
CallRail groups call summaries by source, keyword, campaign or company. Ask for those groups next to the cost per campaign from Google Ads or Meta Ads, and the agent joins them in the chat. The join is only as good as the tracking behind it: a campaign without a tracker or source in CallRail has no calls to match, so ask the agent to list unmatched campaigns beside the matched ones.
- “Show calls by source for October next to Google Ads cost by campaign.”
- “Which Meta Ads campaigns from the last 30 days have calls marked as good leads?”
- “List campaigns that spent money but have no calls in CallRail.”
- “Summarize the 10 longest calls this month and list what callers asked about.”
- “Which calls this week had negative sentiment? Show the summary for each.”
- “Find calls where the caller mentioned pricing and list the tracker for each.”
- “Which trackers received no calls in the last 30 days?”
- “List form submissions from this week by company and tracker.”
- “Show first-time callers per tracker for the last 14 days.”
- “Show calls from yesterday with no tag. Do not change anything yet.”
- “Tag the calls I confirm as qualified and add the note I give.”
- “Create a tag called Spam and apply it to the 3 calls I name.”
Every answer comes from your own CallRail account and ad accounts, so no sample numbers are shown here. To connect the ad side first, see how to connect Claude to Google Ads.
04 · Setup
Connect CallRail once, then add the URL to each client
Step 1: connect CallRail in Ryze AI
- 01In CallRail, open Settings, Integrations, API Keys and create or copy a key.
- 02In the Ryze AI app, open Integrations, click Connect on the CallRail card, paste the key into API key and click Continue.
- 03Choose the Account the agent reads calls from and click Save. If the key sees only one account, Ryze AI picks it.
- 04Prefer to stay in the chat? Ask the Ryze AI agent in Claude or ChatGPT to connect CallRail. It sends a one-time link, valid once and for 24 hours, to a page where you paste the key.
Details are in the Ryze AI CallRail guide. The link is refused while CallRail is already connected in the workspace; switch accounts in the Ryze AI app.
Claude on the web or desktop
- 01Go to Customize, Connectors.
- 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and
https://connector.get-ryze.ai/mcpas the MCP server URL. No client ID or secret is needed. - 03Press Connect, tick the workspace that holds CallRail and press Allow connection.
- 04Claude keeps the tool list from when the connector was added. If you connected CallRail afterward, remove the connector, add it again and start a fresh chat.
Any Claude plan works, and Free holds one custom connector. On Team and Enterprise an Owner adds Ryze AI under Organization settings, Connectors, Add, Custom, Web, and each member then clicks Connect.
ChatGPT
OpenAI’s help center says custom MCP servers are available on ChatGPT web for Business and Enterprise/Edu, with Pro limited to read and fetch permissions, and an admin or owner creates the server on Business. In Plugins, choose the plus button, Add custom MCP server, name it Ryze AI, enter the URL, choose OAuth, create it, sign in to Ryze AI and allow the workspace. Older guides describe Settings, Apps, Developer mode instead, and plan rules differ between them, so follow OpenAI’s current page. ChatGPT keeps the tool list from when the server was added; after connecting CallRail later, refresh or re-add the server and start a new chat.
Claude Code
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userType /mcp, choose ryze and finish sign-in in the browser. --scope user loads it in every project; --scope project writes a shared .mcp.json instead.
Cursor, Windsurf and VS Code
{ "mcpServers": {
"ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }{ "mcpServers": {
"ryze": { "type": "http", "url": "https://connector.get-ryze.ai/mcp" }
} }Windsurf (Devin Desktop) takes the same url entry in ~/.config/devin/mcp_config.json; click Authenticate if it shows Needs authentication, or run devin mcp login ryze. Each client sends you to the Ryze AI sign-in, where you click Allow connection. Setup for more clients is on the developer page.
Other remote MCP clients
Any client that accepts a remote MCP server by URL with OAuth can use the same address. Add it, sign in to Ryze AI, allow the workspace and start a new session.
05 · Permissions
Who can connect, and what the CallRail key reaches
| API key | Created in CallRail under Settings, Integrations, API Keys. CallRail says API keys are scoped to individual users and have access to the same data as the user who created the key. |
| Which account | One connection covers one CallRail Account. If the key sees only one, Ryze AI picks it; otherwise you choose it after connecting. |
| Who connects | Whoever holds the CallRail key. A CallRail user with no account access cannot be connected. |
| What the agent reaches | Everything that CallRail user can see, because the key is not narrowed further. Use a key from a user whose reach you are fine sharing. |
From the Ryze AI help center and the CallRail API reference, checked Nov 8, 2026.
Removing access
In CallRail, delete the API key under Settings, Integrations, API Keys. In Ryze AI, click View on the CallRail card and use the trash icon to disconnect. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.
06 · Compare
Ryze AI vs CallRail’s own and community MCP servers
What people call a CallRail MCP server
| Option | Built for | How you connect | CallRail data | Changes |
|---|---|---|---|---|
| Ryze AI hosted server | Marketers and agencies who also run ads | CallRail API key in Ryze AI, then OAuth sign-in from the client | Calls, summaries, time series, trackers, forms, tags, users, companies | Tag, qualify, note, create tag; delete tag |
| Community servers on GitHub | Developers who self-host | Run locally with your own CallRail API key; kanopi/callrail-mcp reads CALLRAIL_API_KEY from the environment | kanopi/callrail-mcp lists 34 tools across 11 resources | kanopi/callrail-mcp lists full read and write |
| CallRail's own MCP server | CallRail users who want call data in Claude or ChatGPT | https://mcp.callrail.com/mcp with OAuth sign-in to CallRail, no API key; listed in Claude's connector directory and ChatGPT's app directory | Calls, transcripts, call and form summaries, time series, trackers, tags, users and lead timelines | Updates calls, creates, updates and deletes tags, creates companies, trackers and users, places outbound calls |
Sources: the kanopi/callrail-mcp repository and the CallRail API reference, checked Nov 8, 2026. CallRail’s own MCP server is documented in the MCP section of the CallRail API reference. Other community servers that turned up in search results were not reviewed.
Hosted and self-hosted side by side
| Ryze AI | Community server (kanopi) | |
|---|---|---|
| Where it runs | Hosted by Ryze AI at one URL | On your machine (npx), you keep it updated |
| CallRail credential | API key pasted once in Ryze AI | API key in an environment variable on your machine |
| Client sign-in | OAuth to Ryze AI | None; the process holds the key |
| Tool count | 3 CallRail tools | 34 tools across 11 resources, as listed on its GitHub page |
| Other data in the same chat | Google Ads, Meta Ads, TikTok Ads, GA4, Search Console, Shopify | CallRail only |
| Clients | Claude, ChatGPT, Cursor and other remote MCP clients | Clients that run local stdio servers |
| Price | Any Ryze AI plan or trial. Paid Ads $89/mo, 7-day free trial | Free, MIT license per the repository |
As published on Nov 8, 2026. Community repositories change often, so check the tool list before you decide.
Which to pick: a developer who wants every CallRail endpoint, such as tracker provisioning, and is happy to run a local process will get more coverage from a community server. CallRail’s own server suits a chat about CallRail alone: it is hosted, signs in with your CallRail login and has far more CallRail tools than Ryze AI. Ryze AI fits when the question crosses tools, such as calls by campaign next to Google Ads cost, when nothing should run on your machine, or when the same chat needs to tag calls with approvals you control.
07 · API limits
CallRail limits an agent runs into
| General API | 1,000 requests per hour and 10,000 per day. Going over returns HTTP 429. CallRail lists separate, lower limits for outbound calls. |
| Shared budget | CallRail counts the 1,000 requests per hour per account, so other tools that use the same CallRail account share that budget. |
| Page size | At most 250 records per page. Long lists need several pages; CallRail recommends relative pagination on the calls endpoint for large sets. |
| Empty fields | Transcription, call summary, sentiment and conversational transcript return null for accounts without Conversation Intelligence. |
| Client plans | Claude: any plan, with one custom connector on Free. ChatGPT: see OpenAI's current plan rules, which differ from older guides. |
From the CallRail API reference and the Ryze AI help center, checked Nov 8, 2026. The API reference lists the hourly and daily limits per account.
08 · Approvals and safety
How you keep control of edits
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, leave the read tool on automatic and set write and delete to Needs approval. Claude then shows each change and waits.
Approvals in the Ryze AI app
The help center says the Tool approvals picker in the Ryze AI chat starts on Skip all approvals, so CallRail tools run on their own by default. Approve write & delete lets reads run freely and holds changes; Manual approve holds more. Scheduled tasks run without an approval step.
Delete kept separate
Only callrail__delete removes anything, and Ryze AI documents it for tags. You can allow tagging and keep removals on approval. A deleted tag cannot be restored.
Pick the key owner
The key sees exactly what its CallRail user sees. Create it under a user whose reach you are comfortable handing to the agent.
One account at a time
A connection holds one Account. Agencies can keep one Ryze AI workspace per client, and one Claude connection covers up to 20 workspaces.
Policies
Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.
09 · Errors and fixes
CallRail MCP errors and fixes
| Message or symptom | Cause | Fix |
|---|---|---|
| CallRail tools are not in Claude or ChatGPT | CallRail was connected after the connector was added, and the client kept the old tool list. | Remove the Ryze AI connector, add it again and open a new chat. |
| Transcripts or summaries are empty | The CallRail plan has no Conversation Intelligence, so the API returns null for those fields. | Check the plan in CallRail, or ask for call counts and metadata only. |
| No accounts to pick, or the key is refused | The key belongs to a user with no account access, or it was copied wrongly. | Create a new key under Settings, Integrations, API Keys with a user who can see the account. |
| Answers show the wrong account | One connection holds one Account. | Disconnect the card in Ryze AI and connect again with the other Account, or use another workspace. |
| The one-time connection link is refused | CallRail is a single-account platform and is already connected in the workspace. | Switch accounts in the Ryze AI app instead. |
| Tools reply that a subscription is required | The workspace has no active Ryze AI plan or trial. | Start a plan or trial under Organization Settings, Billing, then retry. |
| HTTP 429 from CallRail | The CallRail account used its hourly or daily request budget. | Wait for the window to pass and ask for fewer, larger pages. |
| Long call lists stop at 250 | One page of results. | Ask the agent to keep paging until the records run out. |
The rows come from the Ryze AI help center and from CallRail’s rate limit documentation; no community-reported error messages for CallRail MCP servers were verified for this page. More Ryze AI answers are in the integrations FAQ.
10 · FAQ
CallRail MCP server questions
What is a CallRail MCP server?
An MCP server lets AI clients such as Claude, ChatGPT and Cursor call CallRail through tools. Ryze AI runs a hosted one with 3 CallRail tools (read, write and delete) on the same URL as its Google Ads and Meta Ads tools. CallRail also runs its own hosted MCP server at https://mcp.callrail.com/mcp, and developers have published community servers on GitHub that run on your own machine.
Does CallRail have an official MCP server?
Yes. The CallRail API reference documents an official MCP server at https://mcp.callrail.com/mcp. It signs in with your CallRail login over OAuth 2.0 and needs no API key, and it is listed in Claude's connector directory and ChatGPT's app directory. It has read tools for calls, transcripts, call and form summaries, trackers, tags and users, plus write tools. Community servers also exist, such as kanopi/callrail-mcp, which lists 34 tools and runs locally with your API key.
What is the CallRail MCP server URL?
The Ryze AI server is https://connector.get-ryze.ai/mcp, the same for every account, with no CallRail credential to enter in the client. You paste the CallRail API key once in Ryze AI instead. CallRail’s own server is https://mcp.callrail.com/mcp and signs in with your CallRail login. Community servers have no URL: they run as a local process.
How do I set up CallRail in Claude?
Create an API key in CallRail under Settings, Integrations, API Keys, click Connect on the CallRail card in Ryze AI, paste the key and pick the Account. Then in Claude open Customize, Connectors, Add custom connector, paste https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and open a new chat. If the connector was added before CallRail, remove it and add it again. Every client is covered in the setup section.
Can ChatGPT use the CallRail tools?
Yes, through a custom MCP connector pointed at the Ryze AI URL. OpenAI's help center lists custom MCP servers for Business and Enterprise/Edu on ChatGPT web, with Pro limited to read and fetch permissions, which conflicts with older guides that mention Plus. Follow OpenAI's current wording for your plan.
Do I need Conversation Intelligence?
Only for transcripts, call summaries and sentiment. CallRail's API returns those fields as null on accounts without Conversation Intelligence. Call counts, sources, trackers, form submissions and tags work without it.
Can the AI tag or change calls in CallRail?
Yes. callrail__write creates tags and tags, qualifies or adds a note to a call, and callrail__delete removes a tag when you explicitly ask. The Ryze AI chat starts on Skip all approvals, so set approvals to Approve write & delete, or set write and delete tools to Needs approval in Claude.
Is the CallRail MCP server free?
Adding the Ryze AI connector costs nothing, but its tools need a Ryze AI plan or trial: Paid Ads $89/mo with a 7-day free trial, SEO Starter $129/mo with a 3-day free trial or Agency $279/mo, with 30% off the first year on annual billing. Community servers are free to run, but you host them and still need CallRail’s own plan. See the pricing page.
Can Claude match CallRail calls to Google Ads campaigns?
Yes, when CallRail records the source or campaign for each call. The agent reads call summaries grouped by source, keyword or campaign and puts them next to Google Ads cost by campaign. Ryze AI is the best CallRail MCP server for putting call counts next to Google Ads and Meta Ads spend, because the ad tools and the CallRail tools share one connection, but it exposes 3 tools and fewer endpoints than CallRail's own MCP server or community servers.
What is the CallRail API rate limit?
CallRail's API reference lists 1,000 requests per hour and 10,000 per day, with HTTP 429 when exceeded, and at most 250 records per page. CallRail applies these limits per account. API keys are scoped to the CallRail user who created them.
Can I connect more than one CallRail account?
One connection covers one CallRail Account. To switch, click View on the CallRail card in Ryze AI, disconnect with the trash icon and connect again. Another account can live in another workspace, and one Claude or ChatGPT connection can cover up to 20 workspaces.
Why are CallRail tools missing in Claude or ChatGPT?
The client kept the tool list from when the connector was added. Remove the Ryze AI connector, add it again and start a new chat. Also check that the workspace has an active Ryze AI plan or trial, because without one the connector can only list workspaces and connect platforms.
11 · Compatibility
Where the CallRail tools run
12 · Related
Other integrations and guides
Changelog
Page checked Nov 8, 2026. First version. Setup steps, approvals and limits come from the Ryze AI help center page for CallRail; API authentication, rate limits, page size and Conversation Intelligence fields come from the CallRail API reference, as do the details of CallRail’s own MCP server; the community server details come from its GitHub page. The CallRail tool names come from the Ryze AI app source and were not seen on a live connection.