Model Context Protocol

CapyCash MCP

Personal finance
Structured contextSecure OAuth accessRead and write workflows

Financial context, actions, and planning for CapyCash.

CapyCash MCP organizes lists, categories, transactions, scenarios, and financial signals into a consistent MCP app built for real budgeting and decision-making.

Tools

21

Finance operations exposed as structured MCP capabilities.

Visual surfaces

4

Lists, categories, transactions, and scenarios.

Interaction model

Read + Write

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

Access model

OAuth

User-scoped account access with explicit authorization.

Inside the app
The model sees a financial workspace instead of raw database records.

Workspace structure

Lists and categories define how money is organized.

Transaction history

Period views, summaries, and date-range access.

Scenario planning

Savings goals and adjustable plans.

Spending intelligence

Affordability, recurring charges, and simulated savings.

Import and export

Templates plus CSV-based transfer flows.

Designed to keep financial context useful, actionable, and user-scoped.

Core capabilities

A product landing, not a protocol dump.

CapyCash MCP should explain what the app can do in practice: organize money, inspect history, plan goals, and surface better decisions.

Workspace structure
Set up lists and categories that keep financial data organized before any analysis or action happens.
Create listsCreate categoriesConsistent account structure
Transaction operations
Review activity, summarize periods, and move data in or out when needed.
Period summariesCreate transactionsCSV import and export
Scenario planning
Create and adjust savings plans around concrete goals instead of generic advice.
Saved scenariosGoal updatesComparative planning
Financial signals
Turn historical spending into practical decisions and forward-looking analysis.
Affordability checksRecurring expense detectionSavings and time-to-earn simulations

Tool surface

The app can still show its tools, but grouped by workflow and explained in product terms instead of looking like an internal route index.

Lists and categories
These tools define the financial workspace before deeper analysis begins.

list_lists

Returns the financial lists available in the account.

read

create_list

Creates a new list to separate a budget, goal, or spending area.

write

list_categories

Retrieves income and expense categories for organization and reporting.

read

create_category

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

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

get_transactions

Reads transactions for a selected period.

read

create_transaction

Adds a new financial movement to the user 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 portability and analysis.

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 instead of static notes.

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 around a target and timeline.

write

update_scenario

Updates an existing scenario when the goal or plan changes.

write
Financial signals
These tools provide decision support on top of raw 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 spend.

read

get_time_to_earn

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

read

Designed as an MCP app

CapyCash MCP is shaped around protocol-native behavior rather than a visible list of routes and endpoints.

Structured operations
Plain-language actions map to stable financial capabilities instead of free-form API browsing.
Secure OAuth flow
Account access happens through explicit OAuth authorization and remains tied to the authenticated user.
Rich visual surfaces
Compatible clients can render dedicated views for lists, categories, transactions, and scenarios.
Included visual surfaces
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.