Deploy and Host Whapi MCP (Unofficial WhatsApp MCP) on Railway

Keep your WhatsApp number. Keep using your phone. Add AI automation.

Whapi.Cloud connects your existing personal or Business WhatsApp account to AI assistants through MCP. Automate messages, work with conversations, manage groups and publish channel updates while continuing to use WhatsApp normally. This template makes the MCP server accessible remotely through an authenticated HTTPS endpoint.

An API account is required: Register with Whapi.Cloud, connect your number and obtain your channel token. A limited free Sandbox is available. Purchase a paid Whapi.Cloud plan when you need usage beyond its limits. Railway hosting is billed separately.

Why Choose Whapi.Cloud?

A practical alternative to Meta Cloud API or Twilio when your priority is automating an existing WhatsApp account while keeping its everyday app experience.

Benefit	What you get
Use your existing number	Connect a regular personal WhatsApp or WhatsApp Business app account through a linked-device session. No migration to Meta Cloud API is required.
Keep using WhatsApp normally	Continue chatting in the phone app and WhatsApp Web alongside automation. Your normal voice and video calls remain app-based activities.
Keep your telephone service	Linking WhatsApp does not port your telephone number or replace your carrier. Ordinary telephone calls and SMS remain separate from this integration.
No Meta Cloud API or Twilio setup	Connect through the provider’s dashboard and use its API token. You do not need to build a separate Meta or Twilio integration.
No Meta or Twilio messaging charges for this connection	The service uses its own subscription model without per-message charges. Its subscription, Railway hosting and any carrier charges still apply.
Automate groups	Create groups, accept invitations, send group messages and manage participants, subject to account permissions and group settings.
Go beyond individual chats	Work with supported communities, channels, statuses, contacts, reactions and other WhatsApp features.
Add call-related workflows	Trigger brief attention calls, retrieve call information, reject incoming calls and generate group video-call links using supported tools.

Compared with the WhatsApp Business app alone, the added value is programmable access and AI integration: your assistant can perform supported actions without you carrying out each step manually.

Voice and Video Calls: What Is Supported?

You can continue using WhatsApp on your phone for your normal voice and video conversations.

Through the MCP tools, you can:

Request a brief outgoing attention call after enabling it in the channel settings.
Create a group video-call link for participants to open in WhatsApp.
Retrieve call information and reject incoming calls.

The MCP does not carry live voice or video streams. Attention calls are short, automatically terminated call offers; they are not conversations with an AI voice agent. Creating a video-call link does not make the server a participant in the call.

About Hosting Whapi MCP

Railway hosts the MCP server and an authentication proxy exposing Streamable HTTP at /mcp. The server uses your channel API token to connect to Whapi.Cloud, which manages the linked WhatsApp session.

A separate, automatically generated secret protects remote access. No database or persistent volume is required. Keep one replica because MCP sessions and replay buffers are stored in memory. All clients using a deployment share its configured channel credentials.

Your AI client supplies the assistant and workflow logic. Event-driven automations need a separately configured webhook receiver or automation platform.

Common Use Cases

Customer communication: Send replies, appointment reminders and order updates from a compatible AI assistant.
Conversation summaries: Retrieve available messages and identify decisions, unanswered questions or follow-up actions.
Group and community operations: Create groups, manage membership and coordinate communication.
Content publishing: Publish supported channel posts and status updates.
Call coordination: Share video-call links or use attention-call notifications in an appropriate workflow.

Available history and actions depend on the upstream implementation and API availability. This template is not a permanent message archive.

Dependencies for Whapi MCP Hosting

A Whapi.Cloud account, active channel and API token.
A WhatsApp number you control, connected through the dashboard.
A paid Whapi.Cloud plan if your usage exceeds the free Sandbox limits.
A Railway account with sufficient hosting resources.
An MCP client supporting Streamable HTTP and custom authentication headers.

Getting Started

Register with Whapi.Cloud, pair your WhatsApp account through the dashboard and copy the channel API token.
Deploy this template and enter that token as API_TOKEN.
Ensure your Railway public domain targets port 8080.
Connect your MCP client to https://YOUR-RAILWAY-DOMAIN/mcp.
Send the generated MCP_PROXY_API_KEY value in the X-API-Key request header.

Keep both credentials private. The channel token connects the server to Whapi.Cloud; the proxy key gives your client access to the deployed MCP endpoint.

Implementation Details

Remote transport: Authenticated Streamable HTTP.
Health check: /ping checks proxy availability, not the WhatsApp connection.
Storage: No persistent volume; session state is cleared on restart.
Timezone: UTC by default, configurable through TZ.
Updates: Builds resolve the latest published npm packages when installation executes. Existing deployments do not automatically update; cached builds may retain an earlier version.
Source code: Available in the upstream repository.

Why Deploy Whapi MCP on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Whapi MCP on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Credits and Disclosure

The upstream MCP server is developed by Whapi.Cloud and published under the MIT license. See the original repository for source code and license information. The software license does not include a hosted API subscription.

This independently maintained Railway template packages the upstream software for deployment. It is not an official WhatsApp or Meta product and is not endorsed by them. Product names and trademarks belong to their respective owners.

Links to Whapi.Cloud are referral links. The template publisher may receive a commission if you purchase through them.