
Finance Toolkit MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants answer finance questions with ratios, prices, risk, options and economic data calculated from company statements.
This is the MCP server of the open-source Finance Toolkit, made by Jeroen Bouma. It gives your assistant over 500 finance methods, grouped into 27 tools. Financial statements, prices and ratios are calculated from raw data, with the formulas open to read. You need a Financial Modeling Prep API key, because that service supplies the data.
You can connect to the hosted server or run it on your computer. The hosted route asks for your Financial Modeling Prep key on a sign-in page, so the author's server then holds your key. The local route keeps the key on your machine. The tools give data and calculations, not financial advice.
Good for
- Investors and analysts who want ratios and valuation models in plain-English questions
- Students who want to see how a figure is calculated
- Developers who already use the Finance Toolkit library in Python
- Researchers who need macro and rates data next to company data
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install Finance Toolkit MCP
Claude Code
- 1
Copy this prompt.
Add the Finance Toolkit MCP server to Claude Code. Run this command: claude mcp add --transport http finance-toolkit https://financetoolkit.jeroenbouma.com/mcp Ask me for FINANCIAL_MODELING_PREP_API_KEY and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires API key.
Read-only mode: Every tool only reads data, so there is no read-only switch to set.
Hosted: you sign in on a page that asks for your Financial Modeling Prep key, and the author's server then holds it. The author lists hosted steps only for Claude Desktop, Claude.ai, Claude Code, VS Code, Cursor and Windsurf, so the hosted setup for other apps is not documented by the author. Local: the command needs Python's uv tool and a Financial Modeling Prep API key. The plain financetoolkit package does not include the server, so the command asks for the mcp extra. The author also offers a setup command that writes your app's config for you, and a Claude Desktop bundle.
From the project README. Source.
Tools
Efficiency ratios for a company
Returns ratios such as asset turnover, inventory turnover, days sales outstanding and cash conversion cycle for the tickers you name.
Try: “Show Apple's cash conversion cycle for the last 5 years.”
Network ·
efficiencyLiquidity ratios
Returns the current ratio, quick ratio, cash ratio and working capital for the tickers you name.
Try: “Compare the current ratio of MSFT and GOOGL.”
Network ·
liquidityProfitability ratios
Returns gross, operating and net margin, ROE, ROA, ROIC and ROCE.
Try: “What is Nvidia's return on equity by year?”
Network ·
profitabilityDebt and solvency ratios
Returns debt-to-equity, interest coverage, debt-to-assets and net debt to EBITDA.
Try: “How leveraged is Tesla compared with Ford?”
Network ·
solvencyValuation ratios
Returns P/E, EPS, EV/EBITDA, P/B, P/S, PEG, dividend yield, free cash flow yield and market cap, including forward P/E.
Try: “Give me the P/E and EV/EBITDA for AAPL.”
Network ·
valuationMarket breadth indicators
Returns indicators such as the McClellan Oscillator, advance/decline line and TRIN, calculated on prices it fetches for you.
Try: “Show the advance/decline line for these 10 tickers.”
Network ·
breadthMomentum indicators
Returns RSI, MACD, Stochastic, Aroon, ADX, Ichimoku and similar indicators on price data it fetches for you.
Try: “What is Amazon's RSI today?”
Network ·
momentumMoving averages and price overlays
Returns moving averages, VWAP, Parabolic SAR, pivot points and Fibonacci levels drawn over the price.
Try: “Give me the 50 and 200 day moving averages for SPY.”
Network ·
overlapVolatility indicators
Returns Bollinger Bands, Keltner and Donchian channels, Average True Range and Supertrend.
Try: “Show Bollinger Bands for AAPL over the last year.”
Network ·
volatilityValuation and scoring models
Returns models such as WACC, DuPont analysis, DCF intrinsic value, Altman Z-Score, Piotroski F-Score and Beneish M-Score.
Try: “Run an Altman Z-Score and Piotroski F-Score on Intel.”
Network ·
modelsRisk-adjusted performance metrics
Returns Sharpe, Sortino, Alpha, Beta, Treynor and Information Ratio for the tickers you name.
Try: “What is the Sharpe ratio of AAPL against SPY?”
Network ·
performanceRisk metrics
Returns value at risk, CVaR, GARCH volatility, max drawdown and drawdown recovery time.
Try: “What was Tesla's worst drawdown in the last 3 years?”
Network ·
riskStatistical tests on price series
Runs tests such as unit root, cointegration, Granger causality and VAR forecasts on price or return series.
Try: “Test whether KO and PEP are cointegrated.”
Network ·
econometricsETF and fund analysis
Returns analysis of ETFs and other funds, such as their holdings.
Try: “What are the top holdings of QQQ?”
Network ·
etfPortfolio construction and analysis
Works out optimal weights for two or more tickers, such as minimum variance, maximum Sharpe and risk parity.
Try: “Find the minimum variance mix of AAPL, MSFT and JNJ.”
Network ·
portfolioOption pricing and Greeks
Prices options with Black-Scholes or a binomial tree and returns delta, gamma, theta, vega, rho and implied volatility.
Try: “Price a 3 month call on AAPL at strike 200 and show the Greeks.”
Network ·
optionsGovernment fiscal data by country
Returns debt, deficit, spending, revenue and tax revenue for the countries you name.
Try: “Compare US and German government debt over time.”
Network ·
governmentMacroeconomic indicators by country
Returns GDP, CPI, inflation, trade balance, confidence, house prices and exchange rates by country.
Try: “Show US inflation and GDP growth since 2015.”
Network ·
macroeconomicsESG and environmental data
Returns ESG scores by ticker, and carbon footprint and renewable energy data by country.
Try: “What are Microsoft's ESG scores?”
Network ·
environmentLabour and social data by country
Returns unemployment, labour productivity, population, poverty rate and income inequality for countries.
Try: “Compare unemployment in Spain and Germany.”
Network ·
jobsInterest rates and yields
Returns central bank rates, government bond yields, the US Treasury yield curve and curve slope.
Try: “Show the US Treasury yield curve slope this year.”
Network ·
ratesBond and derivative valuation
Calculates bond duration, present value, yield to maturity, forward rates and similar figures.
Try: “Calculate the duration of a 10 year 4% bond.”
Network ·
fixed_incomeFind and screen the market
Lists stocks, ETFs, currencies and crypto, runs a stock screener, and returns top gainers, losers, most active stocks, sector performance and the earnings and IPO calendars.
Try: “Who were the biggest gainers on the market today?”
Network ·
discoveryRaw prices and financial statements
Returns historical prices, income statements, balance sheets, cash flow statements, company profiles, quotes and analyst estimates.
Try: “Show Apple's income statement for the last 4 years.”
Network ·
market_dataList the metric categories
Lists the metric categories with how many tools each has and what they cover.
Try: “What kinds of financial metrics can you calculate?”
Read ·
search_metric_categoriesList the metrics in a category
Lists every metric inside one category by name.
Try: “What metrics are in the risk category?”
Read ·
search_by_categorySearch all methods by keyword
Does a fuzzy keyword search across the 500+ methods behind the tools.
Try: “Find a metric for 'debt coverage'.”
Read ·
search_metrics
Read from the source code
Permissions
low risk · 3 things to watch
Low risk
The assistant can only read market and company data and run calculations on it. It cannot place trades or change any account, and its output is data, not advice.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
The hosted route stores your data key
On the hosted server you hand your Financial Modeling Prep key to the author's service. Run it locally if you do not want that. github.com
It uses your plan's request quota
Broad questions can trigger many data calls against your Financial Modeling Prep plan. Watch your usage on the free plan. github.com
It saves fetched data in a local cache
The toolkit keeps downloaded data in a local SQLite database in your user config folder. Set FINANCE_TOOLKIT_CACHE_ENABLED to 0 to switch that off. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Every tool only reads and calculates, so there is nothing to switch off. |
|---|---|
| Talks to | Financial Modeling Prep and other data sources the toolkit calls. The author's hosted server, if you use the hosted route |
| Sign-in and keys | Local: the key sits in the FINANCIAL_MODELING_PREP_API_KEY setting of your assistant's config. Hosted: you enter it on a sign-in page and the server keeps it. |
| Scopes |
|
Questions
Do I need an API key?
Yes. Both the hosted and the local server need a Financial Modeling Prep API key. The hosted server asks for it on a sign-in page the first time you connect.
Is Finance Toolkit free?
The software is free and open source under the MIT license. The data comes from Financial Modeling Prep, which has its own plans and limits.
Should I use the hosted or the local server?
Use local if you want the key to stay on your machine. Use hosted if you want nothing to install. The hosted route stores your key on the author's server.
Can it place trades?
No. All tools only read data and calculate figures. There is no trading or account access.
Is it official?
It is the project's own server, made by the author of the Finance Toolkit. It is not made by Financial Modeling Prep, the data provider.
Is the data live?
It fetches current data from its sources and caches it locally. The README says prices and financial statements are refreshed after a day, and quotes after a minute.
What is the Finance Toolkit MCP server URL?
The hosted address is https://financetoolkit.jeroenbouma.com/mcp. Your app opens a sign-in page that asks for your Financial Modeling Prep key.
How do I add it to Claude Desktop?
Use the install box above. Add the hosted address as a custom connector, or use the local config. Restart the app afterwards.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
financetoolkit- Registry
- PyPI
- Endpoint
https://financetoolkit.jeroenbouma.com/mcp- Transport
- stdio, Streamable HTTP
- Auth
- API key
- Version
- 2.1.2
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 1
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- pypi.org · pypi.org