Hermes · MCP server

Run your social media from Hermes.It remembers what worked.

Run hermes mcp add with Breakreach's URL and Nous Research's Hermes Agent can post and schedule on Instagram, TikTok, LinkedIn, X, YouTube and 10 more networks, answer comments and DMs, and read your numbers, from its terminal or from Slack, Telegram, Discord or WhatsApp. Its memory and scheduler turn that into a routine: last week's numbers every Monday, the next posts drafted from what worked.

Get started free Setup guide

Terminal

hermes mcp add breakreach \  --url https://api.breakreach.com/mcp --auth oauth

Hermes opens your browser to sign in to Breakreach, then asks which tools to turn on.

Checked against Hermes's docs on October 7, 2026. Breakreach is our product.

Hermes

via Slack

How did last week's posts do? Draft three posts for this week from what worked, as drafts

Calling get_content_performance

Calling create_post

Message

Last 30 daysAll accounts

Views

Likes

Comments

Add Breakreach to HermesSign in with OAuth, or pass an API key.

Sign in with OAuth

Recommended

On the machine Hermes runs on, when it has a browser. Hermes registers itself with Breakreach, signs you in, and keeps the token in ~/.hermes/mcp-tokens/.

1
Add the server
Hermes connects, opens the sign-in, then lists the tools so you can pick the ones it may use. Keep them all, or leave out the ones that publish if you only want reports.
Terminal
```
hermes mcp add breakreach --url https://api.breakreach.com/mcp --auth oauth
```
2
Or write it in config.yaml
The same entry in ~/.hermes/config.yaml. Remote servers speak Streamable HTTP by default, which is what Breakreach serves. Then run hermes mcp login breakreach to sign in.
~/.hermes/config.yaml
```
mcp_servers:  breakreach:    url: "https://api.breakreach.com/mcp"    auth: oauth
```
3
Connect your social accounts
Connect Instagram, TikTok, LinkedIn and the rest once in Breakreach (Settings, Accounts). Or ask the agent for a link: create_connect_link returns a page where you, or a client, connect accounts without a Breakreach login.

Use an API key

For a gateway on a server, where no browser can finish a sign-in.

1
Create an API key
In Breakreach, open Settings, API & MCP and create a key. It starts with br_ and reaches every workspace you're a member of. Keep it out of files you commit.
2
Add the server with the key
Hermes asks for the key, saves it in ~/.hermes/.env as MCP_BREAKREACH_API_KEY, and writes the header into config.yaml for you.
Terminal
```
hermes mcp add breakreach --url https://api.breakreach.com/mcp --auth header
```

What it writes

If the variable is missing, Hermes refuses to connect rather than send the placeholder.

~/.hermes/config.yaml

mcp_servers:  breakreach:    url: "https://api.breakreach.com/mcp"    headers:      Authorization: "Bearer ${MCP_BREAKREACH_API_KEY}"

Check it works. hermes mcp test breakreach connects and exits cleanly, and hermes mcp list shows it. In a chat that was already open, /reload-mcp loads the 29 tools.

What to ask HermesRequests that work today, and the tools they call.

How did last week's posts do? Draft three posts for this week from what worked, as draftsget_content_performance, create_post
Post https://cdn.northbeam.coffee/launch.jpg to Instagram, TikTok and LinkedIn tomorrow at 9 AM: Morning Light is outcreate_post
Reply to the questions in today's Instagram comments, and show me the replies firstlist_recent_comments, reply_to_comment
Every Monday at 9, send me last week's top three posts and the follower change hereget_content_performance, get_account_stats
Anything in my Instagram or X DMs I haven't answered?list_conversations, get_conversation_messages

What Hermes can do with BreakreachThe same tools in every client.

Publish

create_postPublish now, schedule, take the next free slot or save a draft, on one or many accounts
update_postEdit, reschedule, approve a draft or retry a failed post
delete_postUnschedule and remove a post from Breakreach
list_postsPosts with status, time and numbers
upload_mediaCopy a public image or video URL to Breakreach storage
get_next_slotThe next free slot of the posting schedule
list_pinterest_boardsBoards a pin can go to

Accounts

list_workspacesWorkspaces, one per brand or client
create_workspaceA new workspace for a new brand or client
list_accountsConnected accounts, with a warning before one expires
create_connect_linkA link where you or a client connect accounts, no Breakreach login needed
get_account_statsFollowers and 28-day numbers per account
get_account_trendsDay by day reach and views

Analytics

get_content_performanceEvery post's numbers over N days, sorted the way you ask
get_post_insightsEverything about one post, against the account average
get_post_metricsOne Breakreach post's views, likes, comments and shares
get_analyticsTotals and top posts made with Breakreach

Comments and DMs

list_recent_commentsNew comments across Instagram, Facebook, Threads and X
get_post_commentsThe comments on one post
reply_to_commentAnswer as the account
hide_commentHide or unhide (Instagram, Facebook, Threads)
delete_commentDelete for good (Instagram, Facebook)
list_conversationsDMs on Instagram, Facebook Messenger and X
get_conversation_messagesRead one conversation
send_messageReply to a DM as the account

