pghdma/callrail-mcp

A Model Context Protocol server for the CallRail REST API v3. Point Claude Code, Claude Desktop, Cursor, or any other MCP client at it and ask about your call tracking in plain English.
I'm **Steve Japalucci**. I run Pittsburgh Digital Marketing Agency (PGHDMA), and I built this for my own client work. CallRail bills per tracking number and per minute across every client I manage, and I was tired of clicking through its reports to answer questions like "which client is burning my minutes this month". Now I ask Claude.
Works with both major versions of the MCP Python SDK (1.x and 2.x).
What I use it for
These are the kinds of questions I ask it every week:
**Reporting**
- *"Pull last week's calls for Alan Construction, grouped by source"*
- *"Show me every missed call this month"*
- *"Find any calls from 412-555-1234 across all clients in the last 90 days"*
- *"Get the transcript for call CAL019abc..."*
**Agency cost attribution**
- *"Why is my CallRail bill $174? Break it down by client"*
- *"Which client is the biggest minute user this cycle?"*
**Conversion debugging**
- *"Why didn't this call convert in Google Ads? CAL019..."*
- *"Is this 58-second call eligible to count as a Google Ads conversion?"*
**Lead management**
- *"Show me everything this person has ever done: calls, forms, texts"*
- *"Tag this SMS thread as a qualified lead and add a note"*
**Tag and tracker management**
- *"Tag this call as 'lead' and add a note"*
- *"Provision a new Google Ads call-extension tracker for Renaissance in area code 412"* (requires confirm_billing=True, costs about $3/mo)
Installation
To install from source (latest unreleased):
Auth
Get an API key at **Settings > API Keys** in your CallRail account. You need Account Admin permission to create one.
Provide it one of two ways:
Option 1: environment variable (recommended for most setups)
Option 2: key file
Or override with CALLRAIL_API_KEY_FILE=/path/to/key.txt.
Optional: pin the account
Every tool resolves the account id with one GET /a.json per process and caches it. Set CALLRAIL_ACCOUNT_ID to skip that lookup, or to pin one account when the key can see several.
Configure your MCP client
Claude Code / Claude Desktop (~/.claude.json or claude_desktop_config.json)
If you installed via pipx, callrail-mcp will be on your PATH automatically. Otherwise, point command at the full path to the executable.
Cursor and other clients
The server speaks standard MCP stdio. Any client that supports stdio MCP servers will work; just run callrail-mcp as the command.
Available tools
**57 tools total**, covering roughly 95% of CallRail's REST API v3 surface: read tools, write tools, tracker provisioning, agency aggregation, account management, notifications, integrations discovery, outbound calls, offline-lead backfill, leads and cross-channel timelines, SMS-thread lead management, and server-side analytics.
Read tools
| Tool | Purpose |
|---|---|
| list_accounts | List accessible CallRail accounts. fields="numeric_id" adds the number shown in CallRail URLs |
| list_companies | List companies (clients) under an account. Optional status="active", search, fields (for example verified_caller_ids) and page |
| list_trackers | List tracking phone numbers and their source mapping. Optional status="active", type, search and fields |
| get_tracker | Full detail for one tracker |
| list_calls | Paginated call list. Filter by company, date window, answer_status, direction, device, call_type, lead_status, tracker_id, tags and free-text search, with sort/order and an IANA time_zone |
| get_call | Full detail for a specific call |
| call_summary | Aggregate stats (total, answered by a person, voicemail, missed, by source, duration) for a window |
| list_form_submissions | CallRail Form Tracking submissions. Filter by lead_status, tags and person_lead; sort by submitted_at or form_url |
| list_text_messages | SMS conversations |
| list_users | Account users, paginated. Filter by company_id, search names and emails, sort by email or created_at |
| get_call_recording | Recording URL (if recording enabled). CallRail documents the link as good for at least 24 hours; HIPAA accounts get a temporary URL that expires in about 24 hours |
| get_call_transcript | Transcript plus conversational_transcript, call_summary, call_highlights, keywords_spotted, sentiment and speaker_percent via field selection (Premium Conversation Intelligence required since 2026-05-21) |