Connect Windsurf to Pink Agentic AI Payments

What you get

Windsurf asks Pink before it pays

Once connected, Windsurf can see its budget, the payees it may pay and the rules that apply, run a dry run, request a payment and file the receipt. The rules you set in Pink decide each request: allowed on the spot, sent to a person on the phone, or blocked. Windsurf never holds a card number or a bank login.

Step by step

1. 1

   Create a free sandbox workspace

   Open agentic-sandbox.pinkwallet.com, type a company name, pick a template (coffee shop, startup or e-commerce) and click Create workspace. You get an admin key for the console and one key per AI agent. Keep the admin key: the sign-in page asks for it.

   

2. 2

   Copy an agent key

   From the workspace page or the console.

   

3. 3

   Add the server

   Open Cascade's MCP settings (the hammer/plug icon → Configure) and add Pink with the URL https://agentic-sandbox.pinkwallet.com/mcp and the Authorization header, or edit ~/.codeium/windsurf/mcp_config.json directly.
4. 4

   Use it

   Refresh the server list, then describe the purchase to Cascade.
5. 5

   Watch the approval land in the console

   Open the sandbox console (link on the workspace page). Requests that cleared, asked a person or were blocked are all listed with the rule that decided them. Approve the pending one and the agent continues.

   

The configuration, ready to paste

// ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "pink": {
    "serverUrl": "https://agentic-sandbox.pinkwallet.com/mcp",
    "headers": { "Authorization": "Bearer <agent_key>" }
} } }

Replace <agent_key> with the key of the agent this ide should act as. Each agent has its own key, budget and rules.

Try it: say this to Windsurf

Pink's side, in three screens

FAQ

Official documentation

• Windsurf: MCP ↗
• Pink: the seven MCP tools, with real responses
• Pink: security model (what the client can and cannot reach)

Menu names and settings paths follow each vendor's documentation at the verified date. If a vendor moves a menu, the linked page is the source of truth; the Pink side does not change.

Other clients