Hermoso is a marketing MCP server: 922+ 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. Grok Bot reaches all of it through one connection. This page covers one slice of that: what Grok Bot can actually do on Bluesky, and what Bluesky will not let it do.
Connect Hermoso to Grok Bot
- Fastest: add the Hermoso Marketing Bot template. Open the template and add it to Grok Bot. It arrives wired to Hermoso but with no key, because templates never carry secrets, so it asks for one: create a key under MCP & CLI → Terminal & API keys and paste it into the Bot’s chat. A key carries real spend authority, so treat it like a password.
- Or sign in from the Bot’s own terminal. Every Bot gets a browser, a filesystem and a shell, so the keyless install works there too:
Thenpm install -g hermoso && hermoso auth loginhermosocommand is then available to the Bot with nothing pasted into a config file. Settings → Plugins is a catalog of pre-built connectors that does not list Hermoso, so the template and the terminal are the ways in today. - Using Grok Build instead? xAI’s terminal coding agent is a separate product with its own setup: see Hermoso in Grok Build.
- Ask a Bot 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 xAI and does not claim to be. The Hermoso Marketing Bot template is published by Hermoso; the same steps are in the app under MCP & CLI, on the Grok Bot tab of the agent setup.
Then connect Bluesky itself, once, under Settings → Connectors in Hermoso, with your handle and a Bluesky app password. There is no consent screen: the app password is made in Bluesky’s own settings, and it can be revoked there without touching your real password.
The Bluesky tools Grok Bot gets
post_to_bluesky: publishes a post as the connected account: up to 300 characters, with up to four images and alt text, or one MP4 video with optional caption tracks. A link with no media gets a preview card, which Hermoso builds because Bluesky does not fetch one.schedule_post: queues it on the calendar every other channel shares, with the 300-character cap checked when it is queued rather than when it fires.list_bluesky_posts: the account’s own recent posts with their AT-URIs and live counts, marking reposts so someone else’s post is never read as yours.bluesky_post_metrics / bluesky_account: likes, reposts, replies, quotes and bookmarks per post, and followers, following and post count for your account or any public one.list_bluesky_convos / read_bluesky_dm / send_bluesky_dm: read and answer direct messages, including message requests from people the account does not follow.manage_bluesky_convo / react_to_bluesky_dm / mark_bluesky_convo_read: accept a request, mute, lock or leave a conversation, react with one emoji, and clear unread counts.delete_bluesky_post: removes a post, after a first call that deletes nothing and reads back what would go.
Bluesky connects with an app password rather than a sign-in screen: create one in Bluesky’s settings and paste it with the handle under Settings → Connectors. Tick direct-message access when you create it, or the DM tools will tell you the password cannot chat, which is a property of the password and not a broken connection. Two more Bluesky rules Hermoso checks before sending: a video needs a confirmed email on the Bluesky account, and a link card and an image cannot share a post. Publishing costs no credits, because Bluesky charges nothing per call.
Bluesky limits worth knowing before you automate anything
| Text | A Bluesky post is capped at 300 characters and, separately, at 3,000 bytes, so an emoji-heavy post can be under 300 characters and still too long. It is enforced when the post is created or queued, so an overlong post is refused while you are still there to fix it instead of being silently cut on the way out. |
|---|---|
| Visibility | Public only. A Bluesky post is a public record on the AT Protocol, and there is no unlisted, private or draft form of one. The review happens before the call, never after it. |
| Carousel | 2 to 4 images, images only. Four is Bluesky’s own number, from the AT Protocol lexicon for an image embed, and a fifth is refused rather than dropped. A video is a different embed that carries exactly one clip, and a post has a single embed, so a Bluesky post is images, one video or a link card: one of the three. |
| Which account | None, unless the brand has connected more than one Bluesky account. Then account names which, and several with none named is refused by name rather than guessed. |
Try it in Grok Bot
Ask for it in ordinary language. These are plain sentences, not a DSL:
“Every Friday, compare our Bluesky follower count with our two closest competitors’ and post a short recap of the week under 300 characters.”
That walks get_brand → generate_image → post_to_bluesky → bluesky_post_metrics. Approval is Grok Bot’s setting rather than ours, and the shared machine is the reason to think about it: isolation is per user, not per Bot, so anything one Bot connects, every Bot on that machine can reach.
Grok Bot on Bluesky: the part that bites
bluesky_account reads any public account’s followers, following and post count, not just yours, and costs nothing, so a weekly comparison is a job a Bot can own. A counter Bluesky does not return is reported as absent rather than zero, which matters on a trend line: a missing number is not a fall to nothing. Handles can change on Bluesky, so the tool tells accounts apart by their DID.
For a long unattended run the hermoso CLI is the cheaper path: the agent shells out per command instead of carrying an 922+ tool manifest through every turn of a job that might run for days.
Research Bluesky before you post
There is no Bluesky ad library and no Bluesky search in Hermoso, so competitor research there comes down to one honest thing: bluesky_account reads any public account’s followers, following and post count, which is enough to size a competitor and chart it week by week. Everything else in the research surface (the Meta, Google and LinkedIn ad libraries, organic TikTok, Instagram, YouTube, Reddit and Threads) is unaffected.
The paid half
There is no Bluesky ads product in Hermoso, and we do not imply one. Bluesky here is organic: publish, schedule, read, reply and measure. The paid tools cover Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads and AppLovin Ads.
What Grok Bot 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). 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 Bluesky app password and connecting it once. Everything after that is a tool call.
The rest of the matrix
From Grok Bot, post to: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram. Or see everything Grok Bot can publish to.
Post to Bluesky from: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
Frequently asked questions
Can Grok Bot post to Bluesky?
Yes, through Hermoso's MCP server. Add the Hermoso Marketing Bot template from x.ai/bot/THQqogUKuhn1whWU0hrmb, which arrives wired to Hermoso and asks for an API key you create under MCP & CLI, Terminal & API keys. Or run npm install -g hermoso && hermoso auth login in the Bot's own terminal, which stores the credential with nothing pasted. Grok Bot then has 922+ tools, including the ones that publish to Bluesky, plus the ones that research the ads already running in your market and render the creative in the first place.
How do I connect Bluesky to Grok Bot?
Two steps, once each. Add the Hermoso Marketing Bot template from x.ai/bot/THQqogUKuhn1whWU0hrmb, which arrives wired to Hermoso and asks for an API key you create under MCP & CLI, Terminal & API keys. Or run npm install -g hermoso && hermoso auth login in the Bot's own terminal, which stores the credential with nothing pasted. Then create an app password in Bluesky's settings (tick direct-message access if you want the DM tools) and paste it with your handle under Settings → Connectors in Hermoso. After that Grok Bot publishes to Bluesky as an ordinary tool call.
Does Grok Bot need my Bluesky password?
No, and not your main Bluesky password either. Bluesky connects to Hermoso with an app password, which you create in Bluesky's settings and can revoke there at any time, and Grok Bot then reaches the account as a tool call. No credential is ever handed to the model.
Can Grok Bot research Bluesky before it posts?
Only lightly. There is no Bluesky ad library or search in Hermoso, but bluesky_account reads any public account’s followers, following and post count, which is enough to size a competitor.
Can Grok Bot post a carousel to Bluesky?
Up to a point: 2 to 4 images, images only, which is the limit in Bluesky’s own lexicon. A video goes up as its own post, one clip per post, because a Bluesky post carries a single embed. Grok Bot calls the same publish tool either way, and a channel that cannot carry a carousel is refused with the real reason attached.
Can Grok Bot run Bluesky ads as well as posting?
No. There is no Bluesky ads product in Hermoso. Bluesky here is organic: publish, schedule, read engagement, and handle replies and DMs.
Start free with 30 credits at signup and 250+ more to earn. Every feature is 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