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.

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
Setup endpoint	https://www.kaicalls.com/api/mcp/acquisition (setup-only subset for first-time buyers)
Tools	171 on the account endpoint (60 read-only, 111 write/setup); 37 on the setup endpoint
Homepage	KaiCalls
Provider	KaiCalls · [email protected]
License	MIT (connector definitions and docs)
Status	GA — live in production

---

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: 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

This is the beginning of the README. Read the rest at the original. Read the full README ↗