For AI agents

Install BankBridge for your user.

BankBridge is a hosted, read-only MCP server that gives an AI agent 12 tools over its user’s real bank, credit card and brokerage accounts: balances, transactions, spending summaries, recurring charges, cashflow and holdings. If you are an agent reading this, the user has to do two things you can’t (sign up and link their bank). You handle the config below.

Connection facts

MCP endpoint: https://bankbridge.money/api/mcp
Transport: Streamable HTTP (MCP 2025-06-18 and 2025-11-25)
Auth: Authorization: Bearer bbk_... API key, or OAuth 2.1 with Dynamic Client Registration + PKCE (discovered from /.well-known/oauth-protected-resource)
Demo key: Bearer bbk_demo returns deterministic fictional data, no signup
Access: Read-only. Cannot move money, change settings, or trade.
Data retention: None. Every tool call is fetched live from the bank.
Price: $5/month or $50/year per connected bank. No free plan, cancel any time.
MCP Registry: money.bankbridge/server

Setup, in order

Send the user to bankbridge.money/login to sign up with their email. You can’t do this for them: it needs their inbox.
They link each bank from the dashboard (about 30 seconds per bank, needs their bank login). Pricing: $5/month or $50/year per connected bank. No free plan, cancel any time.
Add the server to your host with the config for your host below. Hosts with OAuth connectors (Claude Desktop, claude.ai, Perplexity) only need the URL. Everything else takes the URL plus the user’s bbk_ key from dashboard settings.
Ask something real: “What did I spend on restaurants last month?” If a tool result has a warnings array, tell the user each warning before answering.

Want to test before the user pays? Use Authorization: Bearer bbk_demo for fictional data.

Claude

Anthropic's consumer + developer surfaces.

Claude Code

Ask Claude Code where your money went this month. One paste-and-run plugin command connects your bank, read-only, ready in about a minute. Full steps

Claude Code

/plugin marketplace add bankbridge-money/bankbridge-plugin
/plugin install bankbridge

# When prompted for an API token, paste:
# bbk_your_api_key_here

Claude Desktop

Check balances and spending from Claude Desktop. Add one Custom Connector, sign in with OAuth, and start asking about your accounts in about two minutes. Full steps

Claude Desktop

1. Claude Desktop → Settings → Connectors → Add custom connector
2. URL: https://bankbridge.money/api/mcp
3. Leave Advanced settings empty. OAuth is auto-discovered.
4. Click Connect, sign in to BankBridge, click Allow.

(No token needed. OAuth handles it.)

Claude.ai web

Ask Claude on the web what your credit card balance is. BankBridge is in the Claude Connectors Directory: open the listing, click Connect, sign in. Done in under a minute. Full steps

Claude.ai web

1. claude.ai → Settings → Connectors → Add custom connector
2. URL: https://bankbridge.money/api/mcp
3. Leave Advanced settings empty. OAuth is auto-discovered.
4. Click Connect, sign in to BankBridge, click Allow.

(No token needed. OAuth handles it.)

Claude Cowork

Ask Claude Cowork what you spent on groceries last month. Add the connector once on claude.ai and it appears in every Cowork session, no reinstall. Full steps

Claude Cowork

1. claude.ai → Settings → Connectors → Add custom connector
2. URL: https://bankbridge.money/api/mcp
3. Leave Advanced settings empty. OAuth is auto-discovered.
4. Click Connect, sign in to BankBridge, click Allow.

(No token needed. OAuth handles it.)

ChatGPT & OpenAI

Consumer app, Enterprise, and API.

ChatGPT

Ask ChatGPT where your money went last month. Paste one URL and token in Developer Mode. Works on Plus, Pro, Business, Enterprise, and Edu. Full steps

ChatGPT

1. ChatGPT → Settings → Connectors → Advanced → Developer Mode
2. Import remote MCP
3. URL: https://bankbridge.money/api/mcp
4. Auth: Custom token
5. Authorization: Bearer bbk_your_api_key_here

ChatGPT (Apps SDK / OAuth)

Add your bank to ChatGPT the OAuth way. Find BankBridge under Settings, Connectors, Browse, sign in, and skip tokens and Developer Mode entirely. Full steps

ChatGPT (Apps SDK / OAuth)

1. ChatGPT → Settings → Connectors → Browse
2. Search for 'BankBridge' and click Add
3. OAuth dialog → sign in → Allow

(Requires BankBridge to be approved in the ChatGPT Apps directory.
 Until then, use the Developer Mode path. See the ChatGPT docs.)

ChatGPT Enterprise

Roll out bank data to your whole ChatGPT Enterprise workspace. Add one connector in the admin console and every member signs in with their own key. Full steps

ChatGPT Enterprise

