Hermes

Hermes Agent (from Nous Research) speaks MCP natively. You can add OpenFinance either through the CLI or by editing the config file directly.

Option A, CLI

hermes mcp add openfinance-tech --url https://api.openfinance.tech/agent/mcp

Verify it is configured:

hermes mcp list

Test the connection:

hermes mcp test openfinance-tech

Option B, edit `config.yaml`

Open ~/.hermes/config.yaml and add the OpenFinance server under mcp_servers:

Public-only
With wallet tools

mcp_servers:
  openfinance-tech:
    url: "https://api.openfinance.tech/agent/mcp"

mcp_servers:
  openfinance-tech:
    url: "https://api.openfinance.tech/agent/mcp"
    headers:
      x-api-key: "open_xxxxx"

Hermes uses YAML, not JSON. Indentation matters, use two spaces and avoid tabs.

Tool filtering (optional)

Hermes recommends a least-privilege approach. You can restrict which OpenFinance tools the agent sees with an include whitelist:

mcp_servers:
  openfinance-tech:
    url: "https://api.openfinance.tech/agent/mcp"
    headers:
      x-api-key: "open_xxxxx"
    tools:
      include: [getFundingRates, getPositions, previewTrade]

This is a good pattern when you only want the agent to read data and preview trades, but never build or submit transactions.

Reload

Run /reload-mcp inside Hermes, or restart the agent. OpenFinance tools will appear alongside Hermes’s built-in tools.

Getting Started

Coding Agents

Chat Clients

Reference

Option A, CLI

Option B, edit `config.yaml`

Tool filtering (optional)

Reload

​Option A, CLI

​Option B, edit config.yaml

​Tool filtering (optional)

​Reload

Option A, CLI

Option B, edit `config.yaml`

Tool filtering (optional)

Reload