# Finance Toolkit

> Finance Toolkit is an open-source MCP server for finance and payments. Query 500+ financial ratios and statements computed transparently from raw data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/jerbouma/financetoolkit
- **MCP Registry name:** io.github.JerBouma/financetoolkit
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

The idea behind it is that the same metric can differ between websites because each uses its own formula, and the formulas are often hidden. The author's example is Microsoft's price-to-earnings ratio on one day, reported anywhere from 28.93 to 34.4 by eight sources. Here every method is written in plain open source Python so the calculation can be inspected.

Statements are fetched from Financial Modeling Prep, which needs an API key; its free plan is described as limited to 250 requests a day, 5 years of data and US-listed companies. If that fails the toolkit falls back to Yahoo Finance, unless you force a source. A FRED key is optional for some US economic indicators. Coverage goes beyond equities to options, currencies, crypto, ETFs, funds, indices, commodities and economic indicators, with risk measures such as Sharpe ratio and value at risk.

You can use the hosted endpoint with OAuth, or run it locally through a setup command that writes your client config. A Claude Desktop bundle is also offered.

## Features

- **500+ methods:** Ratios, models and statistics written in readable code.
- **Statement-based:** Calculations start from raw financial statements.
- **Multi-asset coverage:** Equities, options, ETFs, crypto, indices and macro data.
- **Risk measures:** Sharpe ratio and value at risk among them.
- **Source fallback:** Switches to Yahoo Finance if the primary source fails.
- **Hosted or local:** Remote endpoint with OAuth, or a local setup command.

## Good for

- Compare valuation ratios across competitors using one consistent formula
- Analyse a sector from statements down to risk and return
- Check how a fund fits a diversified portfolio
- Pull economic indicators next to company financials

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http financetoolkit https://financetoolkit.jeroenbouma.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://financetoolkit.jeroenbouma.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "financetoolkit": {
      "url": "https://financetoolkit.jeroenbouma.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "financetoolkit": {
      "type": "http",
      "url": "https://financetoolkit.jeroenbouma.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "financetoolkit": {
      "serverUrl": "https://financetoolkit.jeroenbouma.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "financetoolkit": {
      "type": "http",
      "url": "https://financetoolkit.jeroenbouma.com/mcp"
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes, a Financial Modeling Prep key; a FRED key is optional for some US indicators.

### Is there a free data tier?

The README says Financial Modeling Prep's free plan allows 250 requests a day, 5 years of data and US-listed companies.

### What happens if the main source fails?

It switches to Yahoo Finance unless enforce_source is set to force one source.

### How do I connect it?

Use the hosted URL https://financetoolkit.jeroenbouma.com/mcp or run the local uvx setup command.

### Is Finance Toolkit free?

Yes. Finance Toolkit is open source, so you can use and self-host it for free.

### How do I add Finance Toolkit to Claude Code?

Run this command in your terminal: claude mcp add --transport http financetoolkit https://financetoolkit.jeroenbouma.com/mcp

### What are the best alternatives to Finance Toolkit?

The closest alternatives to Finance Toolkit are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/finance-toolkit
