---
title: "Hermes Agent Bank Data MCP: One Config Block | BankBridge"
description: "Ask Hermes Agent what you spent last month. Add one block to ~/.hermes/config.yaml and hermes mcp test lists 12 read-only bank tools."
url: "https://bankbridge.money/docs/hermes"
---
[← All integrations](https://bankbridge.money/docs)

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](https://bankbridge.money/security) · [Try it with sample data first](https://bankbridge.money/demo)

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](https://bankbridge.money/local-agents).

With Ollama, Hermes refuses models under a 64,000-token context. The [Ollama guide](https://bankbridge.money/guides/how-to-give-ollama-access-to-your-bank-account) 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](https://bankbridge.money/dashboard/settings).

Tools return a NO\_CONNECTIONS warning.

You haven't linked a bank yet.

**Fix:** Visit [Connect a bank](https://bankbridge.money/dashboard/connect) . The bank-connect flow opens automatically, ~30 seconds.

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