Skip to content

v1.0.0 — First stable release

Choose a tag to compare

@pghdma pghdma released this 24 Apr 21:03

First stable release of callrail-mcp 🎉

pipx install callrail-mcp
# or
pip install callrail-mcp

What's in the box

49 tools spanning ~85% of the CallRail REST API v3:

  • Read tools (calls, companies, trackers, users, tags, form submissions, text messages, recordings, transcripts)
  • Write tools (update_call, tag CRUD, form submission updates)
  • Tracker provisioning (full CRUD with billing-confirmation safeguard)
  • Account management (Companies CRUD, Users CRUD)
  • Notifications + Integrations (CRUD on alert rules, discovery for GMB / Google Ads / etc.)
  • Outbound calling (with confirm_dialing=True safety gate)
  • Form-submission backfill for offline leads
  • Agency aggregation tools: usage_summary, compare_periods, bulk_update_calls, spam_detector, call_eligibility_check

Out of scope (deliberately)

See README's "Out of scope" section for the documented gaps:

  • SMS send + webhook integration CRUD: blocked by CallRail account permissions (return 403 on standard accounts)
  • Outbound Caller IDs, Numbers, Call Flows, Custom Fields, DNC list: not exposed by CallRail's REST API (UI-only on standard plans)

PRs welcome from anyone whose CallRail plan exposes those endpoints.

Quality gates

  • 297 tests, all green
  • 84% line coverage
  • All 5 check tools clean: pytest -W error, mypy --strict, ruff, bandit, pyright
  • ~115 bugs caught + fixed across 18 development releases (audit-and-test discipline)

See CHANGELOG.md for the full development history.

🤖 Built with the help of Claude Code