Hermes Agent + Instagram

Instagram 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 Instagram until you say yes.

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

Hermes AgentBolta connected
You

Draft an Instagram caption for the photo I added to my library, under 2,200 characters, and show it to me before saving

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 Instagram

What Bolta does on Instagram

Instagram will not take text alone. Bolta needs an image or video before it will approve the post, so the draft starts with the media you want to use.

  • Feed posts, Reels and Stories. A post is a feed post unless you set Reels or Story.
  • An image or video is required for every Instagram post.
Limits and format

Instagram limits and format rules

Network rules last checked 2026-07-28. Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Instagram from Hermes Agent: Replies to Instagram comments and a search for Instagram conversations. Bolta's reply tools are not wired for Instagram, so this page does not promise either. Collab posts, Close Friends and direct messages.

Instagram limits and format rules
What to knowInstagram's own ruleWhat Bolta does
Caption lengthNot stated on this page.2,200 characters. Longer text is trimmed back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text. A caption you set yourself is sent as written, with no length check.
Reel lengthReels can be up to 20 minutes long, with 3 minutes the recommendation cutoff.Bolta does not check video length or file size, so Instagram makes that call.
CarouselsOne post can hold up to 20 photos and videos as a swipeable carousel.A carousel in Bolta takes 2 to 10 files.
Image sizeInstagram caps shared photos at 1080 pixels wide, sizing larger uploads down.Feed images should sit between 4:5 and 1.91:1, and Story images between 9:16 and 1.91:1.
Story videoA story video up to 60 seconds stays one clip. Longer footage is broken into several clips.Bolta does not check video length. A Story cannot be a carousel.
Best practices

Hermes Agent jobs for Instagram, 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
  • Limit the Bolta tools Hermes sees to read and draft, so a self-hosted agent never has a publish tool in reach
  • Start with the media. Instagram needs an image or video, so attach it before you ask for the caption.
Prompts

Example prompts for Instagram

Things to type in Hermes Agent. Each one asks for a draft and shows you the text first.

Draft an Instagram caption for the photo I added to my library, under 2,200 characters, and show it to me before saving

Every Monday morning, plan a week of posts for our main brand and show me the plan first.

Draft a caption for a four-image Instagram carousel about our spring range and show me the text before saving

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 Instagram post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Instagram the exact text includes the caption and the media it sits on, and whether it is a feed post, a Reel or a Story.

  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 Instagram

Parts of this route are not confirmed. The note above says which.

For Instagram, 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 Instagram 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 Instagram 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 Instagram 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.

A draft you ask for in chat is saved in Bolta, so review happens in Bolta and not in the chat thread.

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.

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.

  • 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.
  • 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: Optional: use OAuth instead of a key. Hermes also supports auth: oauth in place of the headers block, then hermes mcp login bolta, which walks you through signing in. This has not been tested with Bolta. If it fails, go back to the API key.
  • 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.
  • Hosted MCP with sign-in (OAuth). Hermes supports auth: oauth and hermes mcp login. It has never been tried against Bolta, so keep the key as the fallback.
  • 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.
  • Reload and ask. Type /reload-mcp in a Hermes chat, then ask it to list your Bolta accounts. Ask for a draft once the right brands show up.
Connect

Connect Hermes Agent to Bolta

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

FAQ

Instagram questions, answered for Hermes Agent

Can Hermes Agent post text to Instagram without an image?
No. Bolta will not approve an Instagram post without an image or video, so attach the media first. A post is a normal feed post unless you ask for a Reel or a Story.
How long can an Instagram caption from Hermes Agent be?
Bolta uses 2,200 characters and trims a longer caption back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text, so a caption you set yourself is sent as written, unchecked.
Do I need the Bolta skill as well as the MCP connection?
No. The connection is enough to call Bolta's tools. The skill adds instructions so Hermes handles things like posting rules in the right order. We have not tested the skill install in Hermes.
Can Hermes post to my accounts without my approval?
Bolta's rule is that nothing is approved, scheduled or published until you say yes, and a draft Hermes saves stays in review. We have not tested this from Hermes, so a key with narrower permissions and a shorter tool list is a sensible second layer.
Hermes cron or a Bolta routine: which should I schedule with?
Use Hermes cron if you want the result sent to a chat app and your Hermes stays running. Use a Bolta routine if the schedule should keep going when Hermes is off. A routine is saved switched off and needs a separate yes to start.
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.
Does Hermes Agent publish Instagram posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Instagram 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.

Instagram from other AI agents

The same Instagram limits apply whichever agent asks. The connection and the setup are what change.

Try an Instagram draft from Hermes Agent

Connect Hermes Agent, ask for an Instagram draft and read the exact text. Nothing goes live until you say yes.