Hermes

Hermes Agent speaks MCP natively, so there is nothing extra to install. The CLI is quicker, but either way you end up with an entry in ~/.hermes/config.yaml that holds your key.

Option A, CLI

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

Then add your x-api-key header to the new entry in ~/.hermes/config.yaml, as shown in Option B. Every request needs it, market data included. 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 with your key. Please make an account at openfinance.tech to get your keys. The entry looks like this:

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

Hermes uses YAML, not JSON. Indentation matters, so 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: [get_wallet_addresses, onchain_search_tokens, onchain_get_token_usd_price, onchain_get_address_holdings, relay_get_quote]

This is a good pattern when you only want the agent to read wallet, token and quote data. The hyperliquid and polymarket tools each combine reads and writes behind one tool, so a filter cannot make them read-only.

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

Help

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 B, edit `config.yaml`