MCP server for the official Telegram Ads API: ads, budgets, stats, audiences and pixels.
Maintain this server? Claim it
This server only runs locally, from a package. Install it with the instructions on this page to try it.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add telegram-ads \ -e TELEGRAM_ADS_TOKEN=YOUR_TELEGRAM_ADS_TOKEN \ -- npx -y [email protected]
Environment
TELEGRAM_ADS_TOKEN (required): Telegram Ads API token from https://ads.telegram.org/account/apiTG_ADS_MODE (optional, not in the config above): read-only (default) or write. Write tools also require confirm: true.TG_ADS_CODE_MODE (optional, not in the config above): off, read-only (default) or write. Controls the tg_execute sandbox.TG_ADS_ALLOWED_ACCOUNTS (optional, not in the config above): Optional comma-separated allowlist for explicit account_id values.TG_ADS_MAX_CPM (optional, not in the config above): Optional per-call CPM cap in the account currency.TG_ADS_MAX_AD_BUDGET (optional, not in the config above): Optional per-call ad budget or transfer cap in the account currency.TG_ADS_MAX_DAILY_BUDGET (optional, not in the config above): Optional per-call daily budget limit in the account currency.TG_ADS_AUDIT_LOG (optional, not in the config above): Optional path to a JSONL audit log.TG_ADS_TIMEOUT_MS (optional, not in the config above): Per-request timeout in milliseconds.We don't run packages, so we can't list this server's tools.