TGAdsMCP
Sign in

A Telegram Ads MCP server for your AI client

Stats, ads, bids, budgets and scheduling - through the official API, with your own key.

Get access

Raise the bid on ads with CTR above 1% and cap the daily spend at 40 €.

TGAdsMCP

Send this to Telegram Ads?

Bid per 1,000 impressions 1.20 €→ 1.45 €
Daily spend cap none→ 40.00 €
Text and media unchanged

Approve Decline

Sent

3 ads updated. The bid and the cap are written; nothing else was touched.

This is what an edit looks like before it is written: what changes, and from what. Your AI client asks you - before it sends.

What the MCP does

  • Stats

    Impressions, clicks, joins and spend - across several accounts in one request, each in its own currency.

  • Ads

    Uploading photo and video, assembling the ad, sending it to moderation and fixing it after a rejection.

  • Bids and budgets

    Edits across a list of ads at once, with a diff before the write. A daily spend ceiling is set on each ad, if you want one.

  • Scheduling

    Start and stop dates, hours of the day and the frequency cap - the platform's own parameters.

  • Several accounts

    Every connected account in the same conversation, totals together. A GRAM account (TON in the API) gives a key to anyone with access; euro accounts sit under an agency's key.

A key, not a session

You need your Telegram Ads API key. You issue it yourself, at ads.telegram.org/account/api, and you revoke it there too - one press, and we are not asked.

A key opens the ad account it was issued in, and an agency key reaches the accounts that agency opened. However many keys you add, the accounts answer in the same conversation, with no browser to sign in to.

Nothing else is asked of you: no browser extension to install, no cookies to hand over, no access to your Telegram account. The work runs through the official Telegram Ads API, on the same key you use yourself.

What this key actually reaches

How to connect

  1. Open ads.telegram.org/account/api - the Ads API item in the account menu - and press Copy Token.
  2. Sign in here through Telegram and paste the key you copied. Sign in
  3. Add the MCP address to your AI client - the address and the access key are both issued in the dashboard after you sign in. Any client will do that can add a remote Model Context Protocol (MCP) server and send that access key in a request header.

Price

One plan for you, however many keys you add. Each ad account is connected with its own key, and the plan sets how many run at once.

What each plan includes

Free $0 forever 1 ad account, one key per account, read only: stats, ads and bids to look at, not to change Start free
Pro $29 a month up to 15 ad accounts, create and edit ads, bids, budgets, scheduling Get access

Questions

Do I need to write code?

No. You write what you would say to a person: "show me what burned the budget over the weekend", or "pause the ads where a subscriber costs more than planned". You need an AI client that speaks MCP and lets you add a remote server with a key of your own, and the key to your Telegram Ads account. The rest is words.

What do I stop doing by hand?

Walking through accounts to assemble one table, and opening every ad to change a bid. Automation here is not a schedule behind an on switch - it is a conversation: you ask for a change, the agent shows exactly what moves, you confirm. What the official API cannot do stays manual, and the reference says which parts.

Am I giving you access to my Telegram account?

No. We work with the Telegram Ads API key you issue yourself, in your own Telegram Ads settings. It opens the one ad account it was issued in and nothing else: no messages, no contacts, no way into Telegram. That is the difference from a browser extension, which runs on your own session and sees everything you see.

If someone got hold of my key, what is the worst they could do?

Spend what is already in that one ad account, and change what is running in it - ads, bids, budgets, schedule. That is the ceiling, and the API sets it rather than a promise of ours: every method that moves money moves it between budgets inside the account, and not one takes money out of Telegram Ads or brings it in. Nothing outside that account is reachable either - not your messages, not your contacts, not Telegram itself, not another ad account. And you close the door yourself: revoking is one button in Telegram Ads, and it does not ask us.

Can the agent spend my budget on its own?

Before a write the agent shows the diff: which fields change and from what, and your AI client is what asks you, before it sends. That prompt belongs to the client, not to us: if the client is set to approve everything automatically, no dialog appears and the write goes straight out. The daily spend ceiling is set on the ad, and a new ad has none until you set one.

What is left if you disappear?

Everything that matters, because none of it is held here. Campaigns, budgets and history live in your Telegram Ads account, and they keep running whether we exist or not - nothing of ours stands between an ad and its impressions. The key is yours, and you revoke it in Telegram Ads without asking us. What you would lose is the conversation: the ability to ask an agent instead of clicking. Not the account, not the money in it, not a single ad.

How do I pay if you do not take cards?

In GRAM or USDT from the wallet you already have open in Telegram. Payment runs through OxaPay and the invoice covers one month.

Does this work with any Telegram Ads account?

With the one your API key reaches. A GRAM account gives a key to anyone with access to it: you need not own it, only work in it. A euro account has no Ads API section of its own and is run by whoever holds the key that covers it - today that means the agencies who open such accounts. Your plan sets how many accounts are connected; we do not change an account type and have no influence over its terms.

What else do you need besides the key?

A Telegram sign-in and an email address, confirmed on the spot with a six-digit code. The email is there so access does not disappear along with your Telegram account, and so there is somewhere to write to about billing.

What happens if I revoke the key?

The MCP stops answering for that ad account in the same second - a key opens the account it was issued in, and your other connected accounts keep working on their own keys. The door only opens from your side: revoking is done in Telegram Ads, it does not ask us, and we can neither undo it nor restore access. A new key is issued on that same screen, and it reaches us only when you connect it. Note that any other tool of yours running on the old key stops too.

The free plan does not expire: 1 ad account and your own numbers in front of you, for as long as it takes to decide.

Start free