list_agentsLABSCO SUMMARY
Thirteen ways to look, five ways to act, and the line between them is a scope you grant.
The read surface answers the questions an owner actually has — who called, what was said, which leads are worth chasing, where the alerts go — without any ability to change the business. The write tools are annotated destructive for a reason: one of them makes a real phone ring, and the rest mutate a live phone system, which is why the risky ones route through an approval broker.
What it is
The hosted MCP connector for KaiCalls, an AI phone-answering service for small businesses. There is nothing to install: clients connect to the production endpoint over Streamable HTTP and authenticate against a KaiCalls account. 18 tools split cleanly — 13 read-only ones covering agents, calls, transcripts, recordings, leads, voicemail, SMS, campaigns and analytics, and 5 write ones that place calls or change live configuration. Access is scoped to a single business, enforced server-side.
What you get
- The account's AI phone agents and the business profile with agent count and recent call stats —
list_agents,get_business_info - Recent calls with status filters, the status of one call by id, and its transcript and summary once completed —
list_recent_calls,check_call_status,get_transcript - The recording URL for a call, for when the question is how it sounded rather than what was said —
get_call_recording - Leads with their latest AI lead score, and the full detail and score explanation for one —
list_leads,get_lead - Voicemails with transcripts and recording URLs, and SMS messages filtered by conversation or direction —
list_voicemails,list_sms_messages - Outbound campaigns, and a dashboard summary over a recent window covering leads by status, conversion, call volume and top agents —
list_campaigns,get_analytics - The current operational setup as an auditable read: staff alert recipients, escalation rules, textable links and agent voice, model and greeting —
get_operational_settings - A real outbound call placed through an agent to an E.164 number —
make_call - Staff alerts, textable links and named business-rule sections in an agent prompt changed, each supporting
dry_runfirst —configure_staff_alerts,configure_textable_links,configure_agent_business_rules - A governed broker for higher-risk updates — E911 address, transcript webhook sink, agent patch — that returns
needs_approvalordeniedrather than acting unaudited —request_kaicalls_update
Requirements
A KaiCalls account. The endpoint is https://www.kaicalls.com/api/mcp over Streamable HTTP. Interactive clients use OAuth 2.1 with PKCE and dynamic client registration — you sign in and pick which business the connection is scoped to on the consent screen. Gateways and scripts send a kc_live_ key as a Bearer token instead, generated in the dashboard. Scopes decide what the connection can do: reads need agents:read or calls:read, and the write tools need calls:write or agents:write, so a read-only connection is a matter of which scopes you grant. Cline needs the transport type spelled streamableHttp exactly, or it falls back to SSE and the connection fails with a 405. make_call dials a real phone and consumes metered minutes; prompt changes require an idempotency key plus human authority or a queued approval.
Setup effort
Follow the published steps — Nothing is installed — KaiCalls hosts the MCP server. Have a KaiCalls account first.
USE CASES
Catching up on what the phone did overnight
List the recent calls, read the transcript of the ones that matter, and pull the recording URL when the transcript is ambiguous about tone or a name.
Deciding which leads to call back first
List the leads with their AI scores, open the top ones for the score explanation, and check the voicemails and SMS threads attached to the same customers.
Auditing where urgent calls are actually routed
Read the operational settings — staff alert recipients, escalation rules, textable links, agent voice and greeting — then change the recipients with a dry run before applying.
Adding a business rule to what the agent says
Patch a named rules section into the agent's prompt through the governed broker with a dry run first, so callback language or a handoff rule lands without rewriting the whole prompt.
Having the agent make the call
Place a real outbound call through a chosen agent to a number you control, with context and an opening line — confirm the recipient first, because this cannot be recalled and consumes metered minutes.
Reporting on the month
Pull the dashboard summary over a window — leads by status, conversion rate, call volume and duration, top agents — alongside the outbound campaigns that ran.
18 tools
Listed in project docs. Your client may show a different list.
get_business_infolist_recent_callscheck_call_statusget_transcriptget_call_recordingget_operational_settingslist_leadsget_leadlist_voicemailslist_sms_messageslist_campaignsget_analyticsmake_callconfigure_staff_alertsconfigure_textable_linksconfigure_agent_business_rulesrequest_kaicalls_updateBEFORE YOU INSTALL
What to know first
Tools you get
18 tools named in the project's documentation.
Requires
- your KaiCalls account
- OAuth sign-in, or a kc_live_ API key sent as a Bearer token
INSTALLATION
Connect your client
Server setup
Setup
Nothing is installed — KaiCalls hosts the MCP server. Have a KaiCalls account first.
Interactive clients (Claude web & desktop, ChatGPT): Settings → Connectors → Add custom connector, URL https://www.kaicalls.com/api/mcp, then Connect → sign in with your KaiCalls account → pick the business on the consent screen → Allow (OAuth 2.1 with PKCE and Dynamic Client Registration, so no manual app setup)
API-key clients / gateways / Cursor / Cline: generate a key in the KaiCalls dashboard under Settings → API Keys, then add the remote Streamable-HTTP server entry with header Authorization: Bearer <YOUR_KAI_CALLS_API_KEY> (X-KaiCalls-API-Key: <YOUR_KAI_CALLS_API_KEY> is also accepted)
For Cline specifically, edit cline_mcp_settings.json (or use the Remote Servers tab) and set "type": "streamableHttp" in camelCase — streamable-http or omitting it makes Cline fall back to SSE and fail with 405
Verify by calling a read-only tool such as list_agents or get_business_info; a successful connect lists 18 tools
Hosted endpoint
https://www.kaicalls.com/api/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Desktop, Claude.ai
Add a custom connector pointing at https://www.kaicalls.com/api/mcp
ChatGPT
Add a custom connector / MCP server with URL https://www.kaicalls.com/api/mcp.
Cline
{
"mcpServers": {
"kaicalls": {
"url": "https://www.kaicalls.com/api/mcp",
"type": "streamableHttp",
"headers": {
"Authorization": "Bearer <YOUR_KEY>"
}
}
}
}Cursor, Any MCP client
{
"mcpServers": {
"kaicalls": {
"url": "https://www.kaicalls.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}