Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt

Use this file to discover all available pages before exploring further.

Project MCP gives AI agents live access to your Kapso project without shell access. Use it when an MCP-capable agent needs to inspect setup, create setup links, manage customers, read conversations, send messages, manage templates, or configure webhooks. Endpoint: 
https://api.kapso.ai/mcp

​
Authentication

Use a project API key from the Kapso dashboard. Accepted headers: 
Authorization: Bearer YOUR_PROJECT_API_KEY

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

​
Connect

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

​
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/mcpLive project operations with a project 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.