Uncommon Cash is Now Agent-Ready
Connect Claude Code, Cursor, or any MCP-compatible AI agent directly to your finances. Query transactions, manage budgets, and run financial workflows with natural language — your AI becomes a genuine financial partner.
What shipped
43 MCP Tools
Read transactions, manage budgets, split transactions, tag spending, create automation rules, and analyze patterns — all via the Model Context Protocol.
OAuth 2.1 + DCR
MCP clients auto-discover the auth server, register dynamically, and drive a full PKCE flow — no manual token creation required.
Discovery Files
llms.txt, robots.txt, /.well-known/oauth-authorization-server, and /.well-known/oauth-protected-resource — so AI systems know exactly how to authenticate and what they can do.
Stateless & Fast
No persistent sessions — every agent request is independent, fast, and secure. JWT access tokens scoped to the MCP resource.
Agent Readiness
Agent-ready apps need to be discoverable, accessible, and capable. Here's where we stand:
robots.txtllms.txt/.well-known/api-catalog.jsonMCP ServerOAuth 2.1 + DCR/.well-known/oauth-*Connect in 30 seconds
- 1
Add the MCP server
Run this in your terminal — no token needed:
claude mcp add --transport http uncommoncash \ https://uncommoncash.com/api/mcp
- 2
Authorize in your browser
Claude Code discovers the OAuth server automatically, opens a browser tab, and walks you through sign-in + consent. The whole flow takes about 20 seconds.
- 3
Ask your agent anything
Try: "Show me my top 5 spending categories this month and flag anything over budget."
Available tools
get_transactionsQuery transactions by date, category, or account
search_transactionsFull-text search across all transaction descriptions
get_uncategorized_transactionsList transactions that still need categorization
categorize_transactionUpdate a transaction's category
bulk_categorize_transactionsCategorize multiple transactions at once
create_transactionManually log a transaction
flip_transaction_signCorrect debit/credit direction on a transaction
update_transaction_descriptionRename a transaction description
split_transactionSplit a transaction across multiple categories
get_transaction_splitsView existing splits for a transaction
delete_transaction_splitsRemove splits and restore to a single transaction
get_budget_vs_actualCompare budget targets to actual spending
get_spending_summarySummarize spending by category for any period
update_budgetAdjust category budget targets
get_year_budgetsView annual budget allocations
add_budget_noteAnnotate a budget line with a note
compare_monthsSide-by-side comparison of two months of spending
get_categoriesList all categories in your hierarchy
create_categoryAdd a new category or sub-category
update_categoryRename or restructure a category
get_accountsList linked accounts and balances
get_net_worthTrack assets, liabilities, and net worth over time
get_automation_rulesList auto-categorization rules
create_automation_ruleCreate a pattern-matching categorization rule
update_automation_ruleModify an existing automation rule
delete_automation_ruleRemove an automation rule
suggest_automation_rulesAI-suggested rules based on uncategorized transactions
get_vendorsList known vendors
create_vendorAdd a new vendor
get_vendor_rulesList rules that map transactions to vendors
create_vendor_ruleCreate a transaction-to-vendor mapping rule
update_vendor_ruleModify a vendor mapping rule
delete_vendor_ruleRemove a vendor mapping rule
assign_vendor_to_transactionManually link a transaction to a vendor
bulk_assign_vendor_to_transactionsAssign a vendor to many transactions at once
apply_vendor_ruleRun a vendor rule against existing transactions
suggest_vendor_assignmentsAI-suggested vendor matches for unassigned transactions
get_tagsList all tags
create_tagCreate a new tag
get_tag_statsSpending breakdown by tag
add_transaction_to_tagApply a tag to a transaction
remove_transaction_from_tagRemove a tag from a transaction
analyze_spending_patternsSurface top vendors, trends, and over-budget categories
Ready to try it?
Sign up for Uncommon Cash and connect Claude Code to your finances in minutes.