Financial Modeling Prep MCP Server

🚀 Financial Modeling Prep MCP (Model Context Protocol) Server

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

🚀 Quick Start

This MCP server allows AI assistants to access and analyze financial data. You can use it in production via the Smithery registry or set it up for local development. For production, visit 🚀 View on Smithery. For local development, follow the steps below:

# Clone and setup
git clone https://github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server
cd Financial-Modeling-Prep-MCP-Server
npm install
npm run build

# Run in development
FMP_ACCESS_TOKEN=YOUR_TOKEN npm run dev

# Or with CLI arguments
npm run dev -- --fmp-token=YOUR_TOKEN
npm run dev -- --port=4000 --fmp-token=YOUR_TOKEN

✨ Features

• Comprehensive Coverage: Access to 253+ financial tools across 24 categories
• Tool Set Filtering: Load only the tools you need to reduce complexity and improve performance
• Real-time Data: Live stock quotes, market data, and financial information
• Financial Statements: Income statements, balance sheets, cash flow statements, and financial ratios
• Market Analysis: Technical indicators, analyst estimates, and market performance metrics
• Economic Data: Treasury rates, GDP, inflation, economic indicators
• Alternative Data: ESG scores, insider trading, congressional trading, and social sentiment

📦 Installation

Production via Smithery Registry

For production environments, use this MCP server through the Smithery registry: 🚀 View on Smithery.

HTTP Server & Local Development

# Clone and setup
git clone https://github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server
cd Financial-Modeling-Prep-MCP-Server
npm install
npm run build

# Run in development
FMP_ACCESS_TOKEN=YOUR_TOKEN npm run dev

# Or with CLI arguments
npm run dev -- --fmp-token=YOUR_TOKEN
npm run dev -- --port=4000 --fmp-token=YOUR_TOKEN

Docker Usage

Using Docker with Environment Variables

# Basic deployment
docker run -p 8080:8080 -e FMP_ACCESS_TOKEN=YOUR_TOKEN your-image-name

# With server-level dynamic mode
docker run -p 8080:8080 \
  -e FMP_ACCESS_TOKEN=YOUR_TOKEN \
  -e DYNAMIC_TOOL_DISCOVERY=true \
  your-image-name

# With server-level static mode
docker run -p 8080:8080 \
  -e FMP_ACCESS_TOKEN=YOUR_TOKEN \
  -e FMP_TOOL_SETS=search,company,quotes \
  your-image-name

Using Docker Compose

Create a docker-compose.yml file:

version: "3.8"
services:
  fmp-mcp:
    image: your-image-name
    ports:
      - "8080:8080"
    environment:
      - FMP_ACCESS_TOKEN=YOUR_FMP_ACCESS_TOKEN
      - PORT=8080
      # Optional: Server-level mode enforcement
      - DYNAMIC_TOOL_DISCOVERY=true # All sessions use dynamic mode
      # OR
      - FMP_TOOL_SETS=search,company,quotes # All sessions use these toolsets
      # OR leave both unset for legacy mode (all tools)

Then run:

docker-compose up

Using .env File with Docker Compose

Create a .env file:

FMP_ACCESS_TOKEN=YOUR_FMP_ACCESS_TOKEN
PORT=8080

# Optional: Choose ONE server-level mode
DYNAMIC_TOOL_DISCOVERY=true
# OR
# FMP_TOOL_SETS=search,company,quotes
# OR leave both commented for legacy mode

And reference it in your docker-compose.yml:

version: "3.8"
services:
  fmp-mcp:
    image: your-image-name
    ports:
      - "8080:8080"
    env_file:
      - .env

💻 Usage Examples

Making HTTP Requests

Endpoint Format

POST http://localhost:8080/mcp[?config=BASE64_ENCODED_CONFIG]

Required Headers

Content-Type: application/json
Accept: application/json, text/event-stream

Session Configuration

Session configurations are passed as Base64-encoded JSON in the config query parameter.

Configuration Examples:

1. Dynamic Mode Session:

# Configuration: {"DYNAMIC_TOOL_DISCOVERY":"true"}
CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
# Result: eyJEWU5BTUlDX1RPT0xfRElTQ09WRVJZIjoidHJ1ZSJ9

