Financial Modeling Prep (fmpsdk) MCP server

FMP SDK

The idea behind this project is to provide a 'one-stop-shop' to the API endpoints provided by Financial Modeling Prep (FMP).

A personal note to you: my apologies for letting this package get so out of date. FMP kept reshuffling its API, then I had a personal issue delay me further. Things are back on track now. Because of that gap, roughly half of this package's old methods had gone defunct against FMP's current API, so rather than patch around that I rebuilt it from scratch against FMP's stable/ API. If you're on 20250102.0 or earlier you're on the old, pre-rewrite methods; anything newer uses the schema described below. Old releases are yanked from PyPI (a plain pip install fmpsdk now always gets the rewrite), but still installable if you pin one explicitly, e.g. pip install fmpsdk==20250102.0 — note that won't actually restore functionality, though: FMP sunset the legacy /api/v3/ API those old methods called entirely on 2025-08-31, so a pinned old version installs fine but its calls will fail regardless. It's there for compatibility with existing pinned requirements files while you migrate, not as a way to keep avoiding the rewrite.

What's covered

29 data groups, ~240 methods total, each reachable both as client.(...) and grouped under a matching namespace, e.g. client.statements.income_statement(...):

ratios/growth (income, balance sheet, cash flow — as-reported, TTM, and growth variants)

• Company & fundamentals — profile, executives, M&A, DCF valuation, financial statements/

industry/exchange directories

• Market data — real-time & aftermarket quotes, historical price charts, technical indicators
• Reference & screening — symbol/CIK/CUSIP/ISIN search, the company screener, sector/

disclosures

• Calendars & events — earnings, dividends, splits, IPOs, the economic calendar
• Ownership & compliance — insider trades, Form 13F institutional ownership, SEC filings, ESG

trading, market movers

• Alternative markets — crypto, forex, commodities, indexes, ETFs & mutual funds
• Sentiment & analysis — analyst grades/price targets, TipRanks ratings, congressional

• Bulk downloads — whole-universe data dumps, one call instead of one per symbol

Every method's own docstring says which FMP plan tier it needs (Free/Starter/Premium/ Ultimate) — see Pricing tiers below. One exception: the 7 client.tipranks methods are implemented and unit-tested but untested against a real response — see that section for why.

How to Use

is optional — it's just how the example below loads your API key from a .env file).

1. Requires Python 3.9+. Install the package: pip install fmpsdk python-dotenv (python-dotenv

client.company.profile(symbol="AAPL"), client.statements.income_statement(symbol="AAPL").

1. Create a .env file and put your API key in it. Inside .env: FMPAPIKEY='blah'
2. Build a Client and call methods on it, grouped by data category — e.g.

parse it.

1. The return from a method call is almost always a list of dictionaries. It is up to you to

Example code

#!/usr/bin/env python3

from dotenv import load_dotenv

import fmpsdk

# Actual API key is stored in a .env file. Not good to store API key directly in script.
load_dotenv()
client = fmpsdk.Client()  # reads FMP_API_KEY from the environment

# Company Valuation Methods
symbol = "AAPL"
print(f"Company Profile: {client.company.profile(symbol=symbol)}")

# Every non-2xx FMP response raises a typed exception instead of returning

Shortened. The full README is on GitHub.