ChatRail

Official13 tools

by chatrail · TypeScript

Inspect WhatsApp connections, groups, message delivery, schedules and webhooks in ChatRail.

Model Context Protocol (MCP) Server: dev.chatrail/chatrail

This MCP server provides tools to inspect WhatsApp connections, groups, message delivery, schedules, and webhooks in ChatRail. It is identified by the slug dev-chatrail-chatrail and exposes a description focused on monitoring these WhatsApp-related operational components.

🛠️ Key Features

Inspect WhatsApp connections
Inspect WhatsApp groups
Inspect message delivery
Inspect schedules
Inspect webhooks

🚀 Use Cases

Review the status of WhatsApp connections
Verify group-related configuration or presence
Check message delivery outcomes
Audit scheduled messaging behavior
Examine webhook activity and events

⚡ Developer Benefits

Centralizes inspection of ChatRail’s WhatsApp monitoring areas
Uses MCP for programmatic access to connection, delivery, schedule, and webhook information

⚠️ Limitations

No tool count or additional implementation details were provided in the source data

Topics

ai-agentschatrailmcpmcp-servermodel-context-protocolwhatsappwhatsapp-api

Declared in the repository manifest (tools.json). Not verified against a live endpoint.

list_connections

Every WhatsApp connection in the workspace with its current state and health. Phone numbers are not included.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_connection

One connection, with its state, health and recent state history.

Parameters1