2. Static Mode Session:

# Configuration: {"FMP_TOOL_SETS":"search,company,quotes"}
CONFIG_BASE64=$(echo -n '{"FMP_TOOL_SETS":"search,company,quotes"}' | base64)
# Result: eyJGTVBfVE9PTF9TRVRTIjoic2VhcmNoLGNvbXBhbnkscXVvdGVzIn0=

3. Legacy Mode Session:

# Configuration: {} (empty object)
CONFIG_BASE64=$(echo -n '{}' | base64)
# Result: e30=

Request Examples

1. Initialize a Dynamic Mode Session

CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "clientInfo": {
        "name": "my-client",
        "version": "1.0.0"
      },
      "capabilities": {}
    }
  }'

Expected Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    },
    "serverInfo": {
      "name": "fmp-mcp-server",
      "version": "1.0.0"
    }
  }
}

2. List Available Tools

CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

Expected Response (Dynamic Mode):

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "enable_toolset",
        "description": "Enable a specific toolset during runtime",
        "inputSchema": {
          "type": "object",
          "properties": {
            "toolset": {
              "type": "string",
              "description": "Name of the toolset to enable"
            }
          },
          "required": ["toolset"]
        }
      },
      {
        "name": "disable_toolset",
        "description": "Disable a previously enabled toolset"
      },
      {
        "name": "get_toolset_status",
        "description": "Check which toolsets are currently active"
      }
    ]
  }
}

3. Enable a Toolset (Dynamic Mode)

CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "enable_toolset",
      "arguments": {
        "toolset": "search"
      }
    }
  }'

4. Call a Financial Tool

CONFIG_BASE64=$(echo -n '{"FMP_TOOL_SETS":"search,quotes"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "searchSymbol",
      "arguments": {
        "query": "Apple"
      }
    }
  }'

5. Get Stock Quote

CONFIG_BASE64=$(echo -n '{"FMP_TOOL_SETS":"quotes"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "getQuote",
      "arguments": {
        "symbol": "AAPL"
      }
    }
  }'

📚 Documentation

Server Architecture

This MCP server uses a stateful session-based architecture powered by the Smithery SDK for request/session lifecycle. Resource reuse is handled via a client-level cache keyed by clientId (derived from the access token).

Key Features:

• Client-level Caching: Exactly one McpServer/DynamicToolsetManager is maintained per clientId. Tokenless requests use a per-request anonymous id (no reuse).
• Session Isolation: Sessions are managed by the SDK, but caching does not use sessionId.
• Stateful Management: Sessions maintain their state across multiple requests
• Mode Enforcement: Server-level configurations can override session-level settings
• HTTP-based Protocol: Communicates via HTTP with JSON-RPC formatted messages
• Dynamic Tool Management: Tools can be loaded/unloaded at runtime per session

Request Flow:

1. Client Request → HTTP POST to /mcp endpoint
2. Session Management → Server creates or retrieves session based on config (caching and reuse are keyed by clientId)
3. Mode Resolution → Server determines operational mode (Dynamic/Static/Legacy)
4. Tool Registration → Session-specific tools are loaded based on resolved mode
5. Request Processing → MCP request is processed with available tools
6. Response → JSON-RPC response sent back to client

Configuration & Mode Enforcement

The server supports multiple configuration methods with a clear precedence hierarchy to ensure predictable behavior.

Server Modes

The server operates in one of three modes:

1. 🔀 Dynamic Mode (DYNAMIC_TOOL_DISCOVERY=true)

   • Starts with only 3 meta-tools: enable_toolset, disable_toolset, get_toolset_status
   • Tools loaded on-demand via meta-tool calls
   • Best for: Flexible, task-specific workflows where tool requirements change

2. 🔧 Static Mode (FMP_TOOL_SETS=search,company,quotes)

   • Pre-loads specific toolsets at session creation
   • All specified tools available immediately
   • Best for: Known, consistent tool requirements with predictable usage patterns

3. 📚 Legacy Mode (default, no specific configuration)

   • Loads all 253+ tools at session creation
   • Maximum compatibility with all features available
   • Best for: Full feature access without configuration complexity

