Skip to main content
Glama
Free-cat

telegram-ads-mcp

by Free-cat
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TELEGRAM_ADS_ACCOUNTNoSubstring match against the account name shown on the Telegram Ads 'Choose Account' screen, used to select which account's ads the tools operate on. Optional when your login has exactly one account; required when multiple accounts are available.
TELEGRAM_ADS_AUTH_STATENoAbsolute path to the saved Playwright session file. Overrides the default lookup (~/.config/telegram-ads-mcp/auth_state.json, falling back to ./auth_state.json in the current directory).

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_accountsA

List Telegram Ads accounts available for this login session.

list_adsA

List all ads with full table columns (id, metrics, budget, status, date).

get_ad_infoC

Read ad form fields. Targeting chips are read-only for existing ads.

update_adA

Update ad info fields (not CPM/budget). Requires confirm=True to save; default is dry-run.

set_cpmA

Set CPM via /edit_cpm modal. Requires confirm=True to execute; default is dry-run.

set_statusA

Set ad status (Active / On Hold) via /edit_status modal. Requires confirm=True to execute; default is dry-run.

increase_budgetA

Add TON to ad budget (delta). Financial — requires confirm=True to execute; default is dry-run.

set_budgetA

Set target budget by computing delta from current. Financial — requires confirm=True to execute; default is dry-run.

get_ad_stats_csvB

Download stats CSV. Requires confirm=True to actually download; default is dry-run.

create_adB

Create new ad. Financial — requires confirm=True. Clears draft by default.

get_account_budgetA

Read-only: per-ad budgets on /account/budget. Fragment top-up is manual.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Free-cat/telegram_ads_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server