KaiCalls

KaiCalls MCP Server

A phone number for your business or your AI agent. Kai answers it and calls businesses for you.

Get a business number (or keep yours) with Kai built in. Your phones ring first; Kai answers misses and after-hours calls, takes the details and texts you. See current plans and pricing. This repository is the public connector definition for the hosted KaiCalls MCP server — it documents the endpoint, authentication, and tool catalog so MCP clients 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.

Give your AI agent a phone number

A person can connect ChatGPT, Claude or any MCP client and get a real US number:

• Kai calls businesses for you. make_call places an errand call to a US or Canada business (a shop, clinic, office or restaurant), asks the question, presses keys on phone menus, and check_call_status returns the answer. Kai says up front that it is an assistant calling for you, and it does not place AI calls to personal cell phones.
• Kai answers the callback. The business calls your own number back, and Kai takes the message.
• The first call for a new connector account is free. After that, calls run on a plan: see kaicalls.com/ai-agent-phone-number.

Quick Answer

What is the KaiCalls MCP connector? It is the official hosted MCP connector for KaiCalls. Existing customers use https://www.kaicalls.com/api/mcp; a first-time buyer can use the setup-only surface at https://www.kaicalls.com/api/mcp/acquisition.

Who should use it? Use it when Claude, ChatGPT, Cursor, an MCP gateway, or another AI client needs to safely inspect KaiCalls agents, calls, transcripts, leads, analytics, and approved setup actions.

Does it require hosting your own server? No. KaiCalls hosts the MCP server. Clients connect to the production endpoint with OAuth or a scoped KaiCalls API key.

Is this the WordPress plugin? No. The approved KaiCalls AI Intake plugin captures website leads from WordPress. This repo documents the agent/MCP connector.

Is this the n8n integration? No. n8n workflows should use n8n-nodes-kaicalls.

Agent frameworks

• OpenClaw: integrations/openclaw is the KaiCalls plugin. It adds 8 call and text tools, plus a kaicalls channel so texts to your agent's number start an agent turn. ClawHub publication is pending.
• Hermes Agent: integrations/hermes is a portable Agent Plugins v1 package (the hosted MCP server plus a skill). Install it with hermes plugins install https://github.com/KaiCalls/kaicalls-mcp/tree/main/integrations/hermes.

Quick connect

Claude (web & desktop)

[Add KaiCalls to Claude in one click](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=KaiCalls&connectorUrl=https%3A%2F%2Fwww.kaicalls.com%2Fapi%2Fmcp): Claude opens its *Add custom connector* box with the name and URL already filled in. Press Add, then sign in. Owners of a Team or Enterprise workspace can use the admin link to add it for everyone.

ChatGPT and other clients

Add a custom connector pointing at https://www.kaicalls.com/api/mcp for an existing account, or the acquisition endpoint for setup. 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.

Cline / remote MCP clients

KaiCalls is a remote server — there is nothing to clone or install. Add it to your MCP client config as a Streamable HTTP server and authenticate with a kc_live_ key. For Cline, edit cline_mcp_settings.json (or use the Remote Servers tab) and add:

{

"kaicalls": { "url": "https://www.kaicalls.com/api/mcp", "type": "streamableHttp", "headers": { "Authorization": "Bearer kc_live_YOUR_KEY" } } }

Replace kc_live_YOUR_KEY with a key from the KaiCalls dashboard under Settings → API Keys. The transport type must be the camelCase string streamableHttp — using streamable-http or omitting it makes Cline fall back to SSE and the connection fails with a 405. Once saved, Cline lists the KaiCalls tools and is ready to use. See llms-install.md for the full agent-driven setup walkthrough.

Gemini CLI and Antigravity

gemini extensions install https://github.com/KaiCalls/kaicalls-mcp

agy plugin install https://github.com/KaiCalls/kaicalls-mcp

Both connect to the hosted server at https://www.kaicalls.com/api/mcp and sign you in with OAuth the first time a tool runs.

Run locally over stdio (Docker)

Most clients should connect to the hosted server at https://www.kaicalls.com/api/mcp. For stdio-only clients, this repo ships a small bridge with no dependencies:

docker build -t kaicalls-mcp .

docker run -i --rm -e KAICALLS_API_KEY=kc_live_... kaicalls-mcp

or without Docker: KAICALLS_API_KEY=kc_live_... node stdio-proxy.mjs

initialize and tools/list work without a key. tools/call needs KAICALLS_API_KEY, which you create at https://www.kaicalls.com/dashboard/settings/api-keys.

Tools

The account endpoint exposes 171 tools: 60 read-only and 111 write/setup. Every tool carries MCP safety annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). The setup endpoint (/api/mcp/acquisition) exposes the 37 tools marked Yes in the Setup surface column, the subset that takes a new business from signup to a working number. The machine-readable inventory, with full descriptions, scopes and annotations, is in mcp.json and server-card.json. In-depth notes for the core tools are in docs/tools.md. The live tools/list response returns each tool's input schema.

Read-only tools (60)

| list_workflow_templates | calls:read | | List t