OpenAI AgentKit

MCPServerStreamableHttp.

The OpenAI Agents SDK has first-class MCP support. Agent Builder’s visual flow also exposes an MCP node. Both paths take the same URL + header combo.

Step 01

Pass BankBridge to your agent.

TypeScript (openai-agents SDK)

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"

Step 02

Or in the visual Agent Builder.

Drag an MCP node onto the canvas. Set URL to https://bankbridge.money/api/mcp. In the auth panel, add a custom header Authorization with value Bearer bbk_your_api_key_here. Save.

Step 03

Verify it works.

Run your agent. Expected tool call:

expected

get_spending_summary({ group_by: "month", start_date: "2025-11-01", end_date: "2026-04-30" })

Where do I get a token?

Grab one from your dashboard — it starts with bbk_. Store it in a secret manager (Vercel/Fly env vars, AWS Secrets Manager, etc.), never in your client bundle. Requires an active BankBridge subscription.

Troubleshooting

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.

403 Forbidden.

Your BankBridge subscription is inactive (canceled or past-due), or your account has no connected banks.

Fix: Visit Settings to confirm your subscription is active.

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@bankbridge.money.