Hermes Agent

One block in config.yaml.

Hermes Agent reads MCP servers from ~/.hermes/config.yaml. Add BankBridge there and hermes mcp test lists its tools.

Read-only. Your agent can see balances and transactions, and nothing can move money, pay a bill, or place a trade. BankBridge doesn’t store your transactions. How it’s secured · Try it with sample data first

Step 01

Add BankBridge to config.yaml.

~/.hermes/config.yaml

mcp_servers:
  bankbridge:
    url: "https://bankbridge.money/api/mcp"
    headers:
      Authorization: "Bearer bbk_your_api_key_here"

Restart Hermes Agent after editing the config.

Installed Hermes with pip? Install the MCP extra too: pip install "hermes-agent[mcp]". Without it, Hermes stops with a message that the streamable HTTP client is not available.

Step 02

Verify it works.

Run hermes mcp test bankbridge. It connects and reports Tools discovered: 12. In a session that was already open, run /reload-mcp. Then ask:

try this

list my bank accounts and balances

To test the config before you sign up, use the key bbk_demo. It returns sample data.

Running Hermes Agent on a local model? Here is what stays on your machine.

With Ollama, Hermes refuses models under a 64,000-token context. The Ollama guide has the settings.

Troubleshooting

Client connects but shows 0 tools.

Usually the client is caching an old config, or you're on a mode that doesn't expose tools (Ask/Edit vs Agent, for example).

Fix: Fully quit + relaunch the host app. In VS Code Copilot, switch to Agent mode.

401 Unauthorized on every call.

The API key is missing, typo'd, or got revoked. Check the Authorization header starts with `Bearer ` (note the space) and ends in a key you still own.

Fix: Paste a fresh key from Settings.

Tools return a NO_CONNECTIONS warning.

You haven't linked a bank yet.

Fix: Visit Connect a bank . The bank-connect flow opens automatically, ~30 seconds.

Problems? Email hello@greatwork.company with the app you’re setting up and what you see, and we’ll help you finish.