MCP Tools Reference¶

FinPlan exposes its financial engine as MCP (Model Context Protocol) tools. These are the functions your AI assistant calls on your behalf when you ask financial planning questions.

This reference documents every available tool, organized by category.

Conventions

Money values are in cents (integers). 100000 = $1,000.00. Responses include both _cents and _dollars fields.
Rates and returns are decimals. 0.07 = 7%.
Allocations use 0.0-1.0 for rates, 0-100 for percentages.
Dates use YYYY-MM-DD format.

Tool Categories¶

Profile & State ¶

Create and update operations. 1 tools

Accounts ¶

Account types, allocations, ownership, and creation. 3 tools

Employer Match ¶

Match formulas, vesting, and calculations. 3 tools

Tax ¶

Federal income tax, capital gains, and after-tax projections. 3 tools

Projections ¶

Unified projection interface and scenario comparison. 2 tools

Portfolio ¶

Presets, characteristics, and glide paths. 3 tools

Goals ¶

Create, track, and project financial goals. 4 tools

Benefit estimation, claiming strategies, and SSA limits. 8 tools

Mortgage ¶

Payments, amortization, and principal/interest splits. 2 tools

Required Minimum Distributions ¶

Required Minimum Distribution (RMD) tools for retirement planning. 5 tools

Charts ¶

Chart.js chart data for client-side rendering. 4 tools

File Management ¶

File Management. 0 tools

Tool Search ¶

Dynamic tool search meta-tool for FinPlan MCP server. 1 tools