Personal Finance MCP Server: A Deterministic Financial Toolkit

Research context and background

The Personal Finance MCP Server is a specialized tool designed to work directly with the Claude ecosystem, including Claude Desktop, Claude Code, Cursor, and VS Code. It acts as a reliable personal finance assistant that uses pure mathematical formulas to provide accurate financial calculations. Unlike other finance tools that might guess at numbers, this system ensures that the same inputs always produce the same answer. Users can describe their financial situation in plain language, such as stating their age, income, and retirement goals, and the tool automatically generates a prioritized financial plan. The server is available as an MCP Server, a website, or a hosted connector accessible via a single URL.

Benefits

The tool offers several key advantages for users managing their finances. It provides 77 calculators organized into 13 categories, covering everything from time value of money and portfolio analytics to debt management and mutual fund calculations. The system is built on established financial mathematics, ensuring that all advice is grounded in theory rather than guesswork. It includes live market data for mutual funds, foreign exchange rates, and stock quotes without requiring users to set up API keys. Security is a top priority, with the server being stateless, rate-limited, and protected against common attacks. The interface allows users to interact with complex financial concepts using simple language, making it accessible to both technical and non-technical individuals.

Use Cases

This tool is useful for a wide range of financial planning scenarios. It can help users calculate retirement savings needs, plan for education expenses, or manage debt through amortization and prepayment strategies. The portfolio analytics features allow users to understand metrics like the Sharpe ratio, alpha, and asset allocation. For those interested in Indian savings schemes, the tool provides calculators for PPF, SSY, NSC, and other government-backed instruments. Mutual fund investors can use the SIP and SWP calculators to understand returns and expense ratios. The risk profiling feature suggests an appropriate split between equity and debt investments based on a user's suitability score. Additionally, the live market data feature helps users track mutual fund NAVs, foreign exchange rates, and stock prices in real time.

Pricing

The tool is available as an open-source project, and contributions are welcome. The hosted connector is accessible via a free URL on Hugging Face. Local installation is possible through PyPI, and development can be done locally by cloning the GitHub repository. There are no mentioned subscription fees or paid tiers for the core functionality.

Vibes

The tool is designed to be an educational resource for illustrating standard financial formulas. It is not intended to provide investment advice, and users are encouraged to verify calculations before making financial decisions. The open-source nature of the project invites community contributions, including improvements to tool descriptions, web UI extensions, and new calculator implementations. The emphasis on deterministic calculations and security suggests a focus on reliability and trustworthiness.

Additional Information

The project is hosted on GitHub and deployed as a Hugging Face Docker Space, which auto-syncs from the main branch on every push. The codebase includes 119 tests to ensure reliability and uses linting tools to maintain code quality. The architecture separates deterministic pure functions from the MCP tool wrappers, ensuring that the same logic powers the server, web calculators, and tests. The project is licensed under an open-source license that welcomes contributions.