MCP server

Connect AI agents to Whatsly with controlled messaging tools.

The Whatsly MCP server lets approved MCP clients send messages, inspect devices, and read conversations through your existing Whatsly API permissions.

Setup guide Sign up

Install

npx @whatsly/mcp-server

API credentialsPlan gatedStdio transport

Install

Run the package with npx from your MCP-compatible client.

Add credentials

Use a scoped Whatsly API key and optional bearer token for reads.

Enable the plan feature

MCP access must be enabled on the workspace plan.

Client config

Add Whatsly to your MCP client.

Keep secrets in your local MCP client configuration or secret manager. Use placeholders in shared docs and never commit real API credentials.

{
  "mcpServers": {
    "whatsly": {
      "command": "npx",
      "args": ["-y", "@whatsly/mcp-server"],
      "env": {
        "WHATSLY_API_BASE_URL": "https://api.whatsly.mysaas.tools",
        "WHATSLY_API_KEY_ID": "<api-key-id>",
        "WHATSLY_API_KEY_SECRET": "<api-key-secret>",
        "WHATSLY_TENANT_ID": "<tenant-id>",
        "WHATSLY_DEFAULT_DEVICE_ID": "<device-id>",
        "WHATSLY_BEARER_TOKEN": "<bearer-token>"
      }
    }
  }
}

Available tools

A focused toolset for business messaging.

Send tools create real customer-facing messages. Read tools require bearer authentication and tenant context.

whatsly_send_text_message

whatsly_send_template_message

whatsly_send_media_message

whatsly_get_device_status

whatsly_list_conversations

whatsly_get_conversation_messages