Connect Hermes Agent

Nous Research's open-source agent, a desktop app and CLI that also runs in Telegram, Discord, Slack, WhatsApp, Signal and email.

Before you start

Create an API key in the app under Settings, then API Keys. Grant only the permissions this agent needs. The key is shown once. Replace pk_live_xxx in the snippets below with it.

Local install

Runs the MCP server on your own machine through npx, so your key never leaves it. Needs Node 18 or newer.

text

Add an MCP server by local command:

Command:  npx
Args:     -y planpost-mcp
Env:      PLANPOST_API_KEY=pk_live_xxx

Things that catch people out

Hermes manages MCP servers from its settings and a CLI, and servers can be added by URL or by local command. The local command above is the tested path.
Hermes documents SSE for remote servers. Our hosted endpoint speaks streamable HTTP, which is the newer transport, so verify a URL connection against your Hermes version before relying on it and use the local command if it does not connect.
MCP servers you add are disabled by default in Hermes until you enable them, which is deliberate on their side.

Check it works

Ask the agent to list your connected accounts. If it comes back with them, all 47 tools are available.

prompt

Which social accounts do I have connected on planpo.st?

Hermes Agent MCP documentation All 47 tools REST API reference

← Docs