1. chatgpt.com/admin → Connectors → Custom connectors → Add
2. URL: https://bankbridge.money/api/mcp
3. Authentication: Custom token
4. Header: Authorization: Bearer <member's bbk_ key>

(Each member uses their own BankBridge API key. Financial data is
 per-user, so there's no shared-credential mode.)

OpenAI Responses API

Give your OpenAI Responses API app live bank data with one remote MCP tool block. About 6 lines of code, then ask it to total last month's spending. Full steps

OpenAI Responses API

{
  "model": "gpt-4.1",
  "input": "How much did I spend on restaurants last month?",
  "tools": [
    {
      "type": "mcp",
      "server_label": "bankbridge",
      "server_url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      },
      "require_approval": "never"
    }
  ]
}

OpenAI AgentKit

Give your OpenAI AgentKit agents live bank data. One URL plus a header in MCPServerStreamableHttp, and they can total last month's spending. Full steps

OpenAI AgentKit

import { Agent, MCPServerStreamableHttp } from "openai-agents";

const bankbridge = new MCPServerStreamableHttp({
  url: "https://bankbridge.money/api/mcp",
  headers: {
    Authorization: `Bearer ${process.env.BANKBRIDGE_API_KEY}`,
  },
});

const agent = new Agent({
  model: "gpt-4.1",
  mcpServers: [bankbridge],
});

const result = await agent.run("How is my spending trending?");

// export BANKBRIDGE_API_KEY="bbk_your_api_key_here"

Codex CLI

Ask Codex CLI what you spent last week without leaving the terminal. A short config.toml block plus one feature flag connects the bank-data MCP. Full steps

Codex CLI

# Older Codex builds only: add once at top level
# experimental_use_rmcp_client = true

[mcp_servers.bankbridge]
url = "https://bankbridge.money/api/mcp"
bearer_token_env_var = "BANKBRIDGE_API_KEY"

# Then in your shell:
# export BANKBRIDGE_API_KEY="bbk_your_api_key_here"

Codex Cloud

Ask Codex Cloud what you spent last month, straight from a cloud task. Add one MCP entry per environment and the bank-data tools are available. Full steps

Codex Cloud

1. Codex Cloud → your environment → MCP Servers → + Add server
2. URL: https://bankbridge.money/api/mcp
3. Auth type: Bearer token
4. Token: bbk_your_api_key_here

Google / Gemini

CLI, Code Assist, and Vertex SDK.

Gemini CLI

Ask Gemini CLI what you spent last month, straight from the terminal. One settings.json edit connects your real bank data, read-only, in about 2 minutes. Full steps

Gemini CLI

{
  "mcpServers": {
    "bankbridge": {
      "httpUrl": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Gemini Code Assist

Ask Gemini Code Assist about your spending without leaving VS Code. It reads the same settings.json as Gemini CLI, so setup takes one 2-minute edit. Full steps

Gemini Code Assist

{
  "mcpServers": {
    "bankbridge": {
      "httpUrl": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Vertex AI

Let your Gemini app answer real money questions through Vertex AI's native MCP support. One tool block, then ask for last month's biggest charges. Full steps

Vertex AI

from google import genai
from google.genai import types

client = genai.Client(vertexai=True, project="your-project", location="us-central1")

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="How much did I spend on restaurants last month?",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                mcp=types.McpTool(
                    endpoint="https://bankbridge.money/api/mcp",
                    headers={"Authorization": "Bearer bbk_your_api_key_here"},
                )
            )
        ]
    ),
)
print(response.text)

IDEs & agents

Every major coding agent with MCP.

GitHub Copilot

Ask GitHub Copilot where your money went last month, right in VS Code. One click installs the bank-data MCP server, no JSON editing required. Full steps

GitHub Copilot

{
  "servers": {
    "bankbridge": {
      "type": "http",
      "url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Cursor

Ask Cursor what you spent last month or which subscriptions crept up. One-click install adds the bank-data MCP server, no config file edits needed. Full steps

Cursor

{
  "mcpServers": {
    "bankbridge": {
      "url": "https://bankbridge.money/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Windsurf

Ask Windsurf's Cascade agent where your money went last month. One entry in mcp_config.json connects your bank, about a 2-minute setup. Full steps

Windsurf

{
  "mcpServers": {
    "bankbridge": {
      "serverUrl": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Continue.dev

Ask Continue.dev to total your recurring charges or chart last month's spending. Add one block to config.yaml and the bank-data MCP loads instantly. Full steps

Continue.dev

mcpServers:
  - name: bankbridge
    type: streamable-http
    url: https://bankbridge.money/api/mcp
    requestOptions:
      headers:
        Authorization: Bearer bbk_your_api_key_here

Cline / Roo Code

Ask Cline how much you spent last week without leaving VS Code. One JSON snippet in the MCP config connects your bank to Cline or Roo Code, read-only. Full steps

Cline / Roo Code

{
  "mcpServers": {
    "bankbridge": {
      "type": "streamable-http",
      "url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Zed

Ask Zed's assistant how much you spent on subscriptions this month. One paste into settings.json adds the bank-data context server, under 2 minutes. Full steps

Zed

{
  "context_servers": {
    "bankbridge": {
      "source": "custom",
      "command": null,
      "url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

JetBrains Junie

Ask Junie about your real spending right inside IntelliJ, PyCharm, or WebStorm. One mcp.json entry connects your bank accounts in about 2 minutes. Full steps

JetBrains Junie

{
  "mcpServers": {
    "bankbridge": {
      "type": "http",
      "url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Kiro

Ask Kiro what your burn rate was last month while you code. Add BankBridge from the Kiro Powers MCP panel and get read-only bank data in 2 minutes. Full steps

Kiro

1. Kiro → Kiro Powers → + Add MCP Server
2. URL: https://bankbridge.money/api/mcp
3. Authorization: Bearer bbk_your_api_key_here
4. Save + Enable in any session.

opencode

Query your real transactions from opencode. Paste one block into opencode.json, then ask what you spent on hosting in June. Read-only, 2-minute setup. Full steps

opencode

{
  "mcp": {
    "bankbridge": {
      "type": "remote",
      "url": "https://bankbridge.money/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

OpenClaw

Ask OpenClaw what you spent last month. One mcp set command gives it read-only access to your bank accounts, transactions, and recurring charges. Full steps

OpenClaw

openclaw mcp set bankbridge '{
  "url": "https://bankbridge.money/api/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer bbk_your_api_key_here"
  }
}'

Goose

Ask Goose how much you spent on groceries this month. One goose configure command connects your bank accounts, read-only, in under 2 minutes. Full steps

Goose

$ goose configure
→ Add Extension → Remote (URL)
→ Name: bankbridge
→ URL: https://bankbridge.money/api/mcp
→ Header: Authorization: Bearer bbk_your_api_key_here

Warp

Ask Warp's AI agent what you spent this week without leaving your terminal. Add the bank-data MCP from the AI panel in about 90 seconds. Full steps

Warp

1. Warp → Settings → AI → MCP → + Add
2. Server type: HTTP (remote)
3. URL: https://bankbridge.money/api/mcp
4. Header: Authorization: Bearer bbk_your_api_key_here

Raycast

Check a balance or last month's spend without leaving Raycast. Install the MCP once, then type @bankbridge in Raycast AI, straight from the launcher. Full steps

Raycast

1. Raycast → Install Server → MCP
2. URL: https://bankbridge.money/api/mcp
3. Bearer token: bbk_your_api_key_here

Invoke from anywhere with @bankbridge in Raycast.

LM Studio

Ask your local model in LM Studio what you spent last month. One click installs the bank-data MCP via deeplink, read-only, live in about a minute. Full steps

LM Studio

Click the 'Add to LM Studio' button on bankbridge.money
- or paste this into LM Studio's mcp.json:

{
  "mcpServers": {
    "bankbridge": {
      "type": "http",
      "url": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Perplexity

Ask Perplexity where your money went this month. Add the bank-data connector on Pro, Max, or Enterprise, click Connect, sign in. No API key to paste. Full steps

Building your own?

Raw MCP for custom integrations.

Any MCP-speaking client

Point any MCP client at your bank. One endpoint, one bearer token, standard streamable HTTP. Try tools/list with curl in under a minute. Full steps

Any MCP-speaking client

curl -N https://bankbridge.money/api/mcp \
  -H "Authorization: Bearer bbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Tools

list_accounts: Balances and types for every connected account.
get_account: Detail lookup for one account by id.
list_transactions: Transactions filtered by date, amount, category or account (paginated).
search_transactions: Substring search over transaction name and merchant.
get_spending_summary: Spending grouped by category, merchant, month or week.
get_recurring_charges: Detected subscriptions, bills and other recurring charges.
get_monthly_cashflow: Income vs expenses for a month plus top sources and categories.
get_merchant_history: Every charge from one merchant plus totals and cadence.
list_categories: Spending categories present in the user's data.
list_holdings: Current investment positions with cost basis and gain/loss.
list_investment_transactions: Buys, sells, dividends, fees and transfers.
connect_bank: Returns a URL the user opens once to link another bank.

Machine-readable files

llms.txt (index of every page) /llms.txt
llms-full.txt (full reference + every guide) /llms-full.txt
This page as markdown /agents.md
MCP server card /.well-known/mcp/server-card.json
Agent skill (SKILL.md) /.well-known/agent-skills/bankbridge/SKILL.md
API catalog (RFC 9727) /.well-known/api-catalog
OAuth protected resource metadata /.well-known/oauth-protected-resource