connection

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "connection": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    }
  },
  "required": [
    "connection"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_whatsapp_groups

A bounded page of groups visible to one connected WhatsApp number. Returns group names, stable group ids and participant counts when available; participant identities are never returned.

Parameters3

connection	string	required
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "connection": {
      "type": "string",
      "minLength": 2,
      "maxLength": 40
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    }
  },
  "required": [
    "connection"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_whatsapp_group

Name, description, settings and member counts for one group a connected number is in. Like list_whatsapp_groups, it never returns who the members are.

Parameters2

connection	string	required
group_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "connection": {
      "type": "string",
      "minLength": 2,
      "maxLength": 40
    },
    "group_id": {
      "type": "string",
      "minLength": 5,
      "maxLength": 40
    }
  },
  "required": [
    "connection",
    "group_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_messages

Recent messages with their delivery state. Message bodies and recipient numbers are deliberately excluded.

Parameters5

connection	string	optional
status	string	optional
direction	string	optional
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "connection": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "direction": {
      "type": "string",
      "enum": [
        "inbound",
        "outbound"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "maxLength": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_message

One message and its delivery timeline. The body is not returned.

Parameters1

message_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "message_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explain_message_failure

A structured explanation derived from the failure classification recorded when the message failed. Deterministic — it does not summarise logs.

Parameters1

message_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "message_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_scheduled_messages

Messages waiting to be sent, soonest first.

Parameters2

limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "maxLength": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_webhook_deliveries

Recent customer webhook deliveries and their outcomes. Payloads and endpoint URLs are not returned.

Parameters2

status	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "delivered",
        "failed",
        "dead",
        "skipped"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reschedule_message

Change when a scheduled message will be sent. Returns a preview of the change; pass confirm: true to apply it.

Parameters3

message_id	string	required
send_at	string	required
confirm	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "send_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "message_id",
    "send_at"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_scheduled_message

Cancel a message that has not yet been sent. Returns a preview; pass confirm: true to apply it.

Parameters2

message_id	string	required
confirm	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "message_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

react_to_message

Set this number's emoji reaction on a message it sent or received, or remove it with an empty emoji. The person in the chat sees it. Returns a preview; pass confirm: true to apply.

Parameters3

message_id	string	required
emoji	string	required
confirm	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "emoji": {
      "type": "string",
      "maxLength": 16
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "message_id",
    "emoji"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

replay_webhook

Return a dead or skipped webhook delivery to the queue. Returns a preview; pass confirm: true to apply it.

Parameters2

delivery_id	string	required
confirm	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "delivery_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "delivery_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md6 KBView on GitHub

ChatRail MCP server

Operate a ChatRail workspace from Claude, Cursor, VS Code and any other Model Context Protocol client. Check the health of your WhatsApp connections, look up groups, trace why a message failed, manage scheduled messages and replay webhook deliveries without leaving your editor.

ChatRail is a WhatsApp API for developers: send and receive WhatsApp messages over HTTP from a number you already have. See the MCP documentation for the full reference.

Privacy by design

Message bodies, recipient phone numbers and credentials are never returned by any tool.
Tools that change state return a preview first and apply only when called again with confirm: true.
Every call is scoped to one workspace and recorded in its audit log.

Two ways to connect

1. Hosted server with OAuth (recommended)

Point any client that supports remote MCP servers at:

code

https://www.chatrail.dev/v1/mcp

Your client opens a browser window where a workspace owner, admin or developer approves access. Nothing to install and no key to copy.

Claude Code

bash

claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp

Cursor (~/.cursor/mcp.json)

json

{
  "mcpServers": {
    "chatrail": { "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

VS Code (.vscode/mcp.json)

json

{
  "servers": {
    "chatrail": { "type": "http", "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

2. Local stdio server with an API key

For clients that only run local servers, or when you would rather use an API key. This package runs on your machine and forwards requests to the hosted server.

In the ChatRail dashboard, create a workspace API key with the mcp:read scope. Add mcp:write if the assistant may reschedule, cancel, react or replay.
Add the server to your client.

Claude Desktop (claude_desktop_config.json)

json

{
  "mcpServers": {
    "chatrail": {
      "command": "npx",
      "args": ["-y", "chatrail-mcp"],
      "env": { "CHATRAIL_API_KEY": "cr_live_..." }
    }
  }
}

The package is published on npm as chatrail-mcp, so npx fetches it from the registry. If you need a version that is not published yet, run it straight from the repository instead:

json

"args": ["-y", "github:chatrail/chatrail_mcp"]

Docker

bash

docker build -t chatrail-mcp .
docker run -i --rm -e CHATRAIL_API_KEY=cr_live_... chatrail-mcp

Variable	Required	Description
`CHATRAIL_API_KEY`	Yes, to call tools	Workspace API key with `mcp:read` (and optionally `mcp:write`).
`CHATRAIL_MCP_URL`	No	Override the endpoint. Defaults to `https://www.chatrail.dev/v1/mcp`.

Without a key the server still starts and lists its tools, so you can inspect it before signing up.

Tools

Tool	Scope	What it does
`list_connections`	read	Every WhatsApp connection in the workspace with its state and health.
`get_connection`	read	One connection with its state, health and recent state history.
`list_whatsapp_groups`	read	Groups visible to a connected number, with ids and participant counts.
`get_whatsapp_group`	read	Name, description, settings and member counts for one group.
`list_messages`	read	Recent messages with their delivery state.
`get_message`	read	One message and its delivery timeline.
`explain_message_failure`	read	A structured explanation of why a message failed.
`list_scheduled_messages`	read	Messages waiting to be sent, soonest first.
`list_webhook_deliveries`	read	Recent webhook deliveries and their outcomes.
`reschedule_message`	write	Change when a scheduled message is sent. Previews first.
`cancel_scheduled_message`	write	Cancel a message that has not been sent. Previews first.
`react_to_message`	write	Set or remove an emoji reaction on a message. Previews first.
`replay_webhook`	write	Requeue a dead or skipped webhook delivery. Previews first.

Plans

MCP access is included on the ChatRail Core + AI and Team plans. See pricing.

Development

bash

npm install
npm run build
CHATRAIL_API_KEY=cr_test_... node dist/index.js

tools.json is the tool catalog served when no API key is configured. It is exported from the hosted server and should be refreshed when the hosted tools change.

Agent skill

ChatRail publishes a skill file that tells an agent when to use ChatRail, what a person has to set up, how to send and receive, and the rules for sending. This MCP server operates a workspace and cannot send messages, so the skill points to the REST API for sending.

Give your agent this line:

code

Read https://www.chatrail.dev/SKILL.md and follow it to set up ChatRail.

Or install it with the skills CLI, which installs agent skills from a GitHub repository:

bash

npx skills add chatrail/chatrail_mcp

Or copy it into Claude Code by hand:

bash

mkdir -p ~/.claude/skills/chatrail
curl -fsSL https://www.chatrail.dev/SKILL.md -o ~/.claude/skills/chatrail/SKILL.md

The canonical file is https://www.chatrail.dev/SKILL.md. A copy lives in this repository at skills/chatrail/SKILL.md so tools that install skills from GitHub can find it.

License

MIT

Install

Tools (13)

list_connectionsget_connectionlist_whatsapp_groupsget_whatsapp_grouplist_messagesget_messageexplain_message_failurelist_scheduled_messages

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.chatrail.dev/v1/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "chatrail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatrail.dev/v1/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ChatRail

Model Context Protocol (MCP) Server: dev.chatrail/chatrail

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_connections

get_connection

list_whatsapp_groups

get_whatsapp_group

list_messages

get_message

explain_message_failure

list_scheduled_messages

list_webhook_deliveries

reschedule_message

cancel_scheduled_message

react_to_message

replay_webhook

ChatRail MCP server

Privacy by design

Two ways to connect

1. Hosted server with OAuth (recommended)

2. Local stdio server with an API key

Tools

Plans

Development

Agent skill

Links

License

Install

Remote endpoint

Related servers