MCP guide

Connect an agent

Banks MCP gives compatible agents a standard, read-only interface to the bank connections on this computer. Keep this server running while the agent uses it.

1. Add the local endpoint

The agent and Banks MCP must run on the same computer.

Endpoint

http://127.0.0.1:8765/mcp

Terminal command

codex mcp add banks --url http://127.0.0.1:8765/mcp

2. Try a first prompt

Select an example to copy it to your clipboard.

“List my connected bank accounts and their currencies.”
“Summarize my balances without combining currencies.”
“Show recent activity for my personal bank connection.”

Available tools

Every current tool is read-only, non-destructive, and idempotent.

List bank connections

See which banks this device can access.

List bank products

Inspect accounts, cards, and masked identifiers.

Get balance summary

Summarize assets and liabilities by currency.

List transactions

Read bounded history for a connected account.

Get recent activity

Review recent activity across bank products.

Local security model

Banks MCP is designed to keep access scoped to this computer.

Loopback only

The server binds to 127.0.0.1 and validates browser origins and host headers.

Credentials stay private

Credentials remain encrypted locally and are never returned by an MCP tool.

Connection troubleshooting

If a client cannot connect, confirm Banks MCP is running and its configured URL exactly matches the endpoint above.