Skip to main content

​
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:
The config is a base64url-encoded JSON object with the server’s url and headers:
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:
Then start Hermes:
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:
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.