Skip to main content
Glama
Financial Modeling Prep (FMP) MCP Server

Financial Modeling Prep (FMP) MCP Server

by jackdark425

Financial Modeling Prep MCP-Server

License: MIT Node.js MCP SDK Version

MCP-Server für Marktdaten von Financial Modeling Prep (FMP), erstellt mit dem modernen MCP SDK Tool/Ressourcen/Prompt-Modell.

Übersicht

aigroup-fmp-mcp bietet eine strukturierte MCP-Schnittstelle für die Financial Modeling Prep API für:

  • Echtzeit-Kurse und Symbolsuche

  • Unternehmensprofile und Finanzberichte

  • Analystenschätzungen und Ratings

  • Technische Indikatoren und historische Charts

  • Workflows für Gewinn- / Wirtschaftskalender

  • Wiederverwendbare MCP-Ressourcen und Prompts für Analyseaufgaben

Related MCP server: FMP MCP Server

Highlights

  • 25 MCP-Tools für Marktdaten, Finanzen, Analysten-Workflows, technische Indikatoren und Kalenderdaten

  • Ressourcen-Unterstützung für direkte URI-basierte Zugriffsmuster

  • Prompt-Vorlagen für Aktienanalysen, Portfolio-Überprüfungen und Gewinnvorschau

  • Vollständige stdio MCP-Unterstützung mit optionalen HTTP-Health/Info-Endpunkten

  • Zod-Validierung für sicherere Eingabeverarbeitung

  • Aufgebaut auf MCP SDK 1.27.1 mit modernen McpServer APIs

Schnellstart

Anforderungen

  • Node.js >= 18

  • npm

  • Ein gültiger FMP-API-Schlüssel

Ausführung mit lokaler Quelle

git clone https://github.com/jackdark425/aigroup-fmp-mcp.git
cd aigroup-fmp-mcp
npm install
npm run build
export FMP_API_KEY="your-api-key"
npm start

HTTP-Modus

export FMP_API_KEY="your-api-key"
npm run start:http

Standardmäßig stellt der HTTP-Server Folgendes bereit:

  • POST /mcp — gibt in diesem Build 501 zurück

  • GET /health — Gesundheitsprüfung

  • GET / — Server-Informationen

Der HTTP-Modus im aktuellen Build ist nur für Gesundheitsprüfungen und Dienst-Metadaten vorgesehen. Verwenden Sie den stdio-Modus für MCP-Tools, Ressourcen und Prompts.

Konfiguration

Legen Sie Ihren API-Schlüssel fest, bevor Sie den Server starten:

export FMP_API_KEY="your-api-key"

Erhalten Sie Ihren Schlüssel von Financial Modeling Prep.

MCP-Client-Konfiguration

Claude Desktop / kompatible MCP-Clients

