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

# Hermes

> Connect Hermes to Breakcold MCP.

<img src="https://raw.githubusercontent.com/NousResearch/hermes-agent/main/website/static/img/apple-touch-icon.png" alt="Hermes logo" width="56" height="56" style={{ borderRadius: "8px" }} />

Website: [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/docs)

Use Breakcold as a remote MCP server in Hermes so Hermes agents can use approved Breakcold tools.

## MCP endpoint

```txt theme={null}
https://mcp.breakcold.com/mcp/v1
```

## Setup

Add Breakcold as an MCP server in your Hermes config:

```yaml theme={null}
mcp_servers:
  breakcold:
    url: "https://mcp.breakcold.com/mcp/v1"
    auth: oauth
    tools:
      resources: false
      prompts: false
```

Restart Hermes or reload MCP:

```txt theme={null}
/reload-mcp
```

Hermes opens an OAuth authorization flow on first connect and stores MCP tokens for future sessions.

If you need bearer-token access instead, replace `auth: oauth` with an authorization header:

```yaml theme={null}
headers:
  Authorization: "Bearer <your Breakcold bearer key>"
```

For sensitive CRM access, start with narrow permissions and only expose the Breakcold tools the Hermes agent needs.