KaiCalls MCP Server
AI phone secretary for businesses: place outbound calls and read transcripts, leads, voicemails, SMS, and analytics from your business line.
Documentation
KaiCalls MCP Server
AI-powered phone answering service for businesses — exposed as a remote Model Context Protocol server.
KaiCalls gives a business its own phone number in 3 minutes. Calls ring the owner's cell first; Kai handles overflow, texts, voicemail, missed-call alerts, outbound campaigns, lead intake, and appointment scheduling. This repository is the public connector definition for the hosted KaiCalls MCP server — it documents the endpoint, authentication, and tool catalog so MCP clients (Claude, ChatGPT, Cursor, and any MCP gateway) and directories can discover and connect to it.
The KaiCalls platform itself is a hosted SaaS — there is no server to install. You connect to the live endpoint below with your KaiCalls account.
| MCP endpoint | https://www.kaicalls.com/api/mcp |
| Transport | Streamable HTTP (JSON-RPC over HTTP POST) |
| Auth | OAuth 2.1 (PKCE S256 + DCR) or kc_live_ API key as Bearer |
| Tools | 18 (13 read-only, 5 write/setup) |
| Provider | KaiCalls · [email protected] |
| Status | GA — live in production |
Quick connect
Claude (web & desktop) / ChatGPT
Add a custom connector pointing at https://www.kaicalls.com/api/mcp. Sign in with
your KaiCalls account, pick the business on the consent screen, and Allow. See
docs/quickstart.md for screenshots and per-client steps.
API-key clients / MCP gateways
Pass a KaiCalls API key directly — no OAuth round-trip needed:
Authorization: Bearer kc_live_xxxxxxxxxxxxxxxxxxxx
(X-KaiCalls-API-Key: kc_live_... is also accepted.) Generate keys in the KaiCalls
dashboard under Settings → API Keys. See docs/authentication.md.
Tools
13 read-only tools and 5 write/setup tools. Full input/output schemas and safety
annotations are in docs/tools.md; the machine-readable inventory
is in mcp.json and server-card.json.
| Tool | Scope | Read-only | Description |
|---|---|---|---|
list_agents | agents:read | ✅ | List AI phone agents on the account |
get_business_info | agents:read | ✅ | Business profile, agent count, recent call stats |
list_recent_calls | calls:read | ✅ | Recent calls for the business |
check_call_status | calls:read | ✅ | Status of a call by ID |
get_transcript | calls:read | ✅ | Transcript + summary of a completed call |
get_call_recording | calls:read | ✅ | Recording URL for listening to the actual call audio |
get_operational_settings | agents:read | ✅ | Audit staff alerts, escalation rules, textable links, and agent voice/model/greeting metadata |
list_leads | calls:read | ✅ | Leads with latest AI lead score |
get_lead | calls:read | ✅ | Full detail for one lead (score + explanation) |
list_voicemails | calls:read | ✅ | Voicemails with transcripts + recording URLs |
list_sms_messages | calls:read | ✅ | SMS messages (filter by conversation/direction) |
list_campaigns | calls:read | ✅ | Outbound call campaigns |
get_analytics | calls:read | ✅ | Dashboard summary (leads, conversion, call volume, top agents) |
make_call | calls:write | ❌ | Place a real outbound call via a KaiCalls agent |
configure_staff_alerts | agents:write | ❌ | Configure staff SMS/email alert recipients and post-call escalation rules |
configure_textable_links | agents:write | ❌ | Create or repair send-link entries used by voice/SMS tools |
configure_agent_business_rules | agents:write | ❌ | Patch a named operational rules section into an agent prompt through the governed broker |
request_kaicalls_update | intent-specific write scope | ❌ | Governed on-behalf update broker (E911 address, transcript sink, full agent patch) |
Write-tool safety.
make_calldials a real phone over the public network and consumes metered minutes (destructive, open-world). Operational setup tools mutate live business configuration and carrydestructiveHint: true; prompt changes route through the governed broker, require an idempotency key plus human authority or a queued approval, and every outcome is audited.
Discovery endpoints
All return 200 and are CORS-open:
| Path | Purpose |
|---|---|
/.well-known/mcp.json | MCP server metadata + tool inventory |
/.well-known/mcp/server-card.json | MCP server card (transport, capabilities, tools) |
/.well-known/agent-skills/index.json | Published agent-skill connectors (see skills/) |
/.well-known/oauth-authorization-server | OAuth 2.1 authorization server metadata |
/.well-known/oauth-protected-resource | Protected-resource metadata |
/.well-known/openid-configuration | OIDC discovery |
Registry id: com.kaicalls/kaicalls (published & active).
Links
- Product — https://www.kaicalls.com
- API docs — https://www.kaicalls.com/docs/api
- Privacy — https://www.kaicalls.com/privacy-policy
- Terms — https://www.kaicalls.com/terms-of-service
- Support — https://www.kaicalls.com/contact · [email protected]
License
The connector definitions and documentation in this repository are released under the MIT License. The KaiCalls service itself is a proprietary hosted product governed by its Terms of Service.