{
  "mcpServers": {
    "fmp": {
      "command": "node",
      "args": ["/path/to/aigroup-fmp-mcp/build/index.js"],
      "env": {
        "FMP_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

Marktdaten

  • get_quote

  • search_symbol

  • get_market_gainers

  • get_market_losers

  • get_most_active

  • get_sector_performance

  • get_sp500_constituents

Finanzberichte

  • get_company_profile

  • get_income_statement

  • get_balance_sheet

  • get_cash_flow

  • get_stock_news

  • get_key_metrics

  • get_financial_ratios

Analystendaten

  • get_analyst_estimates

  • get_price_target

  • get_analyst_ratings

  • get_insider_trading

  • get_institutional_holders

Technische Indikatoren

  • get_technical_indicator_rsi

  • get_technical_indicator_sma

  • get_technical_indicator_ema

  • get_historical_chart

Kalenderdaten

  • get_earnings_calendar

  • get_economic_calendar

  • get_economic_indicator

Ressourcen

  • fmp://company/{symbol}/profile

  • fmp://company/{symbol}/quote

  • fmp://company/{symbol}/financials/{statement}/{period}

  • fmp://market/overview

  • fmp://market/sectors/{date}

Prompts

  • stock_analysis

  • portfolio_evaluation

  • earnings_preview

Projektstruktur

aigroup-fmp-mcp/
├── src/
│   ├── index.ts
│   ├── server.ts
│   ├── tools/
│   ├── resources/
│   ├── prompts/
│   ├── types/
│   └── utils/
├── package.json
├── tsconfig.json
└── README.md

Entwicklung

npm install
npm run build
npm run dev

API-Referenz

Alle Tools sind auf FMP-Endpunkte abgebildet. Siehe die offizielle Dokumentation:

Danksagungen

Referenzprojekt

Dank an houtini-ai für die vorherige Open-Source-Arbeit, die dazu beigetragen hat, diese Implementierung zu informieren.

Lizenz & Nutzung

Dieses Projekt wird unter der MIT-Lizenz veröffentlicht.

Sie dürfen Kopien dieser Software verwenden, kopieren, modifizieren, zusammenführen, veröffentlichen, verbreiten, unterlizenzieren und verkaufen, auch in kommerziellen Kontexten, vorausgesetzt, der ursprüngliche Urheberrechtshinweis und der Lizenztext bleiben erhalten.

Bitte beachten Sie:

  • die Software wird "WIE BESEHEN" bereitgestellt, ohne jegliche Gewährleistung

  • Sie müssen den relevanten Urheberrechts- und Genehmigungshinweis in Kopien oder wesentlichen Teilen der Software beibehalten

  • die Nutzung der FMP API unterliegt weiterhin den eigenen Nutzungsbedingungen, Kontingenten, Abrechnungsregeln und Datennutzungsbeschränkungen von Financial Modeling Prep

Siehe den vollständigen Text in LICENSE.

Support

Available Tools

26 tools
get_analyst_estimatesB

Get analyst financial estimates for a stock (revenue, EPS forecasts)

Inputs: symbol (required), period, limit.

get_analyst_ratingsB

Get analyst ratings and upgrades/downgrades for a stock

Inputs: symbol (required).

get_balance_sheetB

Get company balance sheet statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_cash_flowC

Get company cash flow statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_company_profileB

Get detailed company profile information including description, industry, sector, CEO, and more

Inputs: symbol (required).

get_earnings_calendarB

Get upcoming earnings announcements calendar

Inputs: from, to.

get_economic_calendarC

Get upcoming economic data releases calendar

Inputs: from, to.

get_economic_indicatorC

Get economic indicator data (GDP, unemployment, inflation, etc.)

Inputs: name (required), from, to.

get_financial_ratiosB

Get detailed financial ratios (profitability, liquidity, efficiency)

Inputs: symbol (required), period, limit.

get_historical_chartC

Get historical price data with flexible time intervals

Inputs: symbol (required), interval (required), from, to.

get_income_statementC

Get company income statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_insider_tradingC

Get recent insider trading activity for a stock

Inputs: symbol (required), limit.

get_institutional_holdersC

Get institutional ownership (13F filings) for a stock

Inputs: symbol (required), limit.

get_key_metricsB

Get key financial metrics (P/E, ROE, debt ratios, etc.)

Inputs: symbol (required), period, limit.

get_market_gainersB

Get stocks with the largest price increases (top gainers)

Inputs: no named parameters.

get_market_losersB

Get stocks with the largest price drops (top losers)

Inputs: no named parameters.

get_most_activeB

Get most actively traded stocks by volume

Inputs: no named parameters.

get_price_targetB

Get analyst price target summary for a stock

Inputs: symbol (required).

get_quoteA

Get real-time stock quote for a symbol (e.g., AAPL, TSLA, MSFT)

Inputs: symbol (required).

get_sector_performanceC

Get current sector performance snapshot

Inputs: date.

get_sp500_constituentsB

Get list of S&P 500 index constituents

Inputs: no named parameters.

get_stock_newsC

Get latest news articles for a stock symbol

Inputs: symbol (required), limit.

get_technical_indicator_emaC

Get Exponential Moving Average (EMA) technical indicator

Inputs: symbol (required), timeframe (required), period.

get_technical_indicator_rsiC

Get Relative Strength Index (RSI) technical indicator

Inputs: symbol (required), timeframe (required), period.

get_technical_indicator_smaC

Get Simple Moving Average (SMA) technical indicator

Inputs: symbol (required), timeframe (required), period.

search_symbolC

Search for stock symbols by company name or ticker

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 26 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting specific financial data categories (e.g., financial statements, market data, analyst information). However, some potential overlap exists between get_financial_ratios and get_key_metrics, and among the three technical indicator tools (EMA, RSI, SMA) which might cause minor confusion about which specific indicator is needed.

    Naming Consistency5/5

    Excellent naming consistency with a uniform get_* pattern throughout all 26 tools. The naming follows a clear verb_noun structure where 'get' is the consistent verb followed by descriptive nouns that clearly indicate the data being retrieved.

    Tool Count3/5

    26 tools is borderline heavy for a financial data server. While comprehensive coverage is valuable, this many tools might overwhelm agents and could potentially be consolidated (e.g., technical indicators could be combined into a single parameterized tool). The count suggests good breadth but questionable depth optimization.

    Completeness5/5

    Extremely comprehensive coverage of financial data domains including fundamental analysis (statements, ratios, metrics), market data (quotes, gainers/losers), analyst information (estimates, ratings), economic data, and technical indicators. No obvious gaps exist for a financial data provider server.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools for financial analysis using the Financial Modelling Prep API. It enables users to retrieve real-time stock quotes, financial statements, valuation metrics, and sector performance data for investment research.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that provides tools for financial analysis and investment research using the Financial Modelling Prep API. It enables users to access real-time stock quotes, financial statements, key metrics, and market sector performance data.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A specialized MCP server that provides institutional-grade financial data and market research via the Finnhub API. It enables AI agents to function as equity researchers, generating professional market reports and high-fidelity analysis for stock tickers.
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol (MCP) server that provides tools, resources, and prompts for financial analysis using the Financial Modeling Prep API.
      51
      MIT