Mastodon 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 Mastodon 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.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
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 Mastodon
The text limit on Mastodon is set by your own instance, and Bolta reads it for the connected account instead of using one fixed number. The usual limit is 500 characters.
- Text posts, within the limit your instance sets.
- Public posts by default, or another visibility if you set it.
Mastodon limits and format rules
Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.
Not promised for Mastodon from Hermes Agent: Polls, threads and instance-specific features. None is confirmed for Bolta. Any rule from a particular instance. Each instance sets its own, so check yours.
| What to know | Mastodon's own rule | What Bolta does |
|---|---|---|
| Post length | Not stated on this page. | Set by your instance. Bolta reads it per account, and the usual limit is 500. Text over the limit is trimmed back to the last whole sentence or word that fits. |
| Visibility | Not stated on this page. | Public unless you set another visibility. |
| Formatting | Not stated on this page. | Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed. |
| Finding conversations | Not stated on this page. | Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances. |
Hermes Agent jobs for Mastodon, and how to write them
- Let Hermes cron run a Monday planning pass and message you the plan, with Bolta holding every draft for approval
- Keep Hermes's cross-session memory for tone notes, while Bolta's voice profile keeps the actual drafts on brand
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Things to type in Hermes Agent. Each one asks for a draft and shows you the text first.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
What is waiting for my approval, and how did last month's posts do?
Draft a Mastodon post that is visible to everyone, and show me the text before saving it
Plan a launch campaign for next month from this brief, and show the plan before creating it.
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Hermes Agent asks Bolta for the Mastodon post in your brand voice (save-post). A saved draft is never public.
- 02
You read the exact text
On Mastodon the exact text includes its visibility, because the default is public, and where the limit for your instance would cut it.
- 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 Mastodon
Parts of this route are not confirmed. The note above says which.
For Mastodon, 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 Mastodon 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 Mastodon 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 Mastodon post it saves, so keep them on.
An illustration from the Hermes Agent guide, not real output. You ask: Tell me which of my Bolta routines ran this week and whether any failed. The reply goes along these lines: I looked at your routines and their recent runs. I can summarise each one here. I will not change or restart anything unless you ask. Read only. Nothing changed.
We have not run that install against this repo, so read the skill with hermes skills inspect before you install it and trust what Hermes reports.
Hermes keeps memory across sessions, so it can remember that you prefer short openings or that a product name has a special spelling. That memory lives on your Hermes install.
Set who may message your Hermes bot in Hermes before you add a Bolta key.
- 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.
- Results and reading. Ask how an account did over a period and Hermes can read the numbers back to you and suggest a next topic. It reads, it does not change anything.
- Hermes finds your workspace and accounts. Before drafting, Hermes asks Bolta which workspaces and brands this key can reach, so a post is never aimed at a brand you did not name.
- 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: Check the connection. In a Hermes chat type /reload-mcp, or in a terminal run hermes mcp test bolta. You should see Bolta's tools listed. The Hermes docs name MCP tools with an mcp_ prefix and the server name, so expect names like mcp_bolta_save_post.
- Setup: Add the Bolta skill. Run hermes skills install boltaai/bolta-skills/skills/bolta so Hermes knows Bolta's playbooks for drafting and review. You can run hermes skills inspect on it first to read it. The MCP connection works without the skill, the skill just gives better first answers.
- Bolta REST API. Bolta publishes API docs, so an agent that can make web requests could use them. We have not tried that from Hermes, and MCP is the simpler path.
- A Bolta routine runs on Bolta's side, so it keeps going when Hermes is switched off. It stays off until you separately say to activate it.
- Hermes cron. Choose this if you want the result delivered into a chat app. Hermes has its own scheduler that runs unattended and reports back to you. It only fires while your Hermes install is running, so it suits a machine or server you leave on. Drafts still land in Bolta review.
Connect Hermes Agent to Bolta
Hermes uses the generic route: a server address plus a Bolta API key.
Mastodon questions, answered for Hermes Agent
- What is the Mastodon character limit for a post from Hermes Agent?
- It depends on your instance. Bolta reads the limit for the connected account, and the usual limit is 500 characters. Anything over it is trimmed back to the last whole sentence or word.
- Are Mastodon posts from Hermes Agent public?
- Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
- Should I use an API key or OAuth to connect Bolta to Hermes?
- Use the API key. Hermes supports OAuth for MCP servers, but it has not been tested against Bolta. If you try it and it works, the key is still the fallback.
- Why do the Bolta tools show up as mcp_bolta_...?
- Hermes names MCP tools with the server name in front. Hyphens in a tool name are expected to become underscores, so save-post would appear as mcp_bolta_save_post. Run hermes mcp test bolta to see the real list.
- One connection covers which brands?
- A Bolta API key belongs to one organization, so it reaches the brands in that organization. Ask Hermes to list your workspaces first, and name the brand when you ask for a draft.
- 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.
- Does Hermes Agent publish Mastodon posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Mastodon 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.
Mastodon from other AI agents
The same Mastodon limits apply whichever agent asks. The connection and the setup are what change.
Try a Mastodon draft from Hermes Agent
Connect Hermes Agent, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.