Skip to content
MCP server

ChatRail

Inspect WhatsApp connections, delivery, schedules and webhooks in a ChatRail workspace

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Version
0.1.0
Listing updated
1 day ago

About ChatRail

ChatRail is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://www.chatrail.dev/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chatrail": {
      "url": "https://www.chatrail.dev/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Free Sandbox plan; paid plans per connected number, MCP tools on Core + AI and Team

Prices change. Check chatrail.dev before you buy.

ChatRail 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 to ChatRail

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools