sinores-wp-mcp

Give your AI agent access to WhatsApp.

Self-hosted WhatsApp gateway with a built-in MCP server. Connect a number, point your agent at one endpoint, and start building.

Quick start · MCP setup · Hosted Sinores · Contributing

sinores-wp-mcp is the open-source edition of Sinores. It turns a WhatsApp number into tools that any MCP-compatible AI agent can use. Your agent can discover connected channels, check their status, send messages, and read message history-all through a standard Model Context Protocol endpoint.

No Docker. No Postgres. No Redis. One Node.js process and one port.

Want it managed for you? Sinores Cloud is the hosted, production-ready service. This repository is the free, MIT-licensed core for developers who prefer to run everything themselves.

Why Sinores Open?

• Built for AI agents - MCP is included, not bolted on as an afterthought.

• Start in minutes - install dependencies, add one token, and scan a QR code.

• Keep control of your data - messages, credentials, and sessions stay on your machine.

• Simple by design - the dashboard, API, MCP server, database, and WhatsApp connection run together.

• Works with any MCP client - use it with your favorite agent, IDE, or custom automation.

• Open source - inspect it, extend it, and ship your own integrations under the MIT license.

Related MCP server: WAHA MCP

What you get

Quick start

Requirements

• Node.js 22 or newer

• A WhatsApp account that can link a companion device

Run locally

git clone https://github.com/karl4th/sinores-wp-mcp.git
cd sinores-wp-mcp
npm install
cp .env.example .env.local

Generate a secure admin token:

openssl rand -hex 32

Put the result in .env.local:

ADMIN_TOKEN=your-generated-token

Start Sinores Open:

npm run dev

Open http://localhost:3000, sign in with your admin token, create a channel, and scan the QR code from WhatsApp → Linked devices → Link a device.

For a production-style local run:

npm run build
npm start

Connect an AI agent

Sinores exposes a Streamable HTTP MCP endpoint at:

http://localhost:3000/api/mcp

Configure your MCP client with the endpoint and bearer token. The exact config shape depends on the client, but the connection values are:

{
  "url": "http://localhost:3000/api/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_ADMIN_TOKEN"
  }
}

Once connected, the agent receives four tools:

Start with list_channels to get a channelId, then pass that ID to the other tools.

How it works

flowchart LR
    A["AI agent"] -->|"MCP over HTTP"| S["Sinores Open"]
    U["Web dashboard"] --> S
    S --> M["WhatsApp via Baileys"]
    S --> D[("SQLite")]

• Next.js serves the dashboard, REST routes, and MCP endpoint.

• Baileys manages WhatsApp companion-device sessions.

• SQLite stores channels and message history in ./data by default.

• The MCP SDK exposes agent tools from the same application process.

Configuration

See .env.example for a ready-to-copy configuration file.

Open source or hosted?

Security notes

• Treat ADMIN_TOKEN as a password: anyone who has it can access every connected channel.

• Do not commit .env.local, the data directory, or Baileys session credentials.

• Use HTTPS and set COOKIE_SECURE=true when exposing an instance outside your local network.

• This project uses Baileys, an unofficial WhatsApp Web API. It is not affiliated with or endorsed by WhatsApp or Meta. Review WhatsApp's terms and use it responsibly.

Contributing

Issues and pull requests are welcome. If you have an idea, found a bug, or built something interesting with Sinores, open an issue.

If Sinores Open helps you build something useful, please give the repository a star. It helps other developers discover the project and motivates us to keep improving it. ⭐

License

Sinores Open is available under the MIT License.

Built for developers connecting AI agents to the real world.

sinores.net