# ChatRail

> ChatRail is a freemium MCP server for communication. Inspect WhatsApp connections, delivery, schedules and webhooks in a ChatRail workspace. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://www.chatrail.dev/mcp
- **Repository:** https://github.com/chatrail/chatrail_mcp
- **MCP Registry name:** dev.chatrail/chatrail
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-16

## About

This is an operator interface for ChatRail, a developer API that sends WhatsApp messages through a Linked Devices session rather than Meta's official Cloud API. The vendor says MCP is for inspecting and managing a workspace, and that production applications should use its HTTPS API and webhooks; sending itself goes through the REST API.

Tools cover connection state and history, group lookup, recent messages with a delivery timeline, a structured explanation of why a message failed, scheduled messages and webhook delivery outcomes. Write-scoped tools can reschedule or cancel messages, react, and replay webhook deliveries, always previewing first and applying only when called again with confirm set to true.

By design, no tool returns message bodies, recipient phone numbers or credentials. Every call is scoped to a single workspace and logged in an audit trail, and results are size-bounded. Access is through OAuth 2.1 with workspace consent or a dedicated API key with mcp:read and mcp:write scopes; an npm package and Docker image forward to the hosted server.

## Features

- **Connection health:** List connections and inspect state, health and recent history.
- **Failure explanation:** Get a structured reason a message failed to deliver.
- **Webhook replay:** Review webhook deliveries and replay them safely.
- **Scheduled message control:** List, reschedule or cancel messages waiting to send.
- **Confirm-before-change:** Mutating tools preview first and need a second confirmation.
- **Privacy limits:** Message bodies and phone numbers are never returned.

## Good for

- Find out why a WhatsApp alert did not arrive
- Check whether a number's session is healthy
- Reschedule a queued message from your editor
- Replay a failed webhook delivery

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
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"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chatrail": {
      "serverUrl": "https://www.chatrail.dev/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `list_connections`: List WhatsApp connections with state and health
- `get_connection`: Get one connection with recent history
- `list_whatsapp_groups`: List groups visible to a connected number
- `get_whatsapp_group`: Get one group's details
- `list_messages`: List recent messages with delivery state
- `get_message`: Get one message and its delivery timeline
- `explain_message_failure`: Explain why a message failed
- `list_scheduled_messages`: List messages waiting to send
- `list_webhook_deliveries`: List recent webhook deliveries
- `reschedule_message`: Change when a scheduled message is sent

## FAQ

### Is it the official WhatsApp API?

No. ChatRail uses a WhatsApp Linked Devices session, not the official Meta Cloud API.

### Can the assistant read my messages?

No. Message bodies, recipient numbers and credentials are never returned by any tool.

### How do I connect?

Use the hosted URL with OAuth, or the chatrail-mcp npm package with a workspace API key.

### What does ChatRail cost?

It starts with a free Sandbox plan; paid plans are priced per connected number, with MCP tools in Core + AI and Team.

### Is ChatRail free?

ChatRail has a free plan, with paid plans for more usage or features.

### How do I add ChatRail to Claude Code?

Run this command in your terminal: claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp

### What are the best alternatives to ChatRail?

The closest alternatives to ChatRail are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/chatrail
