Skip to main content
Glama

omnibridge-mcp

PyPI version CI License: MIT Python 3.10+ MCP Compliant

OmniBridge MCP is a Model Context Protocol (2024-11-05) notification and webhook gateway that lets AI agents send alerts across Telegram, Discord, Slack, WhatsApp Cloud API, Matrix, and HMAC-signed webhooks with per-channel rate limiting and a persistent SQLite WAL retry queue.

Features

  • 6 Outbound Channels: Telegram Bot API, Discord Webhooks, Slack Block Kit Webhooks, WhatsApp Cloud API, Matrix rooms, and HMAC-SHA256 custom webhooks.

  • Outbound SSRF & Prefix Guards: Enforces official https://discord.com/api/webhooks/ and https://hooks.slack.com/ prefixes even on per-call overrides, blocks loopback/RFC1918/link-local (169.254.169.254) webhook targets, URL-encodes Matrix room IDs, and redacts bot tokens from transport errors.

  • Persistent SQLite WAL Queue & Flush Worker: Rate-limited and transient 5xx/network failures are stored in ~/.omnibridge/queue.db (0600 permissions) and retried with exponential backoff via flush_queue or omnibridge-cli flush.

Related MCP server: mcp-telegram

Quickstart

Run with uvx

uvx omnibridge-mcp

Claude Desktop / Cursor Configuration

{
  "mcpServers": {
    "omnibridge-mcp": {
      "command": "uvx",
      "args": ["omnibridge-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here",
        "DISCORD_WEBHOOK_URL": "https://discord.com/api/webhooks/..."
      }
    }
  }
}

CLI Diagnostics

omnibridge-cli status
omnibridge-cli flush
omnibridge-cli test --channel discord --message "OmniBridge test alert"

MCP Tools Available

Tool

Parameters

Description

send_telegram_message

chat_id, text, disable_notification

Send a Telegram notification with Markdown formatting

send_discord_alert

content, title, description, color, webhook_url

Send a Discord webhook message or rich embed

send_whatsapp_message

to_phone, text, preview_url

Send a WhatsApp Cloud API text message

send_slack_notification

text, header, webhook_url

Send a Slack Block Kit webhook notification

send_matrix_message

body, room_id

Send a Matrix room event (m.room.message)

send_custom_webhook

url, payload, secret

Deliver a JSON webhook signed with X-OmniBridge-Signature (sha256=...)

get_queue_stats

(none)

Return pending, retrying, delivered, and failed counts in the SQLite WAL queue

flush_queue

max_items

Process due messages in the SQLite WAL retry queue

get_channel_status

(none)

Return configuration status for all 6 channels and current queue counts

Genesis MCP Ecosystem

Module

Description

Repository

CrawlEngine MCP

HTTP web extraction to clean Markdown, JSON-LD parsing, and proxy rotation

GitHub

BrowserBridge MCP

Lightweight HTTP/DOM session automation with SHA-256 action receipts

GitHub

PgSafe MCP

Read-only PostgreSQL/SQLite query guard, PII masking, and dry-run mutations

GitHub

OmniBridge MCP

Multi-channel notification bus with SQLite retry queue

GitHub

SysFlow MCP

Linux systemd inspection, confined log tailing, and port auditing

GitHub

FastMCP Forge

Zero-dependency FastMCP framework, CLI scaffolder, and SSE middleware

GitHub

Support

If you find this project useful, you can support maintenance on Ko-fi.

License

MIT (c) 2026 Johann Schiffer

Available Tools

3 tools
get_channel_statusA

Check configuration and operational readiness of all connected notification channels.

Inputs: no named parameters.

send_discord_alertC

Send a rich webhook notification or embed to a Discord channel.

Inputs: color, title, content, description, +1 more.

send_telegram_messageC

Send a real-time notification or message to a Telegram chat, user, or channel.

Inputs: text (required), chat_id (required), disable_notification.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: sending to Telegram, sending to Discord, and checking channel status. There is no overlap in the resource+action pairs, so an agent can select unambiguously.

    Naming Consistency4/5

    All three follow a consistent snake_case verb_noun pattern (send_telegram_message, send_discord_alert, get_channel_status). The only minor deviation is the noun choice (message vs. alert) between the two send tools, but the structure remains predictable.

    Tool Count4/5

    Three tools is a reasonable, well-scoped set for a notification bridge, with each tool earning its place. It is on the lean side, supporting only two channels plus a status check, but nothing is redundant.

    Completeness3/5

    Despite the 'OmniBridge' name implying broad multi-channel coverage, only Telegram and Discord are supported, and there is no tool to configure or add channels. Core send and status operations exist, but channel lifecycle and broader integrations are notable gaps.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A streamlined MCP server designed to send AI agent progress updates, images, and files directly to a user via Telegram. It allows users to monitor long-running tasks and receive notifications or build artifacts through a simple messaging interface.
      3
      591 npm
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that wraps the Telegram Bot API into semantic tools for LLM agents, supporting multi-bot management for sending and receiving messages. It enables agents to send text, photos, and documents, as well as fetch recent updates from multiple configured Telegram bots.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for communication service connectors that currently provides multi-account Telegram integration with granular tool access and security controls. It allows AI models to manage messages, chats, and media across various accounts through a flexible, extensible routing architecture.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      A trusted, open-source MCP server for Telegram that enables LLMs to send messages, structured notifications with buttons, and wait for user replies using only bot token authentication.
      4
      40 PyPI
      MIT