Model Context Protocol

CapyCash MCP

Personal finance
Structured finance contextSecure OAuth accessRead and write workflows

CapyCash financial data, ready to use.

CapyCash MCP brings lists, categories, transactions, and scenarios into one reliable workspace for reviewing activity, updating records, and planning ahead.

Tools

21

Focused operations for day-to-day financial tasks.

Visual surfaces

4

Lists, categories, transactions, and scenarios.

Interaction model

Read + Write

Review, creation, updates, and imports in one workspace.

Access model

OAuth

User-scoped access with explicit authorization.

What the model sees
Instead of loose records, the model gets an organized financial workspace.

Account structure

Lists and categories define how money is grouped and understood.

Transaction history

Activity by period, summaries, and date-range lookups.

Savings scenarios

Concrete goals with plans that can be adjusted over time.

Spending signals

Affordability checks, recurring charges, and savings simulations.

Import and export

CSV-based flows for moving data in and out cleanly.

Clear structure first. Analysis and action on top of it.

Core capabilities

Built for everyday finance work.

The point is not to expose raw protocol detail. It is to make CapyCash data useful inside MCP for real decisions and routine work.

Workspace structure
Set up lists and categories so the financial workspace stays consistent from the start.
Create listsCreate categoriesOrganize the account
Transactions
Review activity, summarize periods, and move data in or out when needed.
Period summariesCreate transactionsImport and export CSV
Scenarios
Create and adjust savings plans around concrete goals.
Saved scenariosUpdate goalsCompare plans
Financial signals
Turn spending history into useful signals for better decisions.
Evaluate a purchaseDetect recurring expensesSimulate savings and work time

Available tools

Tools are grouped by job and described in product terms, so the page stays useful to people as well as compatible clients.

Lists and categories
These tools define the account structure before deeper analysis begins.

list_lists

Returns the financial lists available in the account.

read

create_list

Creates a new list for a budget, goal, or spending area.

write

list_categories

Retrieves income and expense categories for organization and review.

read

create_category

Adds a new category so future transactions and budgets stay organized.

write
Transactions and imports
These tools cover history, summaries, manual entry, and data movement.

get_transactions

Reads transactions for a selected period.

read

create_transaction

Adds a new financial entry to the account.

write

get_transaction_summary

Builds a compact income, expense, and balance summary.

read

get_transactions_by_range

Looks up transaction history across a custom date range.

read

export_transactions

Exports transactions as CSV for analysis or backup.

read

get_import_template

Returns the expected structure for bulk imports.

read

import_transactions

Imports up to 100 transactions in one operation.

write
Scenarios
These tools turn savings goals into editable plans.

list_scenarios

Lists the scenarios already saved for the account.

read

get_scenario

Fetches a specific scenario by name or identifier.

read

create_scenario

Creates a new savings scenario with a target and timeline.

write

update_scenario

Updates an existing scenario when the goal or plan changes.

write
Financial signals
These tools add decision support on top of transaction history.

get_financial_score

Calculates an overall financial health score.

read

can_i_afford

Evaluates whether a purchase fits the current financial position.

read

get_spending_insights

Highlights anomalies, alerts, and spending trends.

read

get_recurring_expenses

Detects repeated expenses and subscription-like patterns.

read

simulate_savings

Projects savings by reducing or eliminating a recurring expense.

read

get_time_to_earn

Translates spending into the work time required to earn it back.

read

Designed for MCP

CapyCash MCP is organized around stable financial actions, authenticated access, and dedicated views where clients support them.

Structured operations
Plain-language actions map to stable financial capabilities.
Secure OAuth flow
Account access happens through explicit OAuth authorization and remains tied to the authenticated user.
Dedicated views
Compatible clients can render focused views for lists, categories, transactions, and scenarios.
Included views
When a client supports richer rendering, CapyCash MCP can present focused views for the main parts of the workspace.

Lists

Overview of financial spaces and how data is grouped.

Categories

Income and expense classification with budgeting context.

Transactions

History, summaries, and filtered views across time ranges.

Scenarios

Savings plans, targets, and progress-oriented comparisons.