Skip to main content
Chatarmin MCP lets you connect an AI assistant to your organization so it can read campaigns, contacts, flows, chats, and analytics—and run approved actions like sending messages or publishing flows—through natural language.

​
When to use it

Use Chatarmin MCP when you want an AI assistant (Cursor, Claude, ChatGPT, VS Code, or similar) to work with your live Chatarmin data without copying exports or switching between tools.
OAuth is the recommended connection method. You sign in to Chatarmin once and approve access—no manual API token setup required.

​
What changed

Chatarmin now ships a dedicated MCP area in your account:
  • Profile → MCP shows your MCP endpoint URL, OAuth configuration, and what your assistant can do.
  • OAuth consent screen — when you click Connect in your AI client, you sign in to Chatarmin and approve access for that client (for example Cursor or Claude).
  • Static Bearer token (advanced) — for clients that do not support OAuth, you can use the same API token from Profile → Settings → API token.
Profile sidebar with the MCP tab selected and Beta badge visible
The MCP server endpoint is:

​
What your assistant can do

Tools are scoped to your Chatarmin organization. Capabilities include:

Campaigns & messaging

List campaigns, inspect metrics, preview audience size, create or pause campaigns, read WhatsApp chats, send messages, and trigger flows.

Contacts & audience

Search contacts, view audience stats, list tags and segments with live counts, create tags, and preview segment sizes.

Flows & templates

Create and update flow drafts, publish flows, read analytics and run traces, and draft or submit WhatsApp templates for Meta approval.

Analytics & orders

Pull dashboard KPIs, campaign performance metrics, and search attributed orders by campaign, flow, or contact.
Write actions (send message, publish flow, create campaign, and similar) run when the assistant calls a tool. Review prompts carefully and confirm destructive actions in your AI client before approving.

​
Set it up

​
Watch the walkthrough

Open Profile and select the MCP tab
1

Open MCP settings in Chatarmin

In Chatarmin, go to Profile → MCP.
Chatarmin Profile MCP page showing capabilities and connection settings
Copy the MCP endpoint URL or the OAuth config JSON from that page.
2

Add the server in your AI client

Follow the connection guide for your tool:
3

Connect and approve access

In your AI client, click Connect (or equivalent). Your browser opens the Chatarmin consent screen.
Chatarmin MCP OAuth consent screen showing Cursor requesting access to Demo Store
Sign in if needed, review the permissions, and click Allow access.
4

Start using Chatarmin tools

After authorization, Chatarmin tools appear in your assistant. Ask questions like “How did last week’s campaign perform?” or “List contacts who messaged us in the last 7 days.”

​
Advanced: static Bearer token

Only use this if your AI client does not support OAuth Connect.
  1. Open Profile → Settings and copy your API token.
  2. Add the MCP URL with an Authorization header in your client config:
Replace YOUR_API_TOKEN with your token. The same Bearer example is available on Profile → MCP.

​
Troubleshooting

Missing authorization state — Start again from your AI client’s Connect button. Do not refresh the consent page manually. Authorization request expired — OAuth states are short-lived. Click Connect in your AI client again. Session expired on consent screen — Sign in to Chatarmin, then retry Connect from your AI client. Tools do not appear — Confirm the MCP URL is exactly https://api.chatarmin.com/api/mcp, complete OAuth, and restart or reload MCP in your client. Need help? Contact support through your Chatarmin dashboard or see Connect Chatarmin MCP to AI tools.