---
title: "BankBridge for AI agents: install instructions for every host"
description: "How an AI agent connects its user's bank accounts through BankBridge: endpoint, auth, demo key, and copy-paste configs for Claude, ChatGPT, Cursor, Gemini, Codex and 25 more hosts."
url: "https://bankbridge.money/agents"
---
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

1.  Send the user to [bankbridge.money/login](https://bankbridge.money/login) to sign up with their email. You can’t do this for them: it needs their inbox.
2.  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.
3.  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](https://bankbridge.money/dashboard/settings).
4.  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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/claude-code)

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/claude-desktop)

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](https://bankbridge.money/docs/claude-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](https://bankbridge.money/docs/claude-web)

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/claude-cowork)

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

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)](https://bankbridge.money/docs/chatgpt-apps-sdk)

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](https://bankbridge.money/docs/chatgpt-apps-sdk)

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](https://bankbridge.money/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](https://bankbridge.money/docs/chatgpt-enterprise)

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/responses-api)

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

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

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

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/codex-cloud)

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/gemini-cli)

Gemini CLI

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

### [Gemini Code Assist](https://bankbridge.money/docs/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](https://bankbridge.money/docs/gemini-code-assist)

Gemini Code Assist

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

### [Vertex AI](https://bankbridge.money/docs/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](https://bankbridge.money/docs/vertex-ai)

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

GitHub Copilot

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

### [Cursor](https://bankbridge.money/docs/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](https://bankbridge.money/docs/cursor)

Cursor

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

### [Windsurf](https://bankbridge.money/docs/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](https://bankbridge.money/docs/windsurf)

Windsurf

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

### [Continue.dev](https://bankbridge.money/docs/continue)

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

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

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

Cline / Roo Code

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

### [Zed](https://bankbridge.money/docs/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](https://bankbridge.money/docs/zed)

Zed

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

### [JetBrains Junie](https://bankbridge.money/docs/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](https://bankbridge.money/docs/junie)

JetBrains Junie

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

### [Kiro](https://bankbridge.money/docs/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](https://bankbridge.money/docs/kiro)

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

opencode

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

### [OpenClaw](https://bankbridge.money/docs/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](https://bankbridge.money/docs/openclaw)

OpenClaw

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

### [Goose](https://bankbridge.money/docs/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](https://bankbridge.money/docs/goose)

Goose

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

### [Warp](https://bankbridge.money/docs/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](https://bankbridge.money/docs/warp)

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

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](https://bankbridge.money/docs/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](https://bankbridge.money/docs/lm-studio)

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

## Building your own?

Raw MCP for custom integrations.

### [Any MCP-speaking client](https://bankbridge.money/docs/api)

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

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)](https://bankbridge.money/llms.txt) `/llms.txt`
-   [llms-full.txt (full reference + every guide)](https://bankbridge.money/llms-full.txt) `/llms-full.txt`
-   [This page as markdown](https://bankbridge.money/agents.md) `/agents.md`
-   [MCP server card](https://bankbridge.money/.well-known/mcp/server-card.json) `/.well-known/mcp/server-card.json`
-   [Agent skill (SKILL.md)](https://bankbridge.money/.well-known/agent-skills/bankbridge/SKILL.md) `/.well-known/agent-skills/bankbridge/SKILL.md`
-   [API catalog (RFC 9727)](https://bankbridge.money/.well-known/api-catalog) `/.well-known/api-catalog`
-   [OAuth protected resource metadata](https://bankbridge.money/.well-known/oauth-protected-resource) `/.well-known/oauth-protected-resource`