Cursor - 0 Finance Docs

Prerequisites

Cursor installed
0 Finance API key from Settings → API Keys

Step 1: Create the config file

Create or edit ~/.cursor/mcp.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 Cursor

Quit and reopen Cursor to load the new MCP server.

Step 3: Verify

In a new chat, ask Cursor to check your balance:

Check my 0 Finance balance

Cursor should call get_balance and show your USDC balance.

Add the starter prompt

For best results, add this to your Cursor rules (.cursorrules or project settings):

When using 0 Finance tools:
- Always call get_balance before proposing transfers
- Never claim funds have moved—transfers require dashboard approval
- Confirm amounts and recipients before creating proposals

Available tools

Once connected, Cursor has access to these 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 ~/.cursor/mcp.json exists and is valid JSON
Verify npx is available in your PATH
Restart Cursor

”Authentication failed”

Verify your API key is correct
Check the key hasn’t expired in Settings → API Keys
Ensure there are no extra spaces in the key

”Tool call failed”

Check the Cursor output panel for error messages. Common issues:

Rate limiting (wait and retry)
Invalid parameters (check the tool documentation)
Network issues (verify internet connection)

​Prerequisites

​Step 1: Create the config file

​Step 2: Restart Cursor

​Step 3: Verify

​Add the starter prompt

​Available tools

​Troubleshooting

​”MCP server not found”

​”Authentication failed”

​”Tool call failed”