Run Telegram Ads from Claude

Valkiria connects an official Telegram Ads account (ads.telegram.org) with your own API token and gives the assistant the live balance, the ads and their daily stats, plus a policy check and drafts. Claude on the web and in the desktop app connects to Valkiria as a custom connector: one URL, a sign-in on valkiria.pro, and the tools appear in the conversation.

Checked:

01

Connect Claude in 4 steps

  1. In Claude open Settings → Connectors → Add custom connector.
  2. Paste the MCP server URL shown below. Leave the client ID and secret empty: Claude registers itself.
  3. Sign in to Valkiria when asked and approve the access you want to grant: read only, or read plus proposals.
  4. Start a new conversation and type: "Get started with Valkiria".
  • Valkiria is not in the Claude connector directory yet, so it is added by URL as a custom connector. Whether custom connectors are available depends on your Claude plan.
  • The same connector works in the Claude desktop app once it is added to your account.
MCP server URL
https://valkiria.pro/mcp

02

What works for Telegram Ads today

Connection: The official Telegram Ads API token of your own account. Valkiria's ad network inside Telegram Mini Apps is a separate product, described on the platform page.

The assistant can read

  • The live account balance.
  • The ads in the account and the daily stats of one ad.
  • Drafts saved in Valkiria and stats imported from CSV.
  • A check of an ad text against Telegram Ads policy before it is saved.

The assistant can propose or request

  • Save a draft in Valkiria. A draft spends nothing.
  • Record or import stats for accounts that are tracked by hand.
  • Request a pause, an edit, a budget move, a submission for review or a deletion of a live ad. Each request changes nothing by itself: it points you to the Valkiria dashboard, where you confirm it.
  • Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.

Live integration statusTelegram Ads in Valkiria

03

Prompts to try: Telegram Ads in Claude

Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.

  1. What is my Telegram Ads balance and which ads are running right now?

  2. Show the daily stats of my Telegram ad [name] for the last two weeks.

  3. Check this ad text against Telegram Ads policy before I save it: [text].

  4. Save a Telegram Ads draft with this text and link. Do not submit it.

  5. List my Telegram Ads drafts and tell me which ones are ready.

  6. Request a pause for the ad with the highest cost per click. I will confirm it in Valkiria.

04

How changes stay safe

  • Sign-in uses OAuth 2.1 with PKCE on valkiria.pro, so the assistant never sees your password.
  • Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
  • A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
  • New campaigns are created paused. Starting new spend and deleting always wait for a person.
  • The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
  • The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
  • You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.

05

Limits

Telegram Ads

  • Every write to a live Telegram ad is confirmed by the owner in the dashboard; the assistant only raises the request.
  • Official Telegram Ads has its own minimum budgets and moderation, which Valkiria does not shorten.

Claude

  • Custom connectors are a Claude account feature: if your plan or organisation does not allow them, the URL cannot be added.
  • The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
  • Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
  • Money stays in each account's own currency. Different currencies are not converted or added up.
  • Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.

06

FAQ

Ask Claude about your Telegram Ads account

Create a free account, connect an ad account and add the connector. The first pass only reads.

Drag to move. Alt + arrow keys move the button; Alt + Home resets its position.

Cookie Preferences

We use cookies to enhance your experience. Essential cookies are always active. You can manage optional cookies below.

Essential
Analytics
Marketing
Third-Party