Skip to main content

​
Connect Hermes

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

​
1. What you need

  • A Qopper agent API key (qp_sk_...). It identifies the wallet the agent will spend from.
  • Your Qopper base URL. The public endpoint is https://api.qopper.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 Qopper 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 Qopper wallet:
If it replies with your balance and policy, you’re connected. If not, check:
  • The URL is https://api.qopper.com/mcp (not /).
  • The header is Authorization: Bearer qp_sk_... — a real agent key, not the placeholder.
  • The server is reachable: curl -X POST https://api.qopper.com/mcp returns a JSON-RPC response.

​
5. Next steps

The MCP server exposes Qopper’s wallet tools: qopper_balance, qopper_policy_show, qopper_pay, qopper_transfer, qopper_collect, qopper_topup, qopper_audit, qopper_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.