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

# Connect Hermes

> Point Hermes Agent (Nous Research) at Payzor over MCP and let it check balances, pay, and transfer — with a one-click install.

# Connect Hermes

Hermes Agent (Nous Research) is a self-hosted AI agent that can act as an **MCP client**. Payzor exposes a remote MCP server over HTTP, so you can give Hermes a Payzor wallet in a couple of steps — or with **one click** if you're on the Hermes desktop app.

## 1. What you need

* A Payzor **agent API key** (`pz_sk_...`). It identifies the wallet the agent will spend from.
* Your Payzor **base URL**. The public endpoint is `https://api.payzor.com`; use `http://localhost:3040` only for local development.

## 2. One-click install ("Add to Hermes")

Hermes supports a deep link that opens the desktop app with a pre-filled server config — the same pattern Cursor uses:

```
hermes://mcp/install?name=payzor&config=<BASE64URL>
```

The `config` is a base64url-encoded JSON object with the server's `url` and `headers`:

```json theme={null}
{
  "url": "https://api.payzor.com/mcp",
  "headers": { "Authorization": "Bearer pz_sk_..." }
}
```

Hermes shows a confirmation dialog with the server name and the full config; confirm to enable it. From the Payzor console, select **Hermes** on the **Connect MCP** page and click **Add to Hermes** — the link is generated for you with your base URL.

## 3. Manual config (`~/.hermes/config.yaml`)

If you prefer to write the config by hand (or you're running Hermes from a terminal), add the server to `~/.hermes/config.yaml`:

```yaml theme={null}
mcp_servers:
  payzor:
    url: "https://api.payzor.com/mcp"
    headers:
      Authorization: "Bearer pz_sk_..."
    tools:
      # Optional: keep the surface minimal — only read/balance, for example.
      include: [payzor_balance, payzor_auth_status]
```

Then start Hermes:

```bash theme={null}
hermes chat
```

Hermes discovers MCP servers at startup. To reload after changing the config, run `/reload-mcp`.

## 4. Verify it connected

Ask Hermes to use the Payzor wallet:

```text theme={null}
What's my Payzor balance and what can I spend it on?
```

If it replies with your balance and policy, you're connected. If not, check:

* The URL is `https://api.payzor.com/mcp` (not `/`).
* The header is `Authorization: Bearer pz_sk_...` — a real agent key, not the placeholder.
* The server is reachable: `curl -X POST https://api.payzor.com/mcp` returns a JSON-RPC response.

## 5. Next steps

The MCP server exposes Payzor's wallet tools: `payzor_balance`, `payzor_policy_show`, `payzor_pay`, `payzor_transfer`, `payzor_collect`, `payzor_topup`, `payzor_audit`, `payzor_auth_status`. That shell runs through the same wallet and policy engine as the console — the agent's spending rules still apply to every payment.