Configuration Precedence

The server follows a strict precedence hierarchy when determining the operational mode:

🥇 CLI Arguments (highest priority)
   ↓
🥈 Environment Variables
   ↓
🥉 Session Configuration (lowest priority)

⚠️ Important Mode Enforcement Behavior

When server-level configurations are set (CLI arguments or environment variables), they override all session-level configurations for ALL sessions. This ensures consistent behavior across the entire server instance.

Example Override Scenario:

# Server started with CLI argument
npm run dev -- --dynamic-tool-discovery

# ALL session requests will use Dynamic Mode, regardless of session config
# Session config like {"FMP_TOOL_SETS": "search,company"} will be IGNORED

Configuration Methods:

1. CLI Arguments (Server-level - overrides everything)

npm run dev -- --fmp-token=TOKEN --dynamic-tool-discovery
npm run dev -- --fmp-token=TOKEN --fmp-tool-sets=search,company,quotes
npm run dev -- --port=4000 --fmp-token=TOKEN

2. Environment Variables (Server-level - overrides session configs)

DYNAMIC_TOOL_DISCOVERY=true npm run dev
FMP_TOOL_SETS=search,company,quotes npm run dev

3. Session Configuration (Session-level - via HTTP query parameter)

# Base64 encoded JSON config in query parameter
curl -X POST "http://localhost:8080/mcp?config=eyJEWU5BTUlDX1RPT0xfRElTQ09WRVJZIjoidHJ1ZSJ9"

⚠️ Configuration Warnings

• Server-level modes are GLOBAL: They affect all sessions on the server instance
• Session configs are IGNORED when server-level modes are active
• No mixing: You cannot have different modes for different sessions when server-level enforcement is active
• Restart required: Changing server-level configurations requires server restart

Selective Tool Loading

While MCP clients can filter tools automatically, large tool sets may impact performance. To optimize your experience, you can specify which tool categories to load instead of loading all 253 tools at once:

Available Tool Sets

Dynamic Toolset Management (BETA)

🚧 This feature is currently in BETA. API and behavior may change in future versions.

The Dynamic Toolset Management feature allows you to enable and disable tool categories at runtime instead of pre-configuring them at startup. This provides more flexibility and can help optimize performance by loading only the tools you need when you need them.

How It Works

When dynamic toolset management is enabled, each session starts with only 3 meta-tools:

• enable_toolset - Enable a specific toolset during runtime
• disable_toolset - Disable a previously enabled toolset
• get_toolset_status - Check which toolsets are currently active

AI assistants can then use these meta-tools to dynamically load and unload specific tool categories as needed for different tasks within their session.

Configuration Options

Server-Level Configuration (Affects All Sessions)

Command Line Arguments:

# Enable dynamic toolset management for all sessions
npm run dev -- --fmp-token=YOUR_TOKEN --dynamic-tool-discovery

# Production deployment
node dist/index.js --fmp-token=YOUR_TOKEN --dynamic-tool-discovery

Environment Variables:

# Set environment variable
export DYNAMIC_TOOL_DISCOVERY=true
export FMP_ACCESS_TOKEN=YOUR_TOKEN
npm run dev

# Or inline
DYNAMIC_TOOL_DISCOVERY=true FMP_ACCESS_TOKEN=YOUR_TOKEN npm start

Docker:

# docker-compose.yml
version: "3.8"
services:
  fmp-mcp:
    image: your-image-name
    ports:
      - "8080:8080"
    environment:
      - FMP_ACCESS_TOKEN=YOUR_FMP_ACCESS_TOKEN
      - DYNAMIC_TOOL_DISCOVERY=true # Enable for all sessions

Session-Level Configuration (When No Server Override)

When no server-level dynamic mode is set, individual sessions can request dynamic mode:

# Base64 encode: {"DYNAMIC_TOOL_DISCOVERY":"true"}
CONFIG_BASE64=$(echo -n '{"DYNAMIC_TOOL_DISCOVERY":"true"}' | base64)
curl -X POST "http://localhost:8080/mcp?config=${CONFIG_BASE64}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",...}'

