Hermes Agent + Mastodon

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.

Hermes uses the generic route: a server address plus a Bolta API key.

Hermes AgentBolta connected
You

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.

Illustration. Your drafts show your real text, account and time.

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.
Bolta on Mastodon

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.
Limits and format

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.

Mastodon limits and format rules
What to knowMastodon's own ruleWhat Bolta does
Post lengthNot 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.
VisibilityNot stated on this page.Public unless you set another visibility.
FormattingNot stated on this page.Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed.
Finding conversationsNot stated on this page.Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances.
Best practices

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.
Prompts

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.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 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.

  2. 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.

  3. 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.

Hermes Agent and Bolta

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

Connect Hermes Agent to Bolta

Hermes uses the generic route: a server address plus a Bolta API key.

FAQ

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.