Post to Telegram from Cline

Hermoso is a marketing MCP server: 850+ tools over one OAuth’d endpoint that let an agent research the ads already running in a market, generate finished image and video ads, publish them, and build the paid campaigns behind them. Cline reaches all of it through one connection. This page is about one slice of that — what Cline can actually do on Telegram, and what Telegram will not let it do.

Connect Hermoso to Cline

1. Create an API key. In Hermoso, open the MCP & CLI tab and, under Terminal & API keys, press ＋ Create API key. It looks like hmk_… and carries real spend authority, so treat it like a password.
2. Add an MCP server in Cline’s MCP settings, pointing at the hosted endpoint with your key:

   { "url": "https://app.hermoso.ai/mcp",
     "headers": { "Authorization": "Bearer <your key>" } }

3. Ask Cline for something. “Pull my three closest competitors’ longest-running ads and remix the best hook into a 9:16 video,” or “post this render to the channel.” The agent picks the tools; you approve the spend.

This is Hermoso’s generic HTTP MCP block rather than a bespoke Cline integration, and it is worth saying so plainly. What is Cline-specific on our side is the authorization server: it accepts loopback (http://127.0.0.1:PORT/…) redirect URIs precisely so locally installed agents like Cline can complete a registration handshake at all.

Then connect Telegram itself, once, under Settings → Connectors in Hermoso by pasting a bot token from @BotFather, and add that bot to your channel as an administrator. There is no consent screen: the token is the credential, and the bot is who posts.

The Telegram tools Cline gets

• post_to_telegram — sends a message as your bot to the chat you name: text up to 4,096 characters, or one photo, one video, or an album of 2 to 10 with photos and video mixed.
• schedule_post — queues it with its chatId on the same calendar as every other channel.
• list_telegram_chats — the chats that messaged the bot in the last 24 hours. It helps find an id, and it is not a list of every chat the bot is in.
• edit_telegram_message / pin_telegram_message — fix a message’s text or caption without losing its views, and pin or unpin the call to action.
• create_telegram_invite_link — a named invite link per campaign, with an optional expiry, member cap or join approval, so you can see who joined from where.
• telegram_account — the chat’s subscriber or member count, title, description and invite link.
• list_telegram_dms — what people sent the bot in the last 24 hours, newest first, to answer with post_to_telegram.
• delete_telegram_message — removes a message the bot sent, within Telegram’s 48-hour window, after a confirm step.

Telegram connects with a bot token, not a sign-in screen. Make a bot with @BotFather in Telegram, paste its token under Settings → Connectors, then add the bot to your channel as an administrator with Post Messages, or to a group as a member who can post. Hermoso posts as that bot, never as you. Two limits are Telegram’s and worth planning around: a bot gets no per-post views and no post history, so the subscriber count and named invite links are the numbers you have; and messages sent to the bot are kept for 24 hours, then gone. Publishing costs no credits.

Telegram limits worth knowing before you automate anything

Try it in Cline

Ask for it in ordinary language — these are sentences, not a DSL:

“Post this changelog summary to our Telegram group, and if the formatting looks wrong, fix the text rather than deleting it.”

That walks render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Cline asks before each tool call by default, which is the behaviour you want on anything that publishes.

Cline on Telegram: the part that bites

Prefer edit to delete. edit_telegram_message fixes a typo without losing the post or its views, while a delete and repost starts from zero. Deleting has two Telegram limits: messages under 48 hours old only, and in a channel only with the Post Messages right. There is no preview before a delete, because the Bot API cannot read one message back, so the confirm step is the whole safeguard. Keep it out of auto-approve.

If you run Cline in auto-approve, exclude the publishing and campaign tools — those are the ones with a public or a financial consequence.

Research Telegram before you post

There is no Telegram ad library and no channel search in Hermoso, so it claims no competitor research on Telegram. Research the creative where it is public (the Meta, Google and LinkedIn ad libraries plus organic TikTok, Instagram, YouTube, Reddit and Threads) and post the finished ad here.

The paid half

There are no Telegram ads in Hermoso, and we do not imply any. Telegram here is a channel you own and run through your bot: post, pin, edit, count subscribers and track invites. The paid tools cover Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads and Apple Search Ads.

What Cline cannot do on its own

An agent with a budget is only useful if the blast radius is bounded, so the fence is in the server rather than in a prompt. Every ad campaign, ad set, ad group and ad is created paused, and the status switches that arm real money refuse to run without an explicit confirmation flag. Every render is quoted first — hermoso_capabilities publishes each model’s exact credit cost before anything spends — and credits are reserved before the first provider call and settled at the exact cost afterwards, so a failed dispatch refunds rather than leaving you billed for nothing. Deletes are confirm-gated too, and every campaign tree is read back from the ad platform before your agent tells you what it built.

One step is deliberately yours: creating the bot with @BotFather and adding it to your channel. Everything after that is a tool call.

The rest of the matrix

From Cline, post to: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky — or see everything Cline can publish to.

Post to Telegram from: Claude · ChatGPT · Claude Code · Cursor · Codex · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat

Frequently asked questions

Can Cline post to Telegram?

Yes, through Hermoso's MCP server. Create an API key in Hermoso on the MCP & CLI tab, under Terminal & API keys, then add https://app.hermoso.ai/mcp to Cline with an Authorization: Bearer header. Cline then has 850+ tools, including the ones that publish to Telegram — and the ones that research the ads already running in your market and render the creative in the first place.

How do I connect Telegram to Cline?

Two steps, once each. Create an API key in Hermoso on the MCP & CLI tab, under Terminal & API keys, then add https://app.hermoso.ai/mcp to Cline with an Authorization: Bearer header. Then make a bot with @BotFather in Telegram, paste its token under Settings → Connectors in Hermoso, and add the bot to your channel as an administrator with Post Messages. After that Cline publishes to Telegram as an ordinary tool call, naming the chat each time.

Can Cline post privately or as a draft to Telegram?

There is no draft or private message in the Bot API. Privacy on Telegram belongs to the chat: post to a private group or channel and only its members see it. Hermoso refuses a visibility Telegram cannot honour at the moment you ask for it, rather than quietly publishing something weaker.

Can Cline research Telegram before it posts?

No. Hermoso has no Telegram ad library or channel search. It researches the creative on the public ad libraries and organic platforms, and Telegram is where you post the result.