Example Workflow

1. Start server with dynamic mode:

DYNAMIC_TOOL_DISCOVERY=true npm start

2. AI assistant initializes session and gets meta-tools:

// Response includes only 3 meta-tools:
{
  "tools": [
    { "name": "enable_toolset", "description": "Enable a specific toolset" },
    { "name": "disable_toolset", "description": "Disable a toolset" },
    { "name": "get_toolset_status", "description": "Check active toolsets" }
  ]
}

3. AI assistant enables needed toolsets:

// Enable search toolset
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"enable_toolset","arguments":{"toolset":"search"}}}

// Enable quotes toolset
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"enable_toolset","arguments":{"toolset":"quotes"}}}

4. AI assistant uses the enabled tools:

// Now can use search and quotes tools
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"searchSymbol","arguments":{"query":"AAPL"}}}
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"getQuote","arguments":{"symbol":"AAPL"}}}

5. AI assistant can disable unused toolsets:

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "disable_toolset",
    "arguments": { "toolset": "search" }
  }
}

Benefits

• Performance: Start faster with fewer tools loaded initially per session
• Flexibility: Load only the tools needed for current tasks
• Resource Efficiency: Reduce memory usage by disabling unused toolsets per session
• Task-Oriented: Perfect for AI assistants that work on specific financial analysis tasks
• Session Isolation: Each session can have different active toolsets

Available Tools

⚠️ Important Note

Server-Level Configurations Override Session Configurations:

• When CLI arguments (--dynamic-tool-discovery, --fmp-tool-sets) are used, they apply to ALL sessions
• When environment variables (DYNAMIC_TOOL_DISCOVERY, FMP_TOOL_SETS) are set, they apply to ALL sessions
• Session-level configurations via query parameters are IGNORED when server-level modes are active
• This ensures consistent behavior across all sessions on a server instance

Configuration Precedence: CLI Arguments > Environment Variables > Session Configuration

Example: If server started with --dynamic-tool-discovery, ALL sessions will use dynamic mode even if they request {"FMP_TOOL_SETS":"search,company"} in their session config.

This MCP provides the following tools for AI assistants to access financial data:

Search Tools

• searchSymbol: Search for stock symbols by name or ticker
• searchName: Search for companies by name
• searchCIK: Search for companies by CIK number
• searchCUSIP: Search for securities by CUSIP number
• searchISIN: Search for securities by ISIN number
• stockScreener: Screen stocks based on various criteria
• searchExchangeVariants: Search for symbol variants across different exchanges
• searchCompaniesByName: Search for companies by name
• searchCompaniesBySymbol: Search for companies by symbol
• searchCompaniesByCIK: Search for companies by CIK number

Directory and Symbol Lists

• getCompanySymbols: Get a list of all company symbols
• getFinancialStatementSymbols: Get a list of companies with available financial statements
• getCIKList: Get a list of CIK numbers for SEC-registered entities
• getSymbolChanges: Get a list of stock symbol changes
• getETFList: Get a list of ETFs
• getActivelyTradingList: Get a list of actively trading companies
• getEarningsTranscriptList: Get a list of companies with earnings transcripts
• getAvailableExchanges: Get a list of available exchanges
• getAvailableSectors: Get a list of available sectors
• getAvailableIndustries: Get a list of available industries
• getAvailableCountries: Get a list of available countries
• getAvailableTranscriptSymbols: Get a list of symbols with available transcripts
• getAllIndustryClassification: Get all industry classifications
• getIndustryClassificationList: Get a list of industry classifications

Company Information

