Warm MCP for Windsurf

Query Warm financial data from Windsurf

Query your bank accounts, transactions, and subscriptions without leaving your IDE. Financial MCP tools for developers who live in Windsurf.

Install Warm MCP See pricing

Local @warmio/mcp package · Read-only tools · User-scoped API keys · Revoke anytime

MCP setup

Add to Windsurf.

Create this file in your project root.

  1. 1. Create an API key Get it from Settings → API Keys.
  2. 2. Run the installer Use npx -y @warmio/mcp@latest.
  3. 3. Reload the client Restart or reload so the Warm tools are discovered.
  4. 4. Verify with a prompt Ask: "Is my Warm connection working?"
Terminal shell 
npx -y @warmio/mcp@latest
Manual config

Use this only if you prefer editing the client config yourself.

.windsurf/mcp.json json 
{
  "mcpServers": {
    "warm": {
      "command": "npx",
      "args": ["-y", "@warmio/mcp@latest", "mcp"],
      "env": {
        "WARM_API_KEY": "your-api-key"
      }
    }
  }
}

Verify: ask the client to show your Warm accounts or test the Warm connection. It should call get_financial_context, get_transactions, or verify_key.

Tip: You can also add this to Windsurf's global settings for access across all projects.

Developer workflows.

Check your finances without context switching.

Quick Balance Check

"What's my checking account balance?"

Windsurf uses get_financial_context to read accounts from status.accounts while you code.

Spending Research

"How much did I spend on developer tools this quarter?"

Windsurf analyzes your transactions by category—great for expense reports or budget planning.

Subscription Audit

"List all my SaaS subscriptions"

Windsurf uses get_financial_context to query your recurring charges and subscription totals alongside the rest of your financial context.

MCP Tools included.

Windsurf automatically discovers and uses these tools.

get_financial_context

Read normalized financial context beyond individual transactions, including accounts at status.accounts

"Show my connected accounts and current balances"

get_transactions

Read transactions for month YYYY-MM or latest:true; bare calls use the fixed 10-day latest window

"Show my recent transactions"

verify_key

Check if your Warm API key is valid and working

"Test my Warm MCP connection"

Secure by design.

Your financial data stays protected.

Read-Only Access

The MCP server can only query data—never modify, delete, or transfer.

Scoped API Keys

Your key only accesses your accounts. Nothing else.

Instant Revocation

Delete your API key in Settings and access stops immediately.

Common questions

Everything you need to know about Windsurf and Warm.

How do I add Warm to Windsurf?

Create a .windsurf/mcp.json file in your project root with the MCP server config. Set the command to "npx", args to ["-y", "@warmio/mcp@latest", "mcp"], and add your WARM_API_KEY from Settings → API Keys. Windsurf should then discover the tools.

What financial data can Windsurf access?

Windsurf can access normalized financial context, including accounts at status.accounts, recurring charges, budgets, goals, and financial history, plus transactions for month YYYY-MM or the fixed 10-day latest window. Conversation history and app settings remain app-only.

Can Windsurf modify my financial data?

No. The MCP server is strictly read-only. Windsurf cannot modify, delete, or transfer any data. Your API key is user-scoped to your Warm account, not a set of granular permissions, and you can revoke it instantly from Settings.

Does this work with Windsurf Cascade?

Yes. The MCP tools work with both Windsurf chat and Cascade. You can ask financial questions while coding and get answers without switching context.

Ready to query finances
from Windsurf?

Your financial data, right where you code.

See pricing View Documentation

MCP and API access are included on both Warm plans. Plus includes up to 5 synced accounts. Pro includes up to 30 synced accounts.