create_financial_planLABSCO SUMMARY
The numbers come from arithmetic, not from the model.
That is the whole design: pure functions that return the same answer on every run, with the LLM used only to decide which ones to call. The hosted instance is shared and rate-limited and may cold-start after idle, so anything heavy or private belongs on your own machine.
What it is
A Python FastMCP server of deterministic calculators. The maths is pure functions; the model's only job is routing a plain-language question to the right tools. One codebase runs as a stdio server, a website and a hosted connector.
What you get
- The README's catalog counts 77 tools across 13 categories
- Time value of money (10) — future and present value, annuity, perpetuity, effective annual rate, real return
- Portfolio analytics (11) — CAPM, Sharpe, Sortino, Treynor, alpha, allocation, rebalancing
- Financial planning (9) and cash flow (3) — net worth, ratios, emergency fund, retirement, education, insurance, household cash flow, debt-to-income
- India small savings (9) — PPF, SSY, NSC, KVP, SCSS, RD, FD, EPF
- Mutual funds (7) and debt (6) — SIP, SWP, lumpsum against SIP, CAGR, expense-ratio impact, EMI, amortisation, prepayment, invest against prepay
- Fixed income (6), derivatives (5) and equity valuation (5) — bond price, YTM, duration, convexity, futures fair value, option payoff, Black-Scholes, put-call parity, DDM, DCF
- Live market data (4) with no API keys — mutual-fund search and NAV from AMFI, FX from ECB, equity and index quotes
- create_financial_plan, which chains the relevant calculators into one prioritised plan from a described situation
Requirements
Point a client at the hosted connector https://sarveshtalele-personal-finance-mcp.hf.space/mcp over HTTP with nothing to install. To run it yourself: pip install personal-finance-mcp and launch uvx personal-finance-mcp for stdio, or python -m src.web to serve the site, the connector and the JSON API on one port. Python 3.10 or newer.
Setup effort
One command — pip install personal-finance-mcp
USE CASES
01
Turning a described situation into a plan
Say your age, income and goal in plain words; the orchestrator picks the relevant calculators and returns one prioritised plan rather than a pile of numbers.
02
Deciding whether to prepay a loan or invest
The debt group compares the two directly — EMI, amortisation, prepayment impact and the invest-against-prepay calculation — instead of leaving you to reason about it.
03
Sizing a retirement gap
Planning and time-value tools work off the same inputs, so the required corpus and what a given SIP actually reaches are computed rather than estimated.
04
Checking a fund against live numbers
Mutual fund search and NAV come from AMFI, FX from the ECB and quotes without any API key, so the calculation uses current values.
77 tools
Listed in project docs. Your client may show a different list.
analyze_cash_flowcalculate_contingency_fundcalculate_debt_to_incomeanalyze_debt_consolidationcalculate_emicalculate_prepayment_savingscompare_loansinvest_or_prepay_loanloan_amortizationcalculate_black_scholescalculate_futures_hedgecalculate_futures_pricecalculate_option_payoffcalculate_put_call_paritycalculate_dividend_yieldvalue_stock_dcfvalue_stock_ddmvalue_stock_pevalue_stock_two_stage_ddmanalyze_budgetanalyze_financial_ratioscalculate_emergency_fundcalculate_insurance_needcalculate_net_worthfinancial_health_checkplan_educationplan_financial_goalplan_retirementcalculate_bond_convexitycalculate_bond_durationcalculate_bond_pricecalculate_current_yieldcalculate_ytmcalculate_zero_coupon_bondget_fx_rateget_mutual_fund_navget_stock_quotesearch_mutual_fundsanalyze_expense_ratio_impactcalculate_cagrcalculate_navcalculate_sip_neededcalculate_sip_returnscalculate_swpcompare_lumpsum_vs_sipanalyze_two_asset_portfoliocalculate_capm_returncalculate_information_ratiocalculate_jensens_alphacalculate_portfolio_returncalculate_portfolio_riskcalculate_sharpe_ratiocalculate_sortino_ratiocalculate_treynor_ratiorebalance_portfoliosuggest_asset_allocationassess_risk_profilecalculate_epfcalculate_fixed_depositcalculate_gratuitycalculate_kvpcalculate_nsccalculate_ppfcalculate_recurring_depositcalculate_scsscalculate_sukanya_samriddhicalculate_annuity_fvcalculate_annuity_pvcalculate_effective_ratecalculate_future_valuecalculate_inflation_impactcalculate_perpetuitycalculate_present_valuecalculate_real_returncalculate_rule_of_72calculate_savings_neededBEFORE YOU INSTALL
What to know first
Tools you get
77 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
INSTALLATION
Connect your client
Server setup
pip
TERMINAL
pip install personal-finance-mcpHosted endpoint
ENDPOINT URL
https://sarveshtalele-personal-finance-mcp.hf.space/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Desktop — remote
Settings → Connectors → Add custom connector
Paste https://sarveshtalele-personal-finance-mcp.hf.space/mcp as the connector URL
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http personal-finance https://sarveshtalele-personal-finance-mcp.hf.space/mcpCursor
CURSOR · JSON
{
"mcpServers": {
"personal-finance": {
"url": "https://sarveshtalele-personal-finance-mcp.hf.space/mcp"
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"personal-finance": {
"url": "https://sarveshtalele-personal-finance-mcp.hf.space/mcp",
"type": "http"
}
}
}Claude Desktop — stdio
CLAUDE DESKTOP — STDIO · JSON
{
"mcpServers": {
"personal-finance": {
"command": "uvx",
"args": [
"personal-finance-mcp"
]
}
}
}
