Financial Modeling Prep MCP Server

A Model Context Protocol (MCP) server that provides tools, resources, and prompts for financial analysis using the Financial Modeling Prep API.

Features

• Company Information: Access detailed company profiles and peer comparisons
• Financial Statements: Retrieve and analyze income statements, balance sheets, and cash flow statements
• Financial Metrics: Access key financial ratios and metrics for investment analysis
• Market Data: Get market snapshots, indexes, and news
• Stock Quotes: Get current stock quotes, aftermarket quotes, and simplified price information
• Stock Charts: Access historical price data and calculate price changes
• Analyst Ratings: Get analyst recommendations and rating details
• Market Indices: Access market indices data and quotes
• Market Performers: Get biggest gainers, losers, and most active stocks
• Market Hours: Check market hours and holidays for major exchanges
• ETF Analysis: Analyze ETF sector weightings, country exposure, and holdings
• Commodities: Get commodities list, current prices, and historical price data
• Cryptocurrencies: Access cryptocurrency listings and current quotes
• Forex: Get forex pair listings and exchange rates
• Technical Indicators: Calculate and interpret Exponential Moving Average (EMA)
• Analysis Prompts: Generate investment analyses using predefined prompt templates
• Chat Agent: Interactive CLI chat interface to FMP MCP Server
• Multiple Transport Options: Support for stdio, SSE, and Streamable HTTP transports
• Stateful & Stateless Modes: Flexible deployment options for different use cases
• Docker Support: Containerized deployment with configurable transport modes
• Health Check Endpoint: Built-in /health endpoint for load balancer health checks

Code Organization

The codebase is organized to align with the FMP API documentation structure found at FMP API Documentation. Each module corresponds to a specific section of the API:

• analyst.py: Analyst recommendations and price targets
• charts.py: Stock chart and historical price data
• commodities.py: Commodities list, price data, and historical price data
• company.py: Company profile and related information
• crypto.py: Cryptocurrency listings and quotes
• etf.py: ETF sector weightings, country exposure, and holdings
• forex.py: Forex pair listings and exchange rates
• indices.py: Market indices listings and quotes
• market.py: Market data and news
• market_hours.py: Market hours and holidays for major exchanges
• market_performers.py: Biggest gainers, losers, and most active stocks
• quote.py: Stock quote data, aftermarket quotes, and price changes
• search.py: API for searching tickers and companies
• statements.py: Financial statements (income, balance sheet, cash flow, ratios)
• technical_indicators.py: Technical indicators and analysis

API Endpoint Standardization

The codebase uses a standardized approach for retrieving quotes across different asset types:

• The unified quote endpoint is used for retrieving quotes for all asset types, including:

  • Stocks
  • Forex pairs
  • Cryptocurrencies
  • Commodities
  • Market indices

• Each module provides specialized formatting for its respective asset type:

  • get_quote: Standard stock quotes
  • get_aftermarket_quote: Aftermarket trading quotes with bid/ask data
  • get_forex_quotes: Currency exchange rates
  • get_crypto_quote: Cryptocurrency prices
  • get_commodities_prices: Commodity prices
  • get_historical_price_eod_light: Historical commodity price data
  • get_index_quote: Market index values

This standardization improves code maintainability and provides a consistent approach to retrieving asset prices throughout the application.

Other Recent Changes

... View full README on GitHub