Skip to content
MCP server

tgden — Telegram catalog & search

Search a public catalogue of Telegram channels, groups, bots and listings, no key needed

Install
Pricing
Free
Platforms
API, Web, telegram
Runs
Remotely
Version
1.3.0
Listing updated
3 days ago

About tgden — Telegram catalog & search

tgden — Telegram catalog & search is a free MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

Most Telegram MCP servers log in as you and read your own dialogs. This one does the reverse: it is a public index of what exists on Telegram, so an assistant can answer questions such as which channels or groups cover a topic, without a Telegram account, bot token or API key. The site reports about 1.79 million channels, 460 thousand live group chats and 46 thousand marketplace listings, refreshed daily, and the registry entry adds 228 thousand bots.

Search on the website is meaning-based, with filters by category and real request metrics per community. The README notes that the free catalogue search is keyword-based and that buyer requests are a masked preview, with semantic search and private chat access outside the free offer. A telegram_demand tool exposes a daily count of requests in public chats by country and niche, such as services, goods, real estate, jobs and freight, also published as an open dataset.

The same repository bundles free Python tools for exporting channel posts, group, channel and bot matches and classifieds to JSON and CSV, run locally or through GitHub Actions. Endpoints are CORS-enabled, so they work from a browser tab.

Install

Run in a terminal

claude mcp add --transport http telegram-catalog https://tgden.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://tgden.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-catalog": {
      "url": "https://tgden.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "telegram-catalog": {
      "type": "http",
      "url": "https://tgden.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telegram-catalog": {
      "serverUrl": "https://tgden.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "telegram-catalog": {
      "type": "http",
      "url": "https://tgden.com/api/mcp"
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

telegram_demand
Returns a daily count of requests in public Telegram chats by country and niche.

What it does

Public Telegram index
Covers channels, group chats, bots and marketplace listings without a Telegram login.
Demand index
The telegram_demand tool counts requests in public chats by country and niche.
Daily refresh
The site says its chat and channel data is read and refreshed daily.
REST API too
The same catalogue is available at /api/catalog alongside the MCP endpoint.
Free export tools
Python tools write JSON and CSV for groups, channels, bots and classifieds.
Browser-friendly
CORS is enabled so the API can be called from a browser tab.

Good for

  • Find Telegram channels and groups about a topic
  • Look up a bot that matches a task
  • See what people in a country request most in public chats
  • Export channel matches for a keyword to CSV
  • Check whether a public username exists in the catalogue

Pricing

Free

Free public catalogue and tools; some semantic search is partner-only

Prices change. Check tgden.com before you buy.

tgden — Telegram catalog & search FAQ

Does it need my Telegram account?

No. It needs no Telegram account, API key or install.

How big is the catalogue?

The site shows 460,421 live chats, 1,786,204 channels and 46,486 listings; the registry entry also cites 228 thousand bots.

Is search semantic?

On the website yes, but the README says the free catalogue search is keyword-based and full semantic search is partner-only.

Can I export results?

Yes. The free Python tools write result.json and result.csv for each run.

Can it read private chats?

No. Private chat access and complete channel history are outside the free offer.

Is tgden — Telegram catalog & search free?

Yes. tgden — Telegram catalog & search is free to use.

How do I add tgden — Telegram catalog & search to Claude Code?

Run this command in your terminal: claude mcp add --transport http telegram-catalog https://tgden.com/api/mcp

What are the best alternatives to tgden — Telegram catalog & search?

The closest alternatives to tgden — Telegram catalog & search are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to tgden — Telegram catalog & search

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories