How to Use the Brex MCP in Windsurf

Q: Can Cascade run a multi-step Brex payment flow in Windsurf without my constant approval?

Yes, Cascade chains actions like checking balances with brexgetbalance and executing payments via brexpayvendor autonomously. It displays the planned sequence in the chat panel, runs the tools, and reports the final status.

Let Windsurf's Cascade autonomously issue Brex virtual cards, audit team budgets, and pay vendors directly from your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brex MCP to Windsurf

Create your Vinkius account to connect Brex to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Brex with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Issue Brex Virtual Cards Autonomously in Windsurf

The `brex_create_card` tool lets Cascade spin up virtual corporate cards without manual form-filling. You tell Cascade to provision a card for a new SaaS subscription, and it reads your local setup, determines the vendor name, and issues the card. Because Cascade chains tools, it doesn't stop at card creation. It runs `brex_list_budgets` to find the correct team allocation, assigns the card, and outputs the final card details directly into your workspace.

Onboard Employees and Assign Budgets via MCP Server

The `brex_create_user` tool adds new hires to your corporate account directly from your Windsurf terminal context. When you check in a new employee profile to your codebase, Cascade spots the change and invites them immediately. It then calls `brex_list_users` to verify the invitation pending status and matches them with active budgets. You don't have to jump into the Brex dashboard to verify if the invitation went through.

Pay Vendors and Check Balances in Windsurf

The `brex_pay_vendor` tool sends money to approved suppliers directly through Cascade's autonomous execution loop. Cascade reads your local invoice files, verifies the vendor exists using `brex_list_vendors`, and processes the payment. If the vendor is missing, Cascade executes `brex_create_vendor` before paying, then verifies your remaining cash reserves via `brex_get_balance`. All of this happens in one single prompt inside your editor.

Setup guide

Set up Brex MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Brex MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Brex payment history." If connected, Cascade will call the Brex tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "brex-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Brex. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Brex now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Brex MCP in Windsurf

You add your Brex token to your local Windsurf configuration file under the mcpServers block. Cascade uses this single token to communicate with the Vinkius gateway, which handles the API calls on your behalf.

Yes, Cascade chains actions like checking balances with `brex_get_balance` and executing payments via `brex_pay_vendor` autonomously. It displays the planned sequence in the chat panel, runs the tools, and reports the final status.

It does. You can ask Cascade to pull your historical transaction log using `brex_list_transactions` to cross-reference with local billing code.

Cascade catches the API error returned by the MCP server, analyzes the budget limit or permission error, and explains exactly what went wrong in your chat panel. You can then ask it to try a lower limit or a different budget.

Your sensitive corporate financial details, including card numbers and cash balances, stay safe because Vinkius runs the server in an isolated sandbox. Windsurf only receives the specific API responses needed to complete your prompt, and your credentials are never exposed.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript