Windsurf - 0 Finance Docs

Prerequisites

Windsurf installed
0 Finance API key from Settings → API Keys

Step 1: Create the config file

Create or edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "zero-finance": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://0.finance/api/mcp"],
      "env": {
        "API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

Step 2: Restart Windsurf

Quit and reopen Windsurf to load the new MCP server.

Step 3: Verify

In Cascade, ask Windsurf to check your balance:

Check my 0 Finance balance

Windsurf should call get_balance and display your USDC balance.

Available tools

Once connected, Windsurf has access to all 0 Finance tools:

Tool	Description
`get_balance`	Get spendable USDC balance
`list_saved_bank_accounts`	List saved bank accounts
`propose_bank_transfer`	Propose an outbound transfer
`create_invoice`	Create a new invoice
`send_invoice`	Send invoice to recipient
`list_invoices`	List invoices
`get_payment_details`	Get IBAN/ACH receiving details
`share_payment_details`	Email payment details

See the full tool list for all available tools.

Troubleshooting

”MCP server not found”

Check that ~/.codeium/windsurf/mcp_config.json exists
Verify the JSON is valid
Restart Windsurf

”Authentication error”

Verify your API key in the config
Check the key is active in Settings → API Keys

Cascade not finding tools

Make sure you’re using Cascade (the AI assistant)
Try explicitly asking “Use the 0 Finance tools to check my balance”
Restart Windsurf if tools aren’t appearing

​Prerequisites

​Step 1: Create the config file

​Step 2: Restart Windsurf

​Step 3: Verify

​Available tools

​Troubleshooting

​”MCP server not found”

​”Authentication error”

​Cascade not finding tools