# Kapso — MCP server on mcp.ai
> Connect your Kapso account and use 10 tools for communication straight from your AI agent. Connect with your own API key. Kapso provides APIs for WhatsApp messaging, customer and contact management, broadcasts, workflows, and serverless functions.

By: mcp.ai · official
Page: https://mcp.ai/kapso

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_kapso?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/kapso/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/kapso/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/kapso/skill.md
Postman collection (v2.1): https://mcp.ai/kapso/postman.json

## Tools
- kapso_get_function(function_id: string) — Retrieve one Kapso serverless function's code, runtime configuration, deployment status, and computed URLs without invoking or changing it.
- kapso_get_phone_number(phone_number_id: string) — Retrieve one Kapso WhatsApp phone-number configuration by its Meta phone number ID.
- kapso_get_phone_number_health(phone_number_id: string) — Run Kapso's live checks for one WhatsApp phone-number configuration and return its body-level health status and individual check results.
- kapso_get_workflow(view?: string, workflow_id: string) — Retrieve one workflow's metadata, full graph definition, or available variables without executing or changing it.
- kapso_list_conversations(limit?: integer, status?: string, unassigned?: boolean, next_cursor?: string, phone_number_id?: string, assigned_user_id?: string, last_active_after?: string, last_active_before?: string, contact_phone_number?: string) — List one page of WhatsApp conversations by recent activity, with filters for phone number, status, assignment, and activity time range.
- kapso_list_customers(per_page?: integer, next_cursor?: string, created_after?: string, name_contains?: string, created_before?: string, external_customer_id?: string) — List Kapso project customers and filter them by name, external customer ID, or creation time. Returns one page and a continuation cursor.
- kapso_list_functions() — List serverless functions configured in the Kapso project, including runtime and deployment state, without returning function source code or invoking any function.
- kapso_list_messages(limit?: integer, status?: string, direction?: string, api_surface?: string, next_cursor?: string, conversation_id?: string, phone_number_id?: string) — List one page of WhatsApp message history project-wide through Kapso Platform or for one phone number through the Meta-compatible proxy. This tool only reads history and never sends messages.
- kapso_list_phone_numbers(per_page?: integer, customer_id?: string, next_cursor?: string, name_contains?: string, phone_number_id?: string, messaging_enabled?: boolean, business_account_id?: string) — List WhatsApp phone-number configurations in the Kapso project, with filters for account, customer, messaging state, and display name.
- kapso_list_workflows(status?: string, created_after?: string, name_contains?: string, created_before?: string) — List project workflows and filter them by lifecycle status, name, or creation time. This read-only action does not execute a workflow.

## Example prompts
- "What can I do in Kapso?"
- "Show me a summary of my Kapso account"

## Links
Docs: https://mcp.ai/docs/mcps/kapso
Website: https://mcp.ai/mcps/kapso