Bluesky posts with Hermes Agent and Bolta
Draft and review social posts from Telegram, Slack or your terminal. Parts of the Hermes Agent route are not confirmed yet, and the note below says which. Nothing goes live on Bluesky until you say yes.
Partly confirmed, see what is and is notChecked 2026-11-21
Hermes uses the generic route: a server address plus a Bolta API key.
Draft a Bluesky post under 300 characters about our new guide and show me the text before saving
Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.
What is and is not confirmed
Read this before you set up Hermes Agent
- Confirmed from the Hermes docs: Hermes reads remote MCP servers from an mcp_servers block in ~/.hermes/config.yaml, with a url and a headers map for a Bearer key. Bolta's server is https://mcp.bolta.ai/mcp and takes a key that starts with bolta_sk_.
- Not confirmed: we have not run this end to end in Hermes Agent. The OAuth option (auth: oauth) has never been tried against Bolta, so this page leads with the API key.
- Not confirmed: the skill install command against Bolta's skills repo, and the exact tool names Hermes shows for Bolta (expected to start with mcp_bolta_). If a step differs on your machine, trust what Hermes shows you.
What Bolta does on Bluesky
Bolta cuts Bluesky text at 300 characters and ends it with an ellipsis, so the useful part of a draft has to come before the limit.
- Text posts of up to 300 characters, cut with an ellipsis beyond that.
- Images. A video is left off, and Bolta publishes the text and any images.
Bluesky limits and format rules
Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.
Not promised for Bluesky from Hermes Agent: Custom feeds and quote posts. Neither is confirmed for Bolta. Any Bluesky rule beyond what Bolta reports. This page states Bolta's limits, not a network rulebook.
| What to know | Bluesky's own rule | What Bolta does |
|---|---|---|
| Post length | Not stated on this page. | 300 characters. Longer text is cut short and ends with an ellipsis. |
| Media | Not stated on this page. | Images are posted. A video is skipped with a warning, and the text and any images still go out. |
| Threads | Not stated on this page. | Parts after the first are posted as replies, so they read as one Bluesky thread. |
| Formatting | Not stated on this page. | Bluesky shows plain text, so Bolta flattens markdown and leaves #hashtags and @mentions as typed. |
Hermes Agent jobs for Bluesky, and how to write them
- Run Hermes from the terminal on a home server and ask it for a weekly read of your account analytics
- Have Hermes check the Bolta inbox each morning and tell you what is waiting, then approve only what you pick
- Write to 300 characters yourself. The cut is blunt and ends in an ellipsis.
Example prompts for Bluesky
Things to type in Hermes Agent. Each one asks for a draft and shows you the text first.
Draft a Bluesky post under 300 characters about our new guide and show me the text before saving
List my Bolta workspaces and accounts
Write a three-part Bluesky thread about how we set up our brand voice and show me all three parts first
List my Bolta workspaces and accounts.
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Hermes Agent asks Bolta for the Bluesky post in your brand voice (save-post). A saved draft is never public.
- 02
You read the exact text
On Bluesky the exact text includes where the 300-character cut would fall, and which images are attached, because a video would be left off.
- 03
You say yes
Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.
Using Hermes Agent for Bluesky
Parts of this route are not confirmed. The note above says which.
For Bluesky, Hermes Agent, from Nous Research, reaches Bolta through Remote MCP server in ~/.hermes/config.yaml. Sign-in: API key (Bearer header). OAuth is untested. The Bluesky account itself is connected inside Bolta, not in Hermes Agent.
Hermes Agent is open source and self-hosted, reached from chat apps or the terminal, and has a built-in scheduler. A weekly Bluesky drafting job is possible, with Bolta holding the approval step so nothing public goes out unreviewed.
This connection uses a Bolta API key, which acts as you. Safe Mode and client sign-off still apply to every Bluesky post it saves, so keep them on.
An illustration from the Hermes Agent guide, not real output. You ask: Plan a launch campaign for next month from this brief, and show the plan before creating it. The reply goes along these lines: Here is a plan with themes and a posting rhythm. Nothing is created yet. Tell me what to change and I will revise it before you confirm. Plan shown. Waits for your confirm.
Keep the key out of version control. If you keep your Hermes config in a dotfiles repo, store the key somewhere private and rotate it in Bolta under Settings, then API Keys if it ever leaks.
That prefix rule comes from the Hermes docs and we have not seen the exact list on a live install, so check hermes mcp test bolta. The Hermes docs also describe tools.include and tools.exclude settings for a server. Use them to leave Bolta's read and draft tools on and the approve and publish tools off. Entries are exact names or patterns, and include wins if you set both. hermes mcp configure bolta reopens a checklist of the tools if you would rather tick them.
If a key may have been shared, revoke it under Settings, then API Keys in Bolta and add a new one to config.yaml.
- Review and approval. Hermes can list what is waiting and tell you about it. Approving, rejecting and sending for team review are separate calls you choose to allow, and a post moves only on your yes.
- Routines that keep running. Ask Hermes to plan a repeating routine, read the plan, then confirm it. It is saved switched off. Turning it on is a second yes.
- It checks which networks are connected. The account list shows what is connected. If the network you asked for is missing, Hermes can ask Bolta for a connect link instead of guessing.
- It checks the posting rules for the network. Length and format limits differ per network. Reading the rules first avoids a draft that has to be rewritten.
- Setup: Install Hermes Agent. On macOS, Linux or WSL2 run: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. On Windows use the PowerShell installer or the desktop app from the Hermes website. Then run hermes setup for the full wizard. The Hermes install page also lists hermes setup --portal as a faster path that signs you in to Nous and sets Nous as the provider, which you only want if you plan to use that provider.
- Setup: Create a Bolta API key. In Bolta open Settings, then API Keys, and create a key. It starts with bolta_sk_. Choose the permissions you want it to have, copy it once and keep it private. A key belongs to one organization.
- Plugin or extension. Bolta's plugin is built for Claude Code. Hermes has no matching plugin from Bolta, so use the MCP entry.
- A draft that either one produces waits in Bolta review. It is not published because the schedule fired.
- Bolta routine. Choose this if the schedule should not depend on your own machine. A Bolta routine runs on Bolta's side even when Hermes is switched off. Ask Hermes to plan one, read the plan, and confirm it. A routine stays off until you separately say to activate it.
Connect Hermes Agent to Bolta
Hermes uses the generic route: a server address plus a Bolta API key.
Bluesky questions, answered for Hermes Agent
- Can Hermes Agent post a video to Bluesky?
- Not through Bolta. Bolta publishes the text and any images and leaves a video off, with a warning. Use images, or post the video on another network.
- What is the Bluesky length limit for posts from Hermes Agent?
- 300 characters. Longer text is cut short and ends with an ellipsis, so write to the limit and read the final text before you say yes.
- Bolta tools are missing after I edited config.yaml.
- Hermes does not reread the file on its own. Type /reload-mcp in the chat, or restart Hermes, then run hermes mcp test bolta again.
- I get an unauthorized or 401 error.
- The key is wrong, was pasted with a line break, or was revoked. Create a fresh key under Settings, then API Keys in Bolta and paste it after the word Bearer and one space.
- Hermes sees my workspace but no accounts.
- The key belongs to one organization and the brand may not be connected or included. Ask Hermes for a Bolta connect link and connect the account, then list accounts again.
- auth: oauth never finishes signing in.
- OAuth against Bolta has not been tested from Hermes. Remove auth: oauth, use the headers block with an API key instead, and run /reload-mcp.
- Does Hermes Agent publish Bluesky posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Bluesky post. Whether Hermes Agent completes the connection is not fully confirmed, so read the note above first.
More from Hermes Agent
Hermes Agent can work with the other networks Bolta publishes to. Each page has its own limits and review notes.
Bluesky from other AI agents
The same Bluesky limits apply whichever agent asks. The connection and the setup are what change.
Try a Bluesky draft from Hermes Agent
Connect Hermes Agent, ask for a Bluesky draft and read the exact text. Nothing goes live until you say yes.