Comment to DM

list_comment_dm_rulesInstagram keyword rules, their stats and latest DMs
create_comment_dm_ruleDM everyone who comments a keyword on a post or reel
update_comment_dm_ruleNew keywords or message, or pause the rule
delete_comment_dm_ruleRemove a rule and its activity

What is Hermes Agent?

Hermes Agent is Nous Research's open-source agent (MIT licence, about 250,000 stars on GitHub in October 2026). You run it yourself and talk to it from its terminal interface, its desktop app, or a gateway that answers in Telegram, Discord, Slack, WhatsApp and Signal. It keeps a memory across conversations, writes and improves its own skills, runs scheduled jobs and subagents, and works with the model provider you choose.

MCP servers plug into it like any other tool, so Breakreach gives it your social accounts: the same 15 networks and the same tools as in Claude or ChatGPT.

Why run social media through Hermes?Memory and a scheduler turn requests into a routine.

It keeps your preferencesHermes keeps a memory across conversations: tell it once how you like your posts (tone, length, no hashtags) and the next drafts follow it.
A Monday report, on its ownIts scheduler can run the same request every week and send the answer to your Slack or Telegram: top posts, follower change, what to post next.
From the phoneThrough the gateway, “answer today's comments” or “what's scheduled this week?” works from a chat on your phone.
Your posting method as a skillAsk it to save how you post (formats, times, the networks per kind of post) as a skill, and it follows it every time.

How do I keep control of what it posts?

Three settings in the server's entry. tools.include and tools.exclude take name patterns, so a reporting-only Hermes can leave out create_post, send_message and the comment tools. trust: untrusted makes Hermes ask before every tool that isn't marked read-only; Breakreach marks its reading tools read-only, so reports run without a prompt and anything public waits for a yes.

For posts written on a schedule, ask for drafts: they wait in Breakreach until a person schedules them. Deleting a post through Breakreach never removes it from the network.

Can I sign in when Hermes runs on a server?Yes, with one extra step, or a key.

The OAuth sign-in comes back to 127.0.0.1 on the machine Hermes runs on. On a VPS behind your Telegram or Slack gateway, run hermes mcp login breakreach there, open the link on your computer, and paste the address you land on back into the terminal. An SSH tunnel to the callback port works too. The API key avoids all of it: no browser, and the gateway picks up the config within about a minute.

Media works the same way from a server as from a laptop: Breakreach takes public URLs, so a photo sent to Hermes in a chat has to be a link Breakreach can download, not a file on the gateway.

What does it cost?

Creating a Breakreach account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month ($23 billed yearly) for 5 accounts, or the Developer plan at $5 per connected account. Signed in with OAuth before you subscribe, the reading tools work and the publishing ones answer with a link to the plans. An API key needs an active plan or trial, and answers 402 otherwise. Hermes is free; the model it runs on is billed by its provider.

Troubleshooting Breakreach in Hermes

hermes mcp test breakreach can't connectCheck the URL ends in /mcp and that the entry has auth: oauth or the header. Then run hermes mcp login breakreach to sign in again.
The sign-in never finishes on a serverThe callback lands on 127.0.0.1 of that machine. Paste the address back into hermes mcp login, use an SSH tunnel, or switch to an API key.
The tools don't show up in the chatStart a new session or send /reload-mcp. The gateway reloads its config within a minute.
401 or 402 with an API key401: the key is wrong or deleted. 402: API keys need a plan or a trial.
“Media is required for: instagram”Give a link to the image or video, not a file sent in the chat.

The same server in other agents

Claude CodeOne command, then /mcp to sign in.

CursorOne entry in mcp.json, then Connect.

CodexOne command, then sign in.

OpenClawPost and answer comments from your chat app.

GrokGrok Build, the xAI API, or Grok Bot.

ChatGPTThe plugin in ChatGPT.

ClaudeThe connector in Claude's app.

Any MCP clientThe URL and both ways to sign in.

FAQ

Questions, answered.

Short answers about Breakreach in Hermes.

Yes. Run hermes mcp add breakreach --url https://api.breakreach.com/mcp --auth oauth, sign in, and Hermes gets 29 tools to post, schedule, answer comments and DMs and read analytics on 15 networks.

Yes. Through its gateway, you ask in Slack, Telegram, Discord or WhatsApp and Hermes calls Breakreach's tools. The post goes out from Breakreach, at once or at the time you give.

Not on a computer with a browser: Hermes signs in with OAuth. On a headless server, an API key in ~/.hermes/.env is simpler.

Yes. Ask Hermes to run the request every Monday morning and post the answer in your chat; it reads the numbers from Breakreach each time.

Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Threads, Pinterest, Bluesky, Reddit, Telegram, Discord, Slack, Mastodon and WordPress. Instagram, TikTok, YouTube and Pinterest need a photo or video.

Creating an account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month for 5 accounts, or the Developer plan at $5 per connected account.