• getCompanyProfile: Get detailed company profile information
• getCompanyExecutives: Get information about company executives
• getCompanyDescription: Get company description
• getCompanyOutlook: Get company outlook information
• getCompanyRating: Get company rating information
• getHistoricalRating: Get historical company ratings
• getCompanyUpgradesDowngrades: Get company upgrades and downgrades
• getCompanyGrade: Get company grade information
• getCompanyPeers: Get companies similar to a given company
• getMarketCap: Get company market capitalization
• getHistoricalMarketCap: Get historical market capitalization
• getSharesFloat: Get company shares float information
• getHistoricalSharesFloat: Get historical shares float information
• getEarningsSurprises: Get historical earnings surprises
• getEarningCallTranscript: Get specific earnings call transcript
• getEarningCallTranscriptsBySymbol: Get all earnings call transcripts for a symbol
• getCompanyNotes: Get company notes
• getCompanyProfileByCIK: Get company profile by CIK
• getCompanySECProfile: Get company SEC profile
• getDelistedCompanies: Get a list of delisted companies
• getEmployeeCount: Get employee count for a company
• getHistoricalEmployeeCount: Get historical employee count
• getBatchMarketCap: Get batch market cap data
• getAllShareFloat: Get all share float data
• getLatestMergersAcquisitions: Get latest mergers and acquisitions
• searchMergersAcquisitions: Search mergers and acquisitions
• getExecutiveCompensation: Get executive compensation data
• getExecutiveCompensationBenchmark: Get executive compensation benchmark data
• getAcquisitionOwnership: Get acquisition ownership data

Financial Statements

• getIncomeStatement: Get company income statements
• getBalanceSheet: Get company balance sheet statements
• getBalanceSheetStatement: Get company balance sheet statements
• getCashFlowStatement: Get company cash flow statements
• getIncomeStatementAsReported: Get income statements as reported
• getBalanceSheetAsReported: Get balance sheet statements as reported
• getBalanceSheetStatementAsReported: Get balance sheet statements as reported
• getCashFlowStatementAsReported: Get cash flow statements as reported
• getFullFinancialStatementAsReported: Get full financial statements as reported
• getFinancialStatementFullAsReported: Get full financial statements as reported
• getFinancialReportDates: Get dates of available financial reports
• getFinancialReportsDates: Get dates of available financial reports
• getLatestFinancialStatements: Get latest financial statements
• getIncomeStatementTTM: Get trailing twelve months income statements
• getBalanceSheetStatementTTM: Get trailing twelve months balance sheet statements
• getCashFlowStatementTTM: Get trailing twelve months cash flow statements
• getIncomeStatementGrowth: Get income statement growth
• getBalanceSheetStatementGrowth: Get balance sheet statement growth
• getCashFlowStatementGrowth: Get cash flow statement growth
• getFinancialStatementGrowth: Get financial statement growth
• getFinancialReportJSON: Get financial report in JSON format
• getFinancialReportXLSX: Get financial report in XLSX format
• getRevenueProductSegmentation: Get revenue product segmentation
• getRevenueGeographicSegmentation: Get revenue geographic segmentation

Financial Metrics and Analysis

• getKeyMetrics: Get key financial metrics for a company
• getKeyMetricsTTM: Get key metrics for trailing twelve months
• getRatios: Get financial ratios for a company
• getFinancialRatios: Get financial ratios for a company
• getFinancialRatiosTTM: Get financial ratios for trailing twelve months
• getFinancialGrowth: Get financial growth metrics
• getIncomeStatementGrowth: Get income statement growth metrics
• getBalanceSheetGrowth: Get balance sheet growth metrics
• getCashFlowStatementGrowth: Get cash flow statement growth metrics
• getDCFValuation: Get DCF (Discounted Cash Flow) valuation for a stock
• getLeveredDCFValuation: Get levered DCF valuation for a stock
• calculateCustomDCF: Calculate custom DCF valuation with user-defined parameters
• calculateCustomLeveredDCF: Calculate custom levered DCF valuation with user-defined parameters
• getEnterpriseValue: Get enterprise value for a company
• getFinancialScore: Get financial score for a company
• getFinancialScores: Get financial scores for a company
• getOwnerEarnings: Get owner earnings for a company

Technical Indicators

• getSMA: Get Simple Moving Average (SMA) indicator
• getEMA: Get Exponential Moving Average (EMA) indicator
• getWMA: Get Weighted Moving Average (WMA) indicator
• getDEMA: Get Double Exponential Moving Average (DEMA) indicator
• getTEMA: Get Triple Exponential Moving Average (TEMA) indicator
• getWilliams: Get Williams %R indicator
• getADX: Get Average Directional Index (ADX) indicator
• getStandardDeviation: Get Standard Deviation indicator
• getRSI: Get Relative Strength Index (RSI) indicator

