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. Hermes reaches all of it through one connection. This page is about one slice of that — what Hermes can actually do on Telegram, and what Telegram will not let it do.
Connect Hermoso to Hermes
- Install and sign in.
Your browser opens once. Nothing to create and nothing to paste: the credential is stored owner-only innpm install -g hermoso && hermoso auth login~/.hermoso/config.json. On a machine with no browser,hermoso auth login --token hmk_…takes a key from MCP & CLI → Terminal & API keys instead. - Add it to
~/.hermes/config.yaml.mcp_serversis a top-level key, not nested undermcp, and no key goes in the file becausehermoso mcpreads the sign-in above:mcp_servers: hermoso: command: "npx" args: ["-y", "hermoso", "mcp"] - Ask Hermes 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.
Hermoso is not affiliated with or endorsed by the makers of Hermes and does not claim to be. The shape above is quoted from the project's own MCP reference in NousResearch/hermes-agent, read on 2026-08-23; it is documented rather than run here, which is why it is the published file shape and not a bespoke install command.
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 Hermes 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 itschatIdon 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 withpost_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
| Text | A Telegram message runs to 4,096 characters, but only 1,024 once a photo or video is attached, because the text becomes a caption. It is enforced when the post is created or queued — refused while you are still there to fix it, rather than silently cut on the way out. |
|---|---|
| Visibility | Sent or not sent, with no draft, unlisted or private form. Who sees it is decided by the chat: “post to a private group or channel and only its members see it.” silent delivers without a notification sound and changes nothing about who can see the message. |
| Carousel | 2 to 10 items as an album, and photos and video may be mixed. Both bounds are Telegram’s own, from the Bot API’s sendMediaGroup (“must include 2-10 items”), and so is the mixing. The album shows one caption, on its first item. Hermoso uploads the files instead of passing links, which raises Telegram’s ceilings to 10MB per photo and 50MB per video. |
| Which account | chatId, required on every post: a public channel’s @username or the numeric id (a supergroup or channel starts with -100). The Bot API has no method that lists the chats a bot is in, so Hermoso cannot know them and never guesses. |
Try it in Hermes
Ask for it in ordinary language — these are sentences, not a DSL:
“Post the campaign’s three images and the 15-second cut to our Telegram channel as one album with a short caption on the first item.”
That walks render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Approval behaviour is yours to configure. Hermoso’s own guarantees do not depend on it: campaigns are born paused, spend switches are confirm-gated, and no generation call runs without a verified account behind it.
Hermes on Telegram: the part that bites
Telegram is the one channel here where photos and video can share an album, which Telegram states for sendMediaGroup: 2 to 10 items. Pass the video beside the images and it joins the album. Connecting is a bot token from @BotFather pasted into Hermoso, not an OAuth screen, so the step Hermes cannot do for you is making the bot, not linking it.
For unattended runs the hermoso CLI with --json is easier to assert on than a tool manifest, and much cheaper in context.
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 Hermes 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 Hermes, post to: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky — or see everything Hermes can publish to.
Post to Telegram from: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Gemini CLI · Perplexity · Le Chat
Frequently asked questions
Can Hermes post to Telegram?
Yes, through Hermoso's MCP server. Run npm install -g hermoso && hermoso auth login, then add hermoso under the top-level mcp_servers key in ~/.hermes/config.yaml with command "npx" and args ["-y", "hermoso", "mcp"]. The browser sign-in stores the credential, so no key goes in the file. Hermes 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 Hermes?
Two steps, once each. Run npm install -g hermoso && hermoso auth login, then add hermoso under the top-level mcp_servers key in ~/.hermes/config.yaml with command "npx" and args ["-y", "hermoso", "mcp"]. The browser sign-in stores the credential, so no key goes in the file. 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 Hermes publishes to Telegram as an ordinary tool call, naming the chat each time.
Can Hermes post a carousel to Telegram?
Yes, as an album of 2 to 10 items with photos and video mixed, which is Telegram’s own rule for sendMediaGroup. The album carries one caption, on its first item. Hermes calls the same publish tool either way, and a channel that cannot carry a carousel is refused with the real reason attached.
What does it cost to post to Telegram from Hermes?
Posting to Telegram costs no credits; Telegram charges nothing per call. Credits are spent on generating the creative. Plans are $19, $49 and $149 a month for 1,000, 3,000 and 10,000 credits, and every feature is on every plan including Free — the only exception is enterprise SSO.
Start free — 30 credits at signup and 250+ more to earn, and every feature on every plan. Credits are spent only on AI models and Ad Spy research; posting, scheduling, ads management and analytics are free.
Start free → See pricing