Warm MCP

AI transaction search for your real Warm data

Search spending with plain English. Ask your AI client to find merchants, categories, date ranges, and unusual charges using your real transaction history.

Local package over stdio · Read-only tools · No hosted remote MCP endpoint

get_transactions read-only

Natural-language ask

"Show dining charges over $50 this month"

limit · cursor · last_knowledge

Cursor pages transaction history; last_knowledge handles incremental sync.

New to Warm MCP?

Start with the agent workflow narrative — it shows what your AI tools can actually do with Warm context.

See agent workflows →

MCP setup

Install with one command.

Run one command to connect supported MCP clients, then create an API key that is scoped to your Warm data.

Terminal shell
npx @warmio/mcp

Requires an API key from Settings → API Keys.

Search transactions by intent.

Warm MCP gives the model read-only transaction context; your client handles filtering, summaries, and follow-up questions.

Search by intent

Ask "Show my coffee spend this month" instead of manually filtering UI controls.

Powered by get_transactions

Uses limit, cursor, and last_knowledge for strict cursor-paginated transaction queries.

Works across MCP clients

Use Claude Code, Cursor, Windsurf, Claude Desktop, OpenCode, Codex CLI, Antigravity, or Gemini CLI.

Read-only security.

Read-only

Scoped to your data

Revocable anytime

FAQ

What is AI transaction search?

AI transaction search lets you ask natural-language questions about your transactions. Warm uses MCP to give your AI client read-only access to transactions, then the model handles filtering and summaries.

What MCP tool powers this page?

Transaction search uses the get_transactions tool. It supports strict cursor pagination with limit, cursor, and last_knowledge for incremental sync.

Can I search by merchant, amount, and date range?

Yes. You can ask queries like "Show Amazon purchases over $100 since January" or "What did I spend on dining in the last 30 days?" and the AI will apply the needed filters.

Does this include write access?

No. MCP access is read-only. Your AI client cannot edit, delete, or create transactions.

Which plan includes AI transaction search?

AI transaction search via MCP is available on paid Warm plans. Pro supports up to 30 synced accounts.