Quotes and Price Data

• getQuote: Get current stock quote information
• getBatchQuotes: Get quotes for multiple symbols
• getQuoteShort: Get abbreviated stock quote information
• getBatchQuotesShort: Get abbreviated quotes for multiple symbols
• getHistoricalPrice: Get historical price data
• getHistoricalPriceChart: Get historical price chart data
• getHistoricalDailyPrice: Get historical daily price data
• getHistoricalStockSplits: Get historical stock splits
• getHistoricalDividends: Get historical dividends
• getTechnicalIndicator: Get technical indicators for a stock
• getLightChart: Get light version of price chart
• getFullChart: Get full version of price chart
• getUnadjustedChart: Get unadjusted price chart
• getDividendAdjustedChart: Get dividend-adjusted price chart
• getIntradayChart: Get intraday price chart
• getAftermarketQuote: Get aftermarket quote
• getAftermarketTrade: Get aftermarket trade data
• getBatchAftermarketQuote: Get batch aftermarket quotes
• getBatchAftermarketTrade: Get batch aftermarket trade data
• getStockPriceChange: Get stock price change information

Market Indexes and Performance

• getIndexList: Get a list of all market indexes
• getIndexQuotes: Get quotes for market indexes
• getIndexQuote: Get quote for a specific index
• getIndexShortQuote: Get abbreviated quote for an index
• getAllIndexQuotes: Get quotes for all market indexes
• getSP500Constituents: Get S&P 500 constituent companies
• getHistoricalSP500Changes: Get historical S&P 500 changes
• getNasdaqConstituents: Get NASDAQ constituent companies
• getDowJonesConstituents: Get Dow Jones constituent companies
• getHistoricalNasdaqChanges: Get historical NASDAQ changes
• getHistoricalDowJonesChanges: Get historical Dow Jones changes
• getSectorPerformance: Get sector performance data
• getHistoricalSectorPerformance: Get historical sector performance
• getBiggestGainers: Get biggest gaining stocks
• getBiggestLosers: Get biggest losing stocks
• getMostActiveStocks: Get most active stocks
• getHistoricalIndexFullChart: Get historical index full chart
• getHistoricalIndexLightChart: Get historical index light chart
• getIndex1MinuteData: Get 1-minute index data
• getIndex5MinuteData: Get 5-minute index data
• getIndex1HourData: Get 1-hour index data
• getSectorPerformanceSnapshot: Get sector performance snapshot
• getSectorPESnapshot: Get sector PE ratio snapshot
• getIndustryPerformanceSnapshot: Get industry performance snapshot
• getIndustryPerformanceSummary: Get industry performance summary
• getIndustryPESnapshot: Get industry PE ratio snapshot
• getHistoricalIndustryPerformance: Get historical industry performance
• getHistoricalIndustryPE: Get historical industry PE ratios
• getHistoricalSectorPE: Get historical sector PE ratios

Market Data

• getMarketHours: Get market hours for a specific exchange
• getExchangeMarketHours: Get market hours for a specific exchange
• getHolidaysByExchange: Get holidays for a specific exchange with optional date range filtering
• getAllExchangeMarketHours: Get market hours for all exchanges
• getEarningsCalendar: Get earnings announcement calendar
• getIPOCalendar: Get initial public offering calendar
• getStockSplitCalendar: Get stock split calendar
• getDividendCalendar: Get dividend calendar
• getEconomicCalendar: Get economic events calendar
• getIPODisclosures: Get IPO disclosures
• getIPOProspectuses: Get IPO prospectuses

News and Press Releases

• getFMPArticles: Get financial news articles from FMP
• getGeneralNews: Get general financial news
• getStockNews: Get news for specific stocks
• getStockNewsSentiment: Get news with sentiment analysis
• getPressReleases: Get company press releases
• searchStockNews: Search stock news
• searchPressReleases: Search press releases
• getCryptoNews: Get cryptocurrency news
• searchCryptoNews: Search cryptocurrency news
• getForexNews: Get forex news
• searchForexNews: Search forex news

SEC Filings

