KosmoKrator

productivity

WhatsApp Business MCP Gateway for AI Agents

Expose WhatsApp Business tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

WhatsApp Business MCP Gateway

Expose WhatsApp Business to MCP clients with `kosmokrator mcp:serve --integration=whatsapp`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=whatsapp --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-whatsapp": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=whatsapp",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=whatsapp --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__whatsapp__whatsapp_send_message whatsapp.whatsapp_send_message Write write
integration__whatsapp__whatsapp_send_template whatsapp.whatsapp_send_template Write write
integration__whatsapp__whatsapp_send_message_payload whatsapp.whatsapp_send_message_payload Write write
integration__whatsapp__whatsapp_mark_message_read whatsapp.whatsapp_mark_message_read Write write
integration__whatsapp__whatsapp_get_message whatsapp.whatsapp_get_message Read read
integration__whatsapp__whatsapp_check_contacts whatsapp.whatsapp_check_contacts Read read
integration__whatsapp__whatsapp_list_contacts whatsapp.whatsapp_list_contacts Read read
integration__whatsapp__whatsapp_upload_media whatsapp.whatsapp_upload_media Write write
integration__whatsapp__whatsapp_get_media whatsapp.whatsapp_get_media Read read
integration__whatsapp__whatsapp_delete_media whatsapp.whatsapp_delete_media Write write
integration__whatsapp__whatsapp_list_templates whatsapp.whatsapp_list_templates Read read
integration__whatsapp__whatsapp_get_template whatsapp.whatsapp_get_template Read read
integration__whatsapp__whatsapp_create_template whatsapp.whatsapp_create_template Write write
integration__whatsapp__whatsapp_update_template whatsapp.whatsapp_update_template Write write
integration__whatsapp__whatsapp_delete_template whatsapp.whatsapp_delete_template Write write
integration__whatsapp__whatsapp_get_phone_number whatsapp.whatsapp_get_phone_number Read read
integration__whatsapp__whatsapp_list_phone_numbers whatsapp.whatsapp_list_phone_numbers Read read
integration__whatsapp__whatsapp_request_verification_code whatsapp.whatsapp_request_verification_code Write write
integration__whatsapp__whatsapp_verify_code whatsapp.whatsapp_verify_code Write write
integration__whatsapp__whatsapp_register_phone_number whatsapp.whatsapp_register_phone_number Write write
integration__whatsapp__whatsapp_deregister_phone_number whatsapp.whatsapp_deregister_phone_number Write write
integration__whatsapp__whatsapp_get_business_profile whatsapp.whatsapp_get_business_profile Read read
integration__whatsapp__whatsapp_update_business_profile whatsapp.whatsapp_update_business_profile Write write
integration__whatsapp__whatsapp_list_subscribed_apps whatsapp.whatsapp_list_subscribed_apps Read read
integration__whatsapp__whatsapp_subscribe_app whatsapp.whatsapp_subscribe_app Write write
integration__whatsapp__whatsapp_unsubscribe_app whatsapp.whatsapp_unsubscribe_app Write write
integration__whatsapp__whatsapp_get_current_user whatsapp.whatsapp_get_current_user Read read
integration__whatsapp__whatsapp_api_get whatsapp.whatsapp_api_get Read read
integration__whatsapp__whatsapp_api_post whatsapp.whatsapp_api_post Write write
integration__whatsapp__whatsapp_api_delete whatsapp.whatsapp_api_delete Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.