OmniBridge MCP (Lite Edition)

Free: Genesis Starter Kit (25 .cursorrules/CLAUDE.md rulesets + MCP configs). Try the live config builder. Full stack: all six servers in Genesis Enterprise Suite ($19).

OmniBridge MCP is a lightweight, zero-latency Model Context Protocol server that gives AI agents (in Claude Desktop, Cursor, Windsurf, and Antigravity) direct, controlled access to send real-time alerts, operational notifications, and webhooks without exposing your primary API keys or relying on bloated middleware.

---

Run without cloning

uvx omnibridge-mcp

Claude Desktop / Cursor config entry:

{
  "mcpServers": {
    "omnibridge-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/johannschiffer/omnibridge-mcp",
        "omnibridge-mcp"
      ]
    }
  }
}

⚡ Key Features (Lite Edition)

• 🚀 Zero Heavy Dependencies: Pure Python implementation with minimal footprint (httpx).
• 💬 Telegram Bot API: Send markdown-formatted alerts, silent notifications, and direct messages.
• 🎮 Discord Webhooks: Send rich embed cards with custom colors, titles, and timestamps.
• 🔌 Universal Compatibility: Works out of the box with any MCP-compliant client via standard IO (stdio).
• 🧪 Built-in CLI: Interactive test tool to verify credentials and channel delivery in seconds.

---

🚀 Quick Setup in 2 Minutes

1. Installation

git clone https://github.com/johannschiffer/omnibridge-mcp.git
cd omnibridge-mcp
pip install -r requirements.txt

2. Environment Variables

Create a .env file or export variables in your shell:

# Telegram Bot Token (from @BotFather)
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"

# Discord Webhook URL (from Channel Settings -> Integrations -> Webhooks)
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."

3. Verify with CLI

# Check channels configuration
python -m omnibridge.cli status

# Send a test alert to Discord
python -m omnibridge.cli test --channel discord --message "OmniBridge is live!"

---

🖥️ Client Configuration

Claude Desktop (claude_desktop_config.json)

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json
On Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "omnibridge": {
      "command": "python",
      "args": ["-m", "omnibridge.server"],
      "cwd": "/path/to/omnibridge-mcp",
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here",
        "DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "omnibridge": {
      "command": "python -m omnibridge.server",
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here",
        "DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
      }
    }
  }
}

---

🛠️ MCP Tools Available

Tool	Parameters	Description
send_telegram_message	chat_id, text, disable_notification	Sends Telegram notification with Markdown support
send_discord_alert	content, title, description, color, webhook_url	Sends Discord rich embed card
get_channel_status	(none)	Returns connectivity and health of all channels

---

💎 Need Enterprise Features? Upgrade to OmniBridge Pro

Looking for production-grade reliability, business messaging, and fault tolerance?

Feature	Lite (Open Source)	Enterprise Suite ($19)
Telegram Bot API	✅	✅
Discord Webhooks	✅	✅
WhatsApp Cloud API	❌	✅
Slack Block Kit & Webhooks	❌	✅
Matrix Protocol Rooms	❌	✅
Custom Webhooks with HMAC	❌	✅
Offline WAL Resilient Queue (Zero Message Loss)	❌	✅
Adaptive Rate Limiting (Anti-ban protection)	❌	✅
Production Docker & Compose	❌	✅
Full Pytest Suite & Architecture PDF	❌	✅

👉 Get the Genesis Enterprise Suite ($19)

---

📄 License

MIT License. See LICENSE for details.

Genesis MCP Ecosystem

Module	What it does	Repo
CrawlEngine MCP	Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion	GitHub
BrowserBridge MCP	Deterministic headless browser automation with cryptographic action receipts	GitHub
PgSafe MCP	Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks	GitHub
OmniBridge MCP (this repo)	Multi-channel notification and webhook bus with a persistent SQLite WAL queue	GitHub
SysFlow MCP	Safe Linux administration plane: systemd, port audit, isolated execution	GitHub
FastMCP Forge	Production MCP server scaffolder: stdio, SSE and auth middleware	GitHub

Live config builder | Starter Kit, free | Enterprise Suite, $19