• getLatestFinancialFilings: Get latest financial filings
• getFilingsBySymbol: Get filings by symbol
• getFilingsByCIK: Get filings by CIK
• getFilingsByFormType: Get filings by form type
• getLatest8KFilings: Get latest 8-K filings
• getSecFilingExtract: Get SEC filing extract
• getFilingExtractAnalyticsByHolder: Get filing extract analytics by holder

Insider and Institutional Trading

• getInsiderTrading: Get insider trading data
• getInsiderRoster: Get insider roster for a company
• getInsiderRosterStatistics: Get statistics on insider roster
• getInsiderTransactionTypes: Get types of insider transactions
• getInsiderOwnership: Get insider ownership information
• getInstitutionalOwnership: Get institutional ownership data
• getInstitutionalHolders: Get institutional holders for a company
• getInstitutionalHoldersList: Get list of institutional holders
• getInstitutionalHolderPortfolioDates: Get portfolio dates for institutional holders
• get13FFilings: Get 13F filings
• get13FDates: Get dates of 13F filings
• getForm13FFilingDates: Get 13F filing dates
• getLatestInsiderTrading: Get latest insider trading data
• searchInsiderTrades: Search insider trades
• searchInsiderTradesByReportingName: Search insider trades by reporting name
• getInsiderTradeStatistics: Get insider trade statistics
• getLatestInstitutionalFilings: Get latest institutional filings
• getHolderPerformanceSummary: Get holder performance summary
• getHolderIndustryBreakdown: Get holder industry breakdown
• getPositionsSummary: Get positions summary

ETFs and Funds

• getETFHolder: Get ETF holder information
• getETFSectorWeighting: Get ETF sector weightings
• getETFCountryWeighting: Get ETF country weightings
• getETFExposure: Get ETF exposure to stocks
• getFundInfo: Get fund information
• getFundHolder: Get fund holder information
• getFundSectorWeighting: Get fund sector weightings
• getFundHoldings: Get fund holdings
• getFundCountryAllocation: Get fund country allocation
• getFundAssetExposure: Get fund asset exposure
• getDisclosure: Get latest fund disclosure holders information
• getFundDisclosure: Get comprehensive fund disclosure data by year/quarter
• searchFundDisclosures: Search fund disclosures by holder name
• getFundDisclosureDates: Get fund disclosure dates (with optional CIK)
• getETFHoldersBulk: Get ETF holders in bulk
• getETFQuotes: Get ETF quotes
• getMutualFundQuotes: Get mutual fund quotes

Government Trading

• getGovernmentTradingList: Get government trading list
• getSenateTrading: Get senate trading data
• getHouseTrading: Get house trading data
• getSenateTrades: Get senate trades
• getSenateTradesByName: Get senate trades by name
• getHouseTrades: Get house trades
• getHouseTradesByName: Get house trades by name
• getLatestSenateDisclosures: Get latest senate disclosures
• getLatestHouseDisclosures: Get latest house disclosures

Cryptocurrency and Forex

• getCryptocurrencyList: Get a list of cryptocurrencies
• getCryptocurrencyQuote: Get cryptocurrency quote
• getCryptocurrencyShortQuote: Get abbreviated cryptocurrency quote
• getCryptocurrencyBatchQuotes: Get quotes for multiple cryptocurrencies
• getCryptocurrencyHistoricalLightChart: Get light historical cryptocurrency chart
• getCryptocurrencyHistoricalFullChart: Get full historical cryptocurrency chart
• getCryptocurrency1MinuteData: Get 1-minute cryptocurrency data
• getCryptocurrency5MinuteData: Get 5-minute cryptocurrency data
• getCryptocurrency1HourData: Get 1-hour cryptocurrency data
• getForexList: Get a list of forex pairs
• getForexQuote: Get forex pair quote
• getForexShortQuote: Get abbreviated forex quote
• getForexBatchQuotes: Get quotes for multiple forex pairs with optional short format
• getForexHistoricalLightChart: Get light historical forex chart with optional date range
• getForexHistoricalFullChart: Get full historical forex chart with optional date range
• getForex1MinuteData: Get 1-minute forex data with optional date range
• getForex5MinuteData: Get 5-minute forex data with optional date range
• getForex1HourData: Get 1-hour forex data with optional date range

