> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Add Spiral to Hermes Agent as a remote MCP server: one command, sign in, no API key.

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**

```bash theme={null}
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

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**

```bash theme={null}
hermes mcp list
hermes mcp test spiral
```

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

**3. Try a starter prompt**

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

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.

> [accordion] Hermes on a server or over SSH
>
> 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:
>
> ```bash theme={null}
> ssh -N -L <port>:127.0.0.1:<port> user@your-server
> ```

> [accordion] With an API key instead
>
> Keep a key from **API keys** in the console in `~/.hermes/.env`:
>
> ```bash theme={null}
> SPIRAL_API_KEY=<your API key>
> ```
>
> and add Spiral under `mcp_servers` in `~/.hermes/config.yaml`. Hermes fills in `${SPIRAL_API_KEY}` when it connects:
>
> ```yaml theme={null}
> mcp_servers:
>   spiral:
>     url: "https://api.spiral.ai/mcp"
>     headers:
>       Authorization: "Bearer ${SPIRAL_API_KEY}"
> ```
>
> Then run `/reload-mcp` in a chat, or start a new session.

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.