PlugWiki
Finance Toolkit logo

Finance Toolkit MCP Server: Setup for Claude, Cursor and Other Apps

CommunityRemoteLocal
Gethttps://financetoolkit.jeroenbouma.com/mcpjerbouma/financetoolkit

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.

Install Finance Toolkit MCP

Claude Code

  1. 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. 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 · efficiency

  • Liquidity 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 · liquidity

  • Profitability ratios

    Returns gross, operating and net margin, ROE, ROA, ROIC and ROCE.

    Try: “What is Nvidia's return on equity by year?”

    Network · profitability

  • Debt 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 · solvency

  • Valuation 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 · valuation

  • Market 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 · breadth

  • Momentum 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 · momentum

  • Moving 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 · overlap

  • Volatility indicators

    Returns Bollinger Bands, Keltner and Donchian channels, Average True Range and Supertrend.

    Try: “Show Bollinger Bands for AAPL over the last year.”

    Network · volatility

  • Valuation 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 · models

  • Risk-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 · performance

  • Risk 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 · risk

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

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-onlyEvery tool only reads and calculates, so there is nothing to switch off.
Talks toFinancial Modeling Prep and other data sources the toolkit calls. The author's hosted server, if you use the hosted route
Sign-in and keysLocal: 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
  • Financial Modeling Prep API key (your own plan limits apply)

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

WebsiteGitHubPyPIOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. pypi.org · pypi.org

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.