Earnings

• getEarningsReports: Get earnings reports
• getEarningsTranscript: Get earnings transcript
• getEarningsTranscriptDates: Get earnings transcript dates
• getLatestEarningsTranscripts: Get latest earnings transcripts
• getEarningsSurprisesBulk: Get bulk earnings surprises

Special Data Sets

• getCOTList: Get Commitment of Traders (COT) list
• getCOTReports: Get COT reports for a specific symbol with optional date range filtering
• getCOTAnalysis: Get COT analysis for a specific symbol with optional date range filtering
• getGovernmentTradingList: Get government trading list
• getSenateTrading: Get senate trading data
• getHouseTrading: Get house trading data
• getESGDisclosures: Get ESG disclosures for a specific symbol
• getESGRatings: Get ESG ratings for a specific symbol
• getESGBenchmarks: Get ESG benchmark data with optional year filtering

Commodities

• listCommodities: Get a list of all available commodities with their symbols, names, exchanges, trade months, and currencies

Economics

• getTreasuryRates: Get treasury rates with optional date range filtering
• getEconomicIndicators: Get economic indicators by name with optional date range filtering
• getEconomicCalendar: Get economic events calendar with optional date range filtering
• getMarketRiskPremium: Get market risk premium data

Fundraisers

• getLatestCrowdfundingCampaigns: Get latest crowdfunding campaigns
• searchCrowdfundingCampaigns: Search crowdfunding campaigns
• getCrowdfundingCampaignsByCIK: Get crowdfunding campaigns by CIK
• getLatestEquityOfferings: Get latest equity offerings
• searchEquityOfferings: Search equity offerings
• getEquityOfferingsByCIK: Get equity offerings by CIK

Bulk Data Tools

Important Note: All bulk endpoints return data in CSV format as raw strings rather than parsed JSON objects. This endpoint returns the response as a CSV file. The provided sample response represents an individual record. This design preserves the original FMP API format and provides better performance for large datasets.

• getCompanyProfilesBulk: Get bulk company profiles (CSV format)
• getStockRatingsBulk: Get bulk stock ratings (CSV format)
• getDCFValuationsBulk: Get bulk DCF valuations (CSV format)
• getFinancialScoresBulk: Get bulk financial scores (CSV format)
• getPriceTargetSummariesBulk: Get bulk price target summaries (CSV format)
• getUpgradesDowngradesConsensusBulk: Get bulk upgrades/downgrades consensus (CSV format)
• getKeyMetricsTTMBulk: Get bulk key metrics TTM (CSV format)
• getRatiosTTMBulk: Get bulk ratios TTM (CSV format)
• getStockPeersBulk: Get bulk stock peers (CSV format)
• getEODDataBulk: Get bulk end-of-day price data (CSV format)
• getIncomeStatementsBulk: Get bulk income statements (CSV format)
• getIncomeStatementGrowthBulk: Get bulk income statement growth data (CSV format)
• getBalanceSheetStatementsBulk: Get bulk balance sheet statements (CSV format)
• getBalanceSheetGrowthBulk: Get bulk balance sheet growth data (CSV format)
• getCashFlowStatementsBulk: Get bulk cash flow statements (CSV format)
• getCashFlowGrowthBulk: Get bulk cash flow growth data (CSV format)
• getFinancialRatiosBulk: Get bulk financial ratios (CSV format)
• getKeyMetricsBulk: Get bulk key metrics (CSV format)
• getFinancialGrowthBulk: Get bulk financial growth data (CSV format)

🔧 Technical Details

This MCP server uses a stateful session-based architecture powered by the Smithery SDK. Key features include client-level caching, session isolation, stateful management, mode enforcement, an HTTP-based protocol, and dynamic tool management. The request flow involves client requests, session management, mode resolution, tool registration, request processing, and response.

Obtaining a Financial Modeling Prep Access Token

To get a Financial Modeling Prep access token:

1. Visit the Financial Modeling Prep website
2. Click on "Sign Up" to create an account
3. Verify your email address
4. After signing in