Skip to main content
Project MCP gives AI agents live tools to send messages, read conversations, manage templates, and configure webhooks on your WhatsApp numbers. Use it when an MCP-capable agent should operate a WhatsApp number without shell access — read inbound messages, send replies, manage templates, configure webhooks, and provision new numbers. Endpoint: 
https://api.kapso.ai/mcp

​
Authentication

Choose the auth option your MCP client supports:
  • Browser sign-in: configure the MCP URL, sign in to Kapso, and choose one project.
  • API key: create a project API key in Kapso and pass it as a header.
Both options give the agent access to the same Project MCP tools. Accepted API key headers: 
Authorization: Bearer YOUR_PROJECT_API_KEY

X-API-Key: YOUR_PROJECT_API_KEY
Use Authorization: Bearer for bearer-token clients. Use X-API-Key when your MCP client lets you configure custom headers.

​
Connect

​
Browser sign-in

For clients that support browser sign-in, configure only the MCP URL. 
codex mcp add kapso --url https://api.kapso.ai/mcp
codex mcp login kapso
When Kapso opens in the browser, sign in and select the project the client should use.

​
API key

Set your project API key: 
export KAPSO_API_KEY="your_project_api_key"

codex mcp add kapso --url https://api.kapso.ai/mcp --bearer-token-env-var KAPSO_API_KEY

​
Use X-API-Key instead

Codex CLI has no --header flag, so X-API-Key goes in ~/.codex/config.toml. For Cursor and Claude Code, just swap the header. 
[mcp_servers.kapso]
url = "https://api.kapso.ai/mcp"
env_http_headers = { "X-API-Key" = "KAPSO_API_KEY" }

​
Tools

Project MCP exposes grouped tools. Most tools accept an action and params.
ToolActions
statusShows auth, project status, customer count, WhatsApp number count, and next steps
search_docsSearches Kapso and WhatsApp docs
customershelp, list, get, create, update, delete
setup_linkshelp, list, create, update, revoke
whatsapp_numbershelp, list, get, resolve, health, start_setup, create, update, delete
whatsapp_conversationshelp, list, get, set_status
whatsapp_messageshelp, list, get, send, mark_read
whatsapp_templateshelp, list, get, create
whatsapp_webhookshelp, list, get, create, update, delete
Use action: "help" on grouped tools to get required params, optional params, and examples.

​
Examples

Ask your agent to check setup: 
Use the kapso MCP server to check my project status and tell me the next action.
Ask your agent to create a setup link: 
Use kapso setup_links with action=create for the default customer, then return the setup URL.
Ask your agent to read and send WhatsApp messages: 
Use kapso whatsapp_conversations to list recent active conversations, then use whatsapp_messages to read the latest inbound messages.

Use kapso whatsapp_messages with action=send to send "Hello from Kapso" to +15551234567 from my connected WhatsApp number.

​
Project MCP vs Docs MCP

ServerEndpointUse it for
Project MCPhttps://api.kapso.ai/mcpOperating WhatsApp numbers with browser sign-in or an API key
Docs MCPhttps://docs.kapso.ai/mcpDocumentation lookup only
Use the CLI when your agent has terminal access. Use Project MCP when your agent supports MCP and should operate Kapso directly.