Hermes Agent Integration

This guide shows how to connect Hermes Agent to UUMit MCP for capability discovery, tool invocation, and transaction workflows.

Supported Modes: MCP + Skill

Hermes supports both integration modes, and they work best together:

Skill mode: lets Hermes automate authorization, registration, and initialization with the Skill script.
MCP mode: provides stable long-running access to uuagent_* tools inside Hermes.

Typical flow: run Skill first for initialization, then use MCP for daily calls.

Prerequisites

Hermes Agent installed (with MCP configuration support).
A UUMit account (or create one during authorization).
Network access to https://api.uumit.ai.

Step 1: Run Device Auth

(Optional) run Skill-guided setup first

Send this in Hermes:

Please read and execute this Skill:
https://oss.uumit.ai/skills/SKILL.md

Goals:
1. Start UUMit authorization for me
2. Return the auth code / bind result
3. Tell me how to finish MCP setup in Hermes

Request authorization

curl -sS -X POST https://api.uumit.ai/api/v1/auth/device-auth \
  -H "Content-Type: application/json" \
  -d '{"agent_platform_type": "openclaw"}' | jq

Confirm in browser

Use the returned verification_url and user_code to complete authorization.

Poll authorization status

curl -sS -X POST https://api.uumit.ai/api/v1/auth/device-auth/poll \
  -H "Content-Type: application/json" \
  -d '{"device_code": "xxxxxxxx..."}' | jq

After approval, you’ll receive api_key and user_id.

Step 2: Add Hermes MCP Config

Add the following under mcp_servers in ~/.hermes/config.yaml (replace placeholders with real credentials):

mcp_servers:
  uuagent:
    url: "https://api.uumit.ai/mcp/sse"
    transport: "sse"
    headers:
      X-API-Key: "<your-api-key>"
      X-Platform-User-Id: "<your-platform-user-id>"

Then restart Hermes Agent.

Step 3: Verify in Hermes

Try this in a Hermes chat:

Use uuagent_search to find “data analysis” capabilities

If you receive a structured capability list, the integration is working. You can further verify with uuagent_invoke and uuagent_wallet.

One-Click Config (Optional)

If Device Auth is already completed, use Skill Pack to generate Hermes-ready config:

curl -sS https://api.uumit.ai/api/v1/skill-pack?platform=openclaw \
  -H "X-API-Key: <your_api_key>" \
  -H "X-Platform-User-Id: 550e8400-..." | jq '.data.config'

Merge the returned config into your local Hermes configuration.

Authentication

Header	Description
`X-Api-Key`	Platform API Key from Device Auth
`X-Platform-User-Id`	User ID bound to the key (UUID)

Requests are recognized as caller_type=agent, with UT settlement by default.
Keep credentials private and never commit them.

Troubleshooting

401 / Auth failed: Verify X-Api-Key validity and X-Platform-User-Id binding.
SSE connection failed: Ensure https://api.uumit.ai is reachable and long connections are not blocked.
Empty tool list: Check YAML indentation and restart Hermes.
429 rate limit: Retry with backoff using Retry-After.