# TGDirectory — Telegram channel directory

> A public directory of Telegram channels, groups and bots. Channels can be
> submitted programmatically, which is useful for agents and automations that
> list a user's own channels.

## Submitting a channel (for agents & automation)

An agent can list one or many channels with a single HTTP call. No account is
required; submissions are reviewed (an AI pre-screen plus human review) before
they go live, so nothing is published automatically.

- POST https://telegramchannels.io/api/channels/submit
  Body: {"channels": ["@example", "https://t.me/another"]}  (or {"channel": "@example"})
  Up to 500 handles per call. Returns a per-handle result.
- GET https://telegramchannels.io/api/channels/submit — returns the usage, as JSON.
- OpenAPI spec: https://telegramchannels.io/api/openapi.json
- MCP server (Model Context Protocol): https://telegramchannels.io/api/mcp
  Tool: submit_channel({ channels: [...] })

## Discovery

- Agent manifest: https://telegramchannels.io/.well-known/agent.json
- OpenAI-plugin manifest: https://telegramchannels.io/.well-known/ai-plugin.json
- Developer guide: https://telegramchannels.io/developers