Skip to main content
Chatarmin MCP connects an AI tool such as Claude, ChatGPT, Claude Code, Codex, Cursor or VS Code to your Chatarmin organization. Ask it how last week’s campaign performed, who messaged you yesterday or which flow loses the most contacts, and let it draft campaigns, flows and WhatsApp templates for you. It uses the Model Context Protocol (MCP). Each organization has its own server address:
Copy the exact address from the MCP page in Chatarmin.

Who can connect

Chatarmin MCP is available for every organization.
  • Open MCP in the dashboard sidebar. It opens the MCP tab of your account page, with your server address and the buttons Copy MCP URL and Copy OAuth config.
  • Anyone on your team who can sign in to the organization can connect an AI tool. Talk to your team about who connects which tool.
  • A connection works for the whole organization, not only for the person who approved it. Your AI tool gets the same tools whoever connected it.
  • Sending a single WhatsApp message from your AI tool (chatarmin_send_whatsapp) is a paid feature and works only when API message sending is enabled for your account. To enable it, contact support@chatarmin.com. All other tools work without it.
Chatarmin MCP page with capabilities, endpoint URL and copy buttons

Connect your AI tool

Use your organization’s address from the MCP page wherever YOUR_ORGANIZATION_ID appears below.
In Claude Desktop or on claude.ai, open Settings → Connectors → Add custom connector. Enter the name Chatarmin, paste your server address and connect. Then sign in to Chatarmin and click Allow access.
Every tool then opens the Chatarmin consent screen:
1

Sign in

Sign in to Chatarmin if you aren’t already. Start from your AI tool’s Connect button; don’t refresh the consent page.
2

Check the request

The Connect MCP screen shows which app asks for access. Allow it only for an app you just started connecting yourself.
Chatarmin MCP consent screen showing an AI tool requesting access to an organization
3

Allow access

Click Allow access. Chatarmin tools now show up in your AI tool.
Step-by-step guides for each tool, including GitHub Copilot, are in Connect Chatarmin MCP to AI tools.

API token for other tools

Use the API token only for tools that can’t sign in with OAuth, such as scripts or older MCP clients.
  1. Open your account page, go to Settings and copy the API Token (or click Create API Token).
  2. Send it with every request to your server address:
The MCP page has the same example under Advanced — static Bearer token. Copy Bearer configuration copies it with your real token.
The API token is your organization’s token for the Chatarmin API too. Anyone who has it can use every MCP tool for your organization until it expires; the expiry date shows under API Token. Keep it out of shared files and chats.

What your AI tool can access

Chatarmin MCP has one access level: a connected tool can use every tool below for your organization. There is no read-only connection. Tools that change data are marked as such in your AI tool, so it can ask you before using them.

First steps

Ask your AI tool:
  • “How did our campaigns perform in the last 30 days?”
  • “Which customers messaged us yesterday and haven’t had a reply?”
  • “Which step of our welcome flow loses the most contacts?”
  • “Draft a campaign for contacts tagged VIP with our newest approved template. Show me the audience first and don’t send it.”

Stay in control

Your AI tool reaches your customers with three tools: it sends a single WhatsApp message, sends or schedules a campaign, or triggers a flow for one phone number. Chatarmin adds these safeguards:
  • Campaigns. A campaign is sent or scheduled only when the call confirms that you approved it. Without that, your AI tool can save it as a draft or check it without creating anything. It uses only approved WhatsApp templates.
  • 24-hour window. A free-form message or media goes out only while the customer’s 24-hour window is open. Outside it, only an approved template can start the conversation.
  • Flows. New flows are inactive drafts. A flow runs for your contacts only after it’s published and turned on. Deleting a flow needs a confirmation in the call.
  • Templates. New templates are drafts until you submit them, and Meta reviews them before you can use them. Deleting a template needs a confirmation in the call and also deletes it at WhatsApp.
  • Right organization. Every change names your organization. Chatarmin refuses it for any other organization and changes nothing.
  • Rate limit. Your AI tool can make up to 120 requests a minute.
Sending a single message and triggering a flow have no confirmation step in Chatarmin. Whether a person approves each call depends on your AI tool. Keep its approval prompt on for tools that change data, and don’t let it auto-approve them.

Disconnect

To stop using Chatarmin in an AI tool, remove the Chatarmin server or connector in that tool. Chatarmin doesn’t list connected AI tools yet, and you can’t end a single connection from Chatarmin. Access you approved stays valid until it expires, up to 700 days after you clicked Allow access. Connect only AI tools and devices you trust. If you think an AI tool or your API token is misused, email support@chatarmin.com.

Troubleshooting

Missing authorization state: start again from your AI tool’s Connect button. Don’t refresh the consent page. Authorization request expired: the request is valid for one hour. Click Connect in your AI tool again. Session expired on the consent screen: sign in to Chatarmin, then retry Connect from your AI tool. Tools don’t appear: check that you used the full address from the MCP page, including the ID after /api/mcp/, finish the sign-in, then reload MCP in your AI tool. “Access token is not valid for this MCP organization”: the address names a different organization than the one you approved. Copy the address again from the MCP page of the right organization and reconnect. “Sending messages via the API is a paid feature”: API message sending isn’t enabled for your account. Contact support@chatarmin.com. Other tools still work. “Too many MCP requests, please slow down.”: your AI tool went over 120 requests a minute. Wait a minute and try again. Need help? Email support@chatarmin.com.