Whatify MCP Server

An MCP (Model Context Protocol) server that exposes Whatify's WhatsApp API — sending messages, templates, and Flows, plus reading contacts, conversations, campaigns, and wallet balance — as tools for MCP-compatible AI clients (Claude Desktop, Claude Code, etc.).

It's a thin wrapper around the existing v1/external REST API (app/Http/Controllers/Api/ExternalApiController.php), authenticated the same way: an API key generated from Settings → API Keys in the Whatify dashboard.

Tools

send_flow and reading flows require the API key to have the send_flow / read_flows permissions (added alongside this server — check the boxes when generating a key in Settings → API Keys).

Related MCP server: MCP WhatsApp

Setup

1. Get an API key: log into Whatify → Settings → API Keys → generate a key with the permissions you want the AI tool to have (e.g. send_message, send_template, send_flow, read_contacts).

2. Install dependencies:

   cd mcp-server
   npm install

3. Configure environment variables:

   • WHATIFY_API_KEY — the key from step 1 (required)

   • WHATIFY_API_BASE_URL — defaults to http://localhost/api/v1/external; set this to your real app URL, e.g. https://whatify.in/api/v1/external

Using with Claude Desktop / Claude Code

Add to your MCP client config (e.g. claude_desktop_config.json, or via claude mcp add for Claude Code):

{
  "mcpServers": {
    "whatify": {
      "command": "node",
      "args": ["C:/xampp/htdocs/whatify/mcp-server/src/index.js"],
      "env": {
        "WHATIFY_API_KEY": "wk_xxxxxxxxxxxxxxxx",
        "WHATIFY_API_BASE_URL": "https://whatify.in/api/v1/external"
      }
    }
  }
}

Restart the client, then ask it to send a message, e.g.:

"Using Whatify, send a WhatsApp message to +91XXXXXXXXXX saying the order has shipped."

Manual test

You can talk to the server directly over stdio for debugging:

npm start

then send newline-delimited JSON-RPC (initialize, tools/list, tools/call) on stdin. Easier: use the MCP Inspector:

npx @modelcontextprotocol/inspector node src/index.js