FinanceToolkit is an open-source Python library for transparent and efficient financial analysis, built for analysts, quants, and developers who need to compute financial statements, fundamentals, and performance metrics from market data under their own control.
What it is
FinanceToolkit is a Python project published under the MIT licence and maintained in the Python data and financial-analysis ecosystem. Its stated purpose is transparent and efficient financial analysis, and its topic list covers equities, financial statements, fundamentals, fundamental analysis, financial data, market data, factor analysis, performance analysis, and algorithmic trading. The project also ships an MCP server, which places it in the tooling ecosystem for Model Context Protocol clients rather than in the ecosystem of closed desktop analytics suites.
The concrete problem it addresses is that financial analysis work is normally done inside opaque, licence-gated platforms where the calculation pipeline cannot be inspected or reused. FinanceToolkit offers the same categories of work — statements, fundamentals, factors, performance — as inspectable Python code. The provided facts do not name a specific product that it replaces, so the substitution is best understood at the level of the closed financial-analysis stack rather than any single named vendor. The MIT licence means the calculation logic can be read, extended, and redistributed.
Key capabilities
- Financial statement and fundamental analysis over company fundamentals and reported statements.
- Factor analysis and performance analysis for equity portfolios and strategies.
- Market data and equity data handling within a single Python library.
- Support for algorithmic-trading workflows, indicated by the algorithmic-trading topic.
- An MCP server so the library's analytics can be exposed to Model Context Protocol clients.
- A distributable MCP bundle published as
financetoolkit.mcpb on the GitHub releases page.
- Directory listings on Smithery and Glama for MCP server discovery.
Who uses it and how
- Quantitative analysts running factor analysis and performance analysis across equity portfolios in Python.
- Fundamental analysts pulling financial statements and fundamentals into repeatable, versioned scripts.
- Algorithmic traders who need market data and equity analytics in the same runtime as their signal code.
- Developers using MCP-compatible clients who install the
financetoolkit.mcpb bundle and reach the library's analytics through the MCP server.
- Teams that must show their calculation path, since MIT-licensed source can be audited and forked.
Getting started
The README surfaces an MCP server with a downloadable bundle, financetoolkit.mcpb, from the latest GitHub release, alongside listings on Smithery and Glama. The provided README excerpt does not spell out a PyPI package name, Docker image, or compose file, so those install paths cannot be quoted here.
How it compares
No paid products and no comparable open-source tools are named in the provided facts, so no like-for-like contrast can be drawn on licence, hosting, data ownership, or cost model. On the evidence given, FinanceToolkit stands alone in this registry. Its distinguishing facts are the MIT licence, the Python implementation, and the MCP server with a published bundle.
When to use it — and when not to
Choose it when the work is Python-native financial analysis and the MCP integration is useful, since the licence is clear, the project is actively pushed, and the open-issue count is low. Do not choose it if you need a turnkey hosted product with a commercial support contract, because the facts describe a library and an MCP server, not a managed service with a service-level agreement. Be aware that the provided README excerpt is thin on installation and runtime setup, and that the project is maintained under a single author's personal domain with sponsorship and coffee-donation links, which is a concentration risk for long-lived production dependencies.
project readme (upstream, from github) — read inline


While browsing a variety of websites, I repeatedly observed significant fluctuations in the same financial metric among different sources. Similarly, the reported financial statements often didn't line up, and there was limited information on the methodology used to calculate each metric.
For example, Microsoft's Price-to-Earnings (PE) ratio on the 6th of May, 2023 is reported to be 28.93 (Stockopedia), 32.05 (Morningstar), 32.66 (Macrotrends), 33.09 (Finance Charts), 33.66 (Y Charts), 33.67 (Wall Street Journal), 33.80 (Yahoo Finance) and 34.4 (Companies Market Cap). All of these calculations are correct, however the method of calculation varies leading to different results. Therefore, collecting data from multiple sources can lead to wrong interpretation of the results given that one source could apply a different definition than another. And that is, if that definition is even available as often the underlying methods are hidden behind a paid subscription.
This is why I designed the FinanceToolkit, this is an open-source toolkit in which all relevant financial methods (500+) are written down in the most simplistic way allowing for complete transparency of the method of calculation (proof). This enables you to avoid dependence on metrics from other providers that do not provide their methods. With a large selection of financial statements in hand, it facilitates streamlined calculations, promoting the adoption of a consistent and universally understood methods and formulas.
Beyond Equities, it supports Options, Currencies, Cryptocurrencies, ETFs, Mutual Funds, Indices, Money Markets, Commodities, Key Economic Indicators and more, allowing you to obtain historical data as well as important performance and risk measurements such as the Sharpe Ratio and Value at Risk.
Complementing this is the Finance Database 🌎, a database featuring 300.000+ symbols containing Equities, ETFs, Funds, Indices, Currencies, Cryptocurrencies and Money Markets. By utilising both, it is possible to do a fully-fledged competitive analysis with the tickers found from the FinanceDatabase inputted into the FinanceToolkit.
🔌 The Finance Toolkit is also available as an MCP Server
Query 500+ methods from Claude, Copilot, Cursor, Windsurf or any MCP-compatible client without writing code.
- Hosted: connect to
https://financetoolkit.jeroenbouma.com/mcp — OAuth handles the rest on first use.
- Local:
uvx --from "financetoolkit[mcp]" financetoolkit-mcp-setup — sets up your client config and API key automatically. See MCP Server Documentation for manual setup.
Also on Smithery, Glama, MCP Servers and more.
Table of Contents
- Installation
- Functionality
- MCP Server
- Questions & Answers
- Contributing
- Mentions
- Contact
Installation
Before installation, consider starring the project on GitHub which helps others find the project as well.
<img alt="ima