This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
dibaMCP is a Model Context Protocol server that lets Claude, Cursor and any other MCP client send and read messages on Iranian messengers. It ships with a Persian dashboard for managing bots, testing tools and following conversations.
Four messengers | Bale, Eitaa, Rubika and Soroush Plus: text, photos, files and location |
Inbox | Incoming and outgoing messages per chat, one-click |
Media from anywhere | Send by link, by |
Full self-test | Network, token, chat, send and receive checked step by step, with hints for each failure |
Runs outside Iran | SOCKS5 / HTTP proxy support and a reachability check for every API |
Two transports | Streamable HTTP for remote clients, stdio for Claude Desktop |
Safe by default | Hashed admin password, signed sessions, rate limits, tokens never leave the server |
Embeddable | Mount it as an Express router inside your own app |
Related MCP server: telegram-mcp
Requires Node.js 22.19 or newer.
npm i -g https://github.com/yunessfa/diba-MCP/releases/download/v0.5.0/diba-mcp-0.5.0.tgz
diba-mcpOpen http://127.0.0.1:3790. On first run a six-character setup code is printed in the terminal; use it to create the dashboard password. Then add your bot tokens under Messengers and copy the MCP endpoint from Connect.
docker run -d --name diba-mcp -p 127.0.0.1:3790:3790 \
-e ADMIN_PASSWORD=change-me \
-v diba-mcp-data:/app/data \
ghcr.io/yunessfa/diba-mcp:latestA docker-compose.yml with optional HTTPS (Caddy) is included. See DEPLOY.md.
git clone https://github.com/yunessfa/diba-MCP.git
cd diba-MCP
npm ci
cp .env.example .env
npm run devClaude Code
claude mcp add --transport http diba-mcp http://127.0.0.1:3790/mcp \
--header "Authorization: Bearer <MCP_TOKEN>"Cursor and other JSON-configured clients
{
"mcpServers": {
"diba-mcp": {
"url": "http://127.0.0.1:3790/mcp",
"headers": { "Authorization": "Bearer <MCP_TOKEN>" }
}
}
}Claude Desktop (stdio)
{ "mcpServers": { "diba-mcp": { "command": "diba-mcp", "args": ["stdio"] } } }The token is shown on the Connect page, or run diba-mcp token.
Inbox | Tool playground |
Messengers and self-test | Dark theme |
Messenger | Tools |
Bale |
|
Soroush Plus |
|
Eitaa |
|
Rubika |
|
All |
|
Set a default chat for a messenger and chat_id becomes optional. Eitaa (through Eitaayar) can only post to channels and groups and cannot receive messages.
Command | Description |
| Start the dashboard and the MCP endpoint |
| Run over stdio |
| Run the full self-test |
| Check whether this machine can reach each messenger API |
| Print the MCP token |
| Clear the dashboard password |
Options: --port, --host, --data <dir> (default ~/.diba-mcp), --env <file>.
Everything can be set from the dashboard. Environment variables take priority and lock the matching field.
Variable | Default | Description |
| Dashboard password (otherwise created with the setup code) | |
| generated | Bearer token for MCP clients |
|
| Listen address |
|
| Config, logs and inbox |
| Route messenger traffic through a proxy | |
| Per messenger: | |
|
| Requests per minute to |
|
| Send-type tool calls per minute from the model |
|
| Days of call logs to keep |
|
| Allow media downloads from internal addresses |
import express from "express";
import { createDibaMcp } from "diba-mcp";
const app = express();
const diba = createDibaMcp({ dataDir: "./data/diba" });
app.use("/diba", diba.router());
await diba.engine.callTool("bale_send_message", { text: "New order received" }, "dashboard");Adding a messenger or any other service is one file in src/providers/ that exports a ProviderDef; the settings form, playground and MCP tools are generated from it.
npm run dev # watch mode
npm test # unit + end-to-end tests
npm run typecheck
npm run buildsrc/
├─ core/ engine, config store, inbox, media, network, auth, self-test
├─ providers/ bale, eitaa, rubika, soroush
├─ http/ Express router: /mcp, /api, dashboard
├─ cli.ts diba-mcp command
└─ index.ts library entry
public/ dashboard (plain HTML, CSS and JS, no build step)
test/ unit tests and an end-to-end test with a real MCP clientMessengers: text, media, inbox, self-test
Buttons and a bot menu builder
SMS: Kavenegar, SMS.ir
Payments: Zarinpal, IDPay
Offline tools: national ID, Sheba, Jalali dates
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Send and read WhatsApp, email and SMS from Claude, ChatGPT, Cursor or any MCP client, from your own accounts: your WhatsApp number (linked by QR code), your mailbox (IMAP/SMTP) and your Android phone (SMS from its SIM). Tools: list-accounts, get-account, add-account, add-email-account, list-messages, send-message (one channel or several in one call). Hosted, OAuth 2.1, nothing to install. Free plan with unlimited messages; paid plans from 19 EUR/month remove the footer and add media and webhooks. Docs and client configs: github.com/UnlimitedMessaging/unlimited-messaging-mcp
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
