Skip to main content
Glama
Sign In
telegram-public-mcp-cloudflare

telegram-public-mcp-cloudflare

by freQuensy23-coder
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

telegram-public-mcp-cloudflare

Public Telegram MCP server for Cloudflare Workers. It reads public Telegram channel pages at t.me/s/{channel} and exposes them as MCP tools over Streamable HTTP/JSON-RPC.

No Telegram API credentials are required. The server only fetches public web pages.

Public hosted instance

Anyone can use the deployed public MCP endpoint:

https://telegram-public-mcp-cf.mametevalex.workers.dev/mcp

Health check:

https://telegram-public-mcp-cf.mametevalex.workers.dev/healthz

Related MCP server: telegram-user-mcp

Tools

Tool

Description

get_channel_info

Public channel title, description, avatar, subscriber counter, canonical URL.

get_latest_posts

Latest public posts with text, images, views, timestamps, pagination by before_post_id or before_time.

search_posts

Telegram public web search via https://t.me/s/{channel}?q=....

Endpoints

Live Cloudflare deployment:

  • GET https://telegram-public-mcp-cf.mametevalex.workers.dev/healthz — health check.

  • POST https://telegram-public-mcp-cf.mametevalex.workers.dev/mcp — MCP JSON-RPC endpoint.

Generic endpoints:

  • GET /healthz — health check.

  • POST /mcp — MCP JSON-RPC endpoint.

Deploy

npm install
npx wrangler deploy

wrangler.toml:

name = "telegram-public-mcp-cf"
main = "src/worker.js"
compatibility_date = "2026-07-09"

[vars]
TELEGRAM_BASE_URL = "https://t.me"

MCP examples

List tools:

curl -s https://telegram-public-mcp-cf.<account>.workers.dev/mcp \
  -H 'content-type: application/json' \
  --data-binary '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

Get latest posts:

curl -s https://telegram-public-mcp-cf.<account>.workers.dev/mcp \
  -H 'content-type: application/json' \
  --data-binary '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_latest_posts","arguments":{"channel":"telegram","limit":3}}}' | jq

Hermes Agent config

mcp_servers:
  telegram-public:
    url: https://telegram-public-mcp-cf.mametevalex.workers.dev/mcp
    timeout: 120
    connect_timeout: 60

Limitations

  • Only public Telegram channels are supported.

  • Telegram can change t.me/s HTML; parser updates may be needed.

  • Subscriber/view counts are returned as Telegram renders them.

License

MIT

Tool Schema Changelog

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

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • tgreader-mcp

      ramich2077
      A
      license
      A
      quality
      D
      maintenance
      Telegram channel reader MCP server — exposes Telegram channels as MCP tools via Telethon MTProto.
      2
      MIT

    • telegram-user-mcp

      22syn
      A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that connects to Telegram as your real user account and exposes read-only tools to read and search messages, list chats and folders, inspect group info, and download media.
      16 npm
      MIT

    • Telegram MCP Server

      alexeyleshchenko
      A
      license
      A
      quality
      C
      maintenance
      MCP server that acts as a gateway to Telegram, providing AI-optimized tools for messaging, search, and chat management via MTProto. Supports multi-user authentication with QR login and HTTP/stdio transports.
      8
      2
      MIT