Skip to main content
This page connects Hermes Agent to Spiral as an MCP client. It is not hermes mcp serve, which shares Hermes itself with other agents.
1

Add the server and sign in

Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? [Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
2

Check it

In a chat that was already open, run /reload-mcp.
3

Try a starter prompt

Don’t run hermes mcp login spiral after an add that worked: it deletes the saved sign-in and starts it again. Run it only to sign in again later.
Hermes waits for the sign-in on http://127.0.0.1:<port>/callback on the machine it runs on. From your own computer, forward that port first, then open the link Hermes prints:
Keep a key from API keys in the console in ~/.hermes/.env:
and add Spiral under mcp_servers in ~/.hermes/config.yaml. Hermes fills in ${SPIRAL_API_KEY} when it connects:
Then run /reload-mcp in a chat, or start a new session.
If something does not work, see Troubleshooting.