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

# Hermes Agent

> Connect Hermes Agent to BugRadar through MCP

Connect Hermes Agent so you can list flows, run them, debug runs, and search BugRadar docs from a Hermes session.

BugRadar is a remote HTTP MCP server. It is not in the Hermes catalog. Add it in `~/.hermes/config.yaml` with `auth: oauth`. The first time Hermes connects, it opens a browser so you can sign in. No API key goes in the file. Hermes stores the token under `~/.hermes/mcp-tokens/`.

`hermes mcp add --auth header` writes `Authorization: Bearer`. Do not use that. `--auth oauth` writes the same block as below.

## Setup

1. Open **[Settings → Integrations → Hermes Agent](https://usebugradar.com/settings?tab=integrations\&integration=hermes-agent)** and copy the config
2. Open `~/.hermes/config.yaml`. If `mcp_servers` is already there, add only the `BugRadar` entry next to your other servers. If it is not, paste the whole block:

```yaml theme={null}
mcp_servers:
  BugRadar:
    url: "https://mcp.usebugradar.com/mcp"
    auth: oauth
```

Or from a terminal:

```bash theme={null}
hermes mcp add --url https://mcp.usebugradar.com/mcp --auth oauth BugRadar
```

3. Start Hermes, or run `/reload-mcp` if it is already open. Sign in when the browser opens
4. Ask Hermes to list or run a flow

> [!NOTE]
>
> Do not use STDIO (`--command`, `npx`, or `mcp-remote`). BugRadar is not a local process. Adding BugRadar in Cursor (`mcp.json`) does not install it in Hermes Agent.

See [MCP Server](/docs/mcp-setup.md) for the tools Hermes Agent can call after you connect.


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