ChatRail — Claude Code MCP server: what it does, how to install
Monitors WhatsApp connections, inspects delivery issues, and retries webhooks directly inside your AI client. Built for managing ChatRail workspaces without browser tabs.
claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcpWhat ChatRail does
This MCP server links your development client to a ChatRail workspace. It lets your assistant check connection statuses, query group sizes, and diagnose why a specific WhatsApp message failed to reach the recipient. Privacy safeguards are built in. Tool outputs intentionally omit text bodies, phone numbers, and workspace credentials.
State modifications follow a two-step confirmation pattern. Actions like rescheduling a draft, canceling an upcoming message, or replaying a dead webhook display a preview first. The server executes them only when invoked again with confirm: true. Direct message dispatch is not supported through MCP; sending still requires standard REST calls.
Server access demands a ChatRail Core + AI or Team subscription. You can link remotely via OAuth at https://www.chatrail.dev/v1/mcp or launch a local stdio process via the chatrail-mcp npm package using a workspace API key with mcp:read or mcp:write scopes.
What it helps with
- diagnose failed WhatsApp message deliveries
- reschedule or cancel pending queued messages
- replay dropped or failed webhook notifications
- audit WhatsApp connection states across a workspace
Example prompts for the agent
- Why did message
msg_123fail to send? - List upcoming scheduled messages and push the first one back one hour.
- Replay the webhook delivery for
wh_789.
How to install ChatRail
Platform CLI: remote server
claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcpPlatform CLI: remote server
codex mcp add chatrail --url https://www.chatrail.dev/v1/mcpConfig file
{
"mcpServers": {
"chatrail": {
"url": "https://www.chatrail.dev/v1/mcp"
}
}
}Config file
{
"servers": {
"chatrail": {
"type": "http",
"url": "https://www.chatrail.dev/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http chatrail https://www.chatrail.dev/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ChatRail
How to install ChatRail in Claude Code?
Run claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp. Your client will open a browser window to approve OAuth access for your workspace.
What does ChatRail MCP do?
It inspects WhatsApp instance health, traces delivery failures, manages scheduled queues, and replays failed webhooks without exposing message payloads or recipient phone numbers.
Can this MCP server send WhatsApp messages?
No, the server deliberately lacks tools for dispatching new messages. For sending text, ChatRail requires developers to invoke its REST API instead.
