Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openfinance.tech/llms.txt

Use this file to discover all available pages before exploring further.

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:
mcp_servers:
  openfinance-tech:
    url: "https://api.openfinance.tech/agent/mcp"
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.