WhatsApp MCP server by Kapso

Tools & SDKs

MCP server

The MCP server is currently in alpha and subject to changes.

Kapso exposes WhatsApp operations and Platform tools through an MCP server using streamable HTTP transport.

• Base URL: https://app.kapso.ai/mcp
• Authentication: Use header X-API-Key: YOUR_API_KEY or Authorization: Bearer YOUR_API_KEY
• Transport: Streamable HTTP only (no SSE)

​

Installation

Replace YOUR_API_KEY with your Kapso project API key.

​

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kapso": {
      "url": "https://app.kapso.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​

Claude Code

claude mcp add --transport http kapso https://app.kapso.ai/mcp \
  --header "X-API-Key: YOUR_API_KEY"

​

VS Code

Add to settings.json:

"mcp": {
  "servers": {
    "kapso": {
      "type": "http",
      "url": "https://app.kapso.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​

Claude Desktop

Settings → Connectors → Add Custom Connector:

• Name: Kapso
• URL: https://app.kapso.ai/mcp
• Headers: X-API-Key: YOUR_API_KEY

​

Zed

{
  "context_servers": {
    "Kapso": {
      "type": "http",
      "url": "https://app.kapso.ai/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

​

Available tools

All tool results return JSON serialized as text. Use response_format: "detailed" for stable IDs when needed.

​

WhatsApp messaging tools

whatsapp_send_text_messageSend text message to existing conversation or recent active conversation by phone. whatsapp_send_templateSend template message with parameters. Can start new conversations. whatsapp_send_mediaSend image, video, audio, or document to existing conversation. whatsapp_send_interactiveSend interactive message with buttons or lists. whatsapp_templatesList/search approved templates with parameter details.

​

WhatsApp operator tools

whatsapp_inboxView inbox for a host number with last message preview and unread count. whatsapp_get_conversation_contextGet conversation metadata and recent messages. Supports batch retrieval. whatsapp_get_contact_contextContact summary with last conversation and recent messages. whatsapp_mark_inbound_readMark messages as read. whatsapp_configs_overviewList host numbers for selection.

​

WhatsApp management tools

whatsapp_search_contactsSearch contacts by name or phone. whatsapp_search_conversationsSearch conversations by phone, name, status, or time. whatsapp_search_messagesSearch message text. whatsapp_contact_add_noteAdd note to contact for triage and follow-ups. whatsapp_contact_updateUpdate contact display name or link to customer. whatsapp_conversation_set_statusUpdate conversation status to active or ended.

​

Platform tools

platform_create_customerCreate new customer. platform_generate_setup_linkGenerate branded setup link for customer WhatsApp connection. platform_list_customersList customers with search and pagination. platform_list_customer_configsList WhatsApp configs for a customer. platform_list_setup_linksList setup links for a customer with status and expiry. platform_revoke_setup_linkRevoke active setup link to invalidate onboarding link.

​

Utility tools

project_infoGet current project ID and name.

​

Authentication

Include the API key header on every request. Find your API keys in Project Settings → API Keys.

​

Response format

By default, responses are concise to reduce token usage. Use response_format: "detailed" when you need stable IDs for follow-up calls. Smart defaults:

• whatsapp_get_conversation_context: Defaults to detailed (you’re requesting specific IDs)
• whatsapp_search_conversations with include_messages: Defaults to detailed (likely need IDs for follow-up)
• All other tools: Default to concise unless specified

Was this page helpful?

YesNo

Kapso extensionsAPI Introduction