# Connect Hermes Agent to RobinReach: MCP Setup in config.yaml

> To connect Hermes Agent to RobinReach, add a robinreach entry under mcp_servers in ~/.hermes/config.yaml with url set to https://robinreach.com/mcp/v1/messages and your API key in an Authorization header. Run /reload-mcp or start a new session, then check it with hermes mcp test robinreach. Hermes can then write, schedule and publish posts on 13 networks, read your analytics and answer comments. It is included on the Bloom, Thrive and Scale plans.

Canonical: https://robinreach.com/ai/integrations/hermes
App: Hermes, by Nous Research (https://hermes-agent.nousresearch.com)
Where you use it: Terminal and chat apps
Sign in: API key. Setup time: 2 minutes. RobinReach plan: Bloom, Thrive and Scale.

## What you need

In Hermes:
- Hermes Agent installed.
- Your API key from the Integrations page in RobinReach.

In RobinReach:
- The Bloom, Thrive and Scale plan (Bloom, $24 a month).
- An API key from the Integrations page (the account key reaches every brand; a brand key reaches one).

## Setup

### 1. Open your Hermes config

Open ~/.hermes/config.yaml in any editor.

### 2. Add RobinReach under mcp_servers

Replace **YOUR_API_KEY** with the key from the Integrations page in RobinReach. If mcp_servers already exists, add robinreach next to the servers there.

```
mcp_servers:
  robinreach:
    url: "https://robinreach.com/mcp/v1/messages"
    headers:
      Authorization: "Bearer YOUR_API_KEY"
```

### 3. Load it and check

Run **/reload-mcp** in Hermes or start a new session. Then run this to see what RobinReach answered.

```
hermes mcp test robinreach
```

### 4. Say hello

Ask Hermes to list your RobinReach brands.

Check it works: Ask Hermes: "List my RobinReach brands".

### Prefer the key in the URL?

The Integrations page in RobinReach shows this shorter form, with your API key inside the URL. Both reach the same server; keep the file private.

```
mcp_servers:
  robinreach:
    url: "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
```

## Things to ask Hermes

- Tell me which posts did best last week and why.
- Draft next week's posts from our content pillars and save them as drafts.
- Reply to any new comments on our Facebook Page that ask about opening hours.
- Turn our latest blog post into posts for LinkedIn, X and Threads.

## Troubleshooting

**hermes mcp test shows an error.** Check the key after Bearer is current. Creating a new key on the Integrations page replaces the old one.

**Hermes does not use the new server.** Run /reload-mcp or start a new session. A running gateway also picks up config changes within about a minute.

**Too many tools for my model.** Hermes can limit a server to the tools you pick. Keep posts, media and analytics, and add the rest when you need them.

## Other AI apps

- [Connect OpenClaw to RobinReach](https://robinreach.com/ai/integrations/openclaw.md)
- [Connect n8n to RobinReach](https://robinreach.com/ai/integrations/n8n.md)
- [Connect Claude Code to RobinReach](https://robinreach.com/ai/integrations/claude-code.md)

## Questions

### What is Hermes?

Hermes Agent is Nous Research's open source agent. It runs in your terminal or through its gateway and connects to tools over MCP.

### Do I need Node.js?

No. Hermes connects to RobinReach over HTTP directly, with nothing extra to install.

### Can I connect just one brand?

Yes. Use that brand's key from its Integrations page.

### Will Hermes post without asking?

RobinReach marks publishing right away, deleting and client links so the agent asks first. For unattended runs, ask it to save drafts and approve them in the RobinReach calendar.

### Which plans include it?

On RobinReach, the Bloom, Thrive and Scale plans.

## Sources

Last checked on 24 October 2026. RobinReach's numbers (tools, networks, limits, plans) are read from the product when the page is generated.

- [Hermes Agent docs, MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp)
- [RobinReach MCP server reference](https://robinreach.com/mcp)

---
Start free: https://robinreach.com/users/sign_up. AI integrations from Bloom, $24 a month. All AI integrations: https://robinreach.com/ai/integrations.md