Financial Modeling Prep MCP (Model Context Protocol)

SSE

by imbenrabi

139 2.9k downloads Not rated yet Apache-2.0

GitHub Website

Finance
AI

About

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.

Details

Transport: SSE
License: Apache-2.0

Explore

- 250+ Financial Tools across 24 categories — stocks, ETFs, crypto, forex, commodities, economics, and more
- Dynamic Tool Management — built on toolception for runtime enable/disable of toolsets via meta-tools
- Three Server Modes — Dynamic (meta-tools), Static (pre-loaded toolsets), or All Tools (default)
- Flexible Deployment — use the hosted instance or self-host via npm, Docker, or source
- HTTP/SSE Transport — compatible with Claude.ai, Claude Desktop, and MCP registries

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Financial Modeling Prep MCP (Model Context Protocol)

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

From the repository

Prerequisites: Node.js 25.3.0 or higher (for v2.6.0+). For older versions (v2.5.x and below), Node.js 20+ is required.

Choose the method that fits your workflow:

- NPM — npm install -g financial-modeling-prep-mcp-server
- Docker — build from source or pull a pre-built image
- Source — clone and run with npm install && npm run build

See docs/INSTALLATION.md for detailed steps per method.

`searchSymbol`

Easily find the ticker symbol of any stock with the FMP Stock Symbol Search API. Search by company name or symbol across multiple global markets.

`searchName`

Search for ticker symbols, company names, and exchange details for equity securities and ETFs listed on various exchanges with the FMP Name Search API. This endpoint is useful for retrieving ticker symbols when you know the full or partial company or asset name but not the symbol identifier.

`searchCIK`

Easily retrieve the Central Index Key (CIK) for publicly traded companies with the FMP CIK API. Access unique identifiers needed for SEC filings and regulatory documents for a streamlined compliance and financial analysis process.

`searchCUSIP`

Easily search and retrieve financial securities information by CUSIP number using the FMP CUSIP API. Find key details such as company name, stock symbol, and market capitalization associated with the CUSIP.

`searchISIN`

Easily search and retrieve the International Securities Identification Number (ISIN) for financial securities using the FMP ISIN API. Find key details such as company name, stock symbol, and market capitalization associated with the ISIN.

`stockScreener`

Discover stocks that align with your investment strategy using the FMP Stock Screener API. Filter stocks based on market cap, price, volume, beta, sector, country, and more to identify the best opportunities.

`searchExchangeVariants`

Search across multiple public exchanges to find where a given stock symbol is listed using the FMP Exchange Variants API. This allows users to quickly identify all the exchanges where a security is actively traded.

`getCompanySymbols`

Easily retrieve a comprehensive list of financial symbols with the FMP Company Symbols List API. Access a broad range of stock symbols and other tradable financial instruments from various global exchanges, helping you explore the full range of available securities.

`getFinancialStatementSymbols`

Access a comprehensive list of companies with available financial statements through the FMP Financial Statement Symbols List API. Find companies listed on major global exchanges and obtain up-to-date financial data including income statements, balance sheets, and cash flow statements, are provided.

`getCIKList`

Access a comprehensive database of CIK (Central Index Key) numbers for SEC-registered entities with the FMP CIK List API. This endpoint is essential for businesses, financial professionals, and individuals who need quick access to CIK numbers for regulatory compliance, financial transactions, and investment research.

`getSymbolChanges`

Stay informed about the latest stock symbol changes with the FMP Stock Symbol Changes API. Track changes due to mergers, acquisitions, stock splits, and name changes to ensure accurate trading and analysis.

`getETFList`

Quickly find ticker symbols and company names for Exchange Traded Funds (ETFs) using the FMP ETF Symbol Search API. This tool simplifies identifying specific ETFs by their name or ticker.

`getActivelyTradingList`

List all actively trading companies and financial instruments with the FMP Actively Trading List API. This endpoint allows users to filter and display securities that are currently being traded on public exchanges, ensuring you access real-time market activity.

`getEarningsTranscriptList`

Access available earnings transcripts for companies with the FMP Earnings Transcript List API. Retrieve a list of companies with earnings transcripts, along with the total number of transcripts available for each company.

`getAvailableExchanges`

Access a complete list of supported stock exchanges using the FMP Available Exchanges API. This API provides a comprehensive overview of global stock exchanges, allowing users to identify where securities are traded and filter data by specific exchanges for further analysis.

`getAvailableSectors`

Access a complete list of industry sectors using the FMP Available Sectors API. This API helps users categorize and filter companies based on their respective sectors, enabling deeper analysis and more focused queries across different industries.

`getAvailableIndustries`

Access a comprehensive list of industries where stock symbols are available using the FMP Available Industries API. This API helps users filter and categorize companies based on their industry for more focused research and analysis.

`getAvailableCountries`

Access a comprehensive list of countries where stock symbols are available with the FMP Available Countries API. This API enables users to filter and analyze stock symbols based on the country of origin or the primary market where the securities are traded.

`getAnalystEstimates`

Retrieve analyst financial estimates for stock symbols with the FMP Financial Estimates API. Access projected figures like revenue, earnings per share (EPS), and other key financial metrics as forecasted by industry analysts to inform your investment decisions.

`getRatingsSnapshot`

Quickly assess the financial health and performance of companies with the FMP Ratings Snapshot API. This API provides a comprehensive snapshot of financial ratings for stock symbols in our database, based on various key financial ratios.

`getHistoricalRatings`

Track changes in financial performance over time with the FMP Historical Ratings API. This API provides access to historical financial ratings for stock symbols in our database, allowing users to view ratings and key financial metric scores for specific dates.

`getPriceTargetSummary`

Gain insights into analysts' expectations for stock prices with the FMP Price Target Summary API. This API provides access to average price targets from analysts across various timeframes, helping investors assess future stock performance based on expert opinions.

`getPriceTargetConsensus`

Access analysts' consensus price targets with the FMP Price Target Consensus API. This API provides high, low, median, and consensus price targets for stocks, offering investors a comprehensive view of market expectations for future stock prices.

`getPriceTargetNews`

Stay informed with real-time updates on analysts' price targets for stocks using the FMP Price Target News API. Access the latest forecasts, stock prices at the time of the update, and direct links to trusted news sources for deeper insights.

`getPriceTargetLatestNews`

Stay updated with the most recent analyst price target updates for all stock symbols using the FMP Price Target Latest News API. Get access to detailed forecasts, stock prices at the time of the update, analyst insights, and direct links to news sources for deeper analysis.

`getStockGrades`

Access the latest stock grades from top analysts and financial institutions with the FMP Grades API. Track grading actions, such as upgrades, downgrades, or maintained ratings, for specific stock symbols, providing valuable insight into how experts evaluate companies over time.

`getHistoricalStockGrades`

Access a comprehensive record of analyst grades with the FMP Historical Grades API. This tool allows you to track historical changes in analyst ratings for specific stock symbols.

`getStockGradeSummary`

Quickly access an overall view of analyst ratings with the FMP Grades Summary API. This API provides a consolidated summary of market sentiment for individual stock symbols, including the total number of strong buy, buy, hold, sell, and strong sell ratings. Understand the overall consensus on a stock’s outlook with just a few data points.

`getStockGradeNews`

Stay informed on the latest analyst grade changes with the FMP Grade News API. This API provides real-time updates on stock rating changes, including the grading company, previous and new grades, and the action taken. Direct links to trusted news sources and stock prices at the time of the update help you stay ahead of market trends and analyst opinions for specific stock symbols.

`getStockGradeLatestNews`

Stay informed on the latest stock rating changes with the FMP Grade Latest News API. This API provides the most recent updates on analyst ratings for all stock symbols, including links to the original news sources. Track stock price movements, grading firm actions, and market sentiment shifts in real time, sourced from trusted publishers.

`getDividends`

Stay informed about upcoming dividend payments with the FMP Dividends Company API. This API provides essential dividend data for individual stock symbols, including record dates, payment dates, declaration dates, and more.

`getDividendsCalendar`

Stay informed on upcoming dividend events with the Dividend Events Calendar API. Access a comprehensive schedule of dividend-related dates for all stocks, including record dates, payment dates, declaration dates, and dividend yields.

`getEarningsReports`

Retrieve in-depth earnings information with the FMP Earnings Report API. Gain access to key financial data for a specific stock symbol, including earnings report dates, EPS estimates, and revenue projections to help you stay on top of company performance.

`getEarningsCalendar`

Stay informed on upcoming and past earnings announcements with the FMP Earnings Calendar API. Access key data, including announcement dates, estimated earnings per share (EPS), and actual EPS for publicly traded companies.

`getIPOCalendar`

Access a comprehensive list of all upcoming initial public offerings (IPOs) with the FMP IPO Calendar API. Stay up to date on the latest companies entering the public market, with essential details on IPO dates, company names, expected pricing, and exchange listings.

`getIPODisclosures`

Access a comprehensive list of disclosure filings for upcoming initial public offerings (IPOs) with the FMP IPO Disclosures API. Stay updated on regulatory filings, including filing dates, effectiveness dates, CIK numbers, and form types, with direct links to official SEC documents.

`getIPOProspectuses`

Access comprehensive information on IPO prospectuses with the FMP IPO Prospectus API. Get key financial details, such as public offering prices, discounts, commissions, proceeds before expenses, and more. This API also provides links to official SEC prospectuses, helping investors stay informed on companies entering the public market.

`getStockSplits`

Access detailed information on stock splits for a specific company using the FMP Stock Split Details API. This API provides essential data, including the split date and the split ratio, helping users understand changes in a company's share structure after a stock split.

`getStockSplitCalendar`

Stay informed about upcoming stock splits with the FMP Stock Splits Calendar API. This API provides essential data on upcoming stock splits across multiple companies, including the split date and ratio, helping you track changes in share structures before they occur.

`getLightChart`

Access simplified stock chart data using the FMP Basic Stock Chart API. This API provides essential charting information, including date, price, and trading volume, making it ideal for tracking stock performance with minimal data and creating basic price and volume charts.

24 categories covering:

Search · Directory & Symbol Lists · Company Information · Financial Statements · Financial Metrics & Analysis · Technical Indicators · Quotes & Price Data · Market Indexes & Performance · Market Data · News & Press Releases · SEC Filings · Insider & Institutional Trading · ETFs & Funds · Government Trading · Cryptocurrency & Forex · Earnings · Special Data Sets · Commodities · Economics · Bulk Data Tools

See docs/API_REFERENCE.md for the complete tool catalog.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

McpServers

{
    "Financial-Modeling-Prep-MCP-Server": {
        "command": "npx",
        "args": [
            "financial-modeling-prep-mcp-server",
            "--fmp-token=YOUR_FMP_API_KEY"
        ]
    }
}

A Model Context Protocol (MCP) server for the Financial Modeling Prep API, exposing 250+ financial data tools to AI assistants.

Features

Quick Start

Hosted Instance (Fastest)

No installation required. Connect directly:

https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp

Provide your FMP_ACCESS_TOKEN in session configuration and start using 5 meta-tools to load toolsets on demand.

Self-Hosted (One-Liner)

npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY

Or install globally:

npm install -g financial-modeling-prep-mcp-server
fmp-mcp --fmp-token=YOUR_FMP_API_KEY

> Get your API key at financialmodelingprep.com.

- Installation
- Configuration
- Usage
- API Reference
- Registries
- Contributing
- License

Installation

Prerequisites: Node.js 25.3.0 or higher (for v2.6.0+). For older versions (v2.5.x and below), Node.js 20+ is required.

Choose the method that fits your workflow:

- NPM — npm install -g financial-modeling-prep-mcp-server
- Docker — build from source or pull a pre-built image
- Source — clone and run with npm install && npm run build

See docs/INSTALLATION.md for detailed steps per method.

Configuration

The server supports three operational modes controlled via CLI arguments, environment variables, or session configuration:

| Mode | How to Enable | Description |
|------|---------------|-------------|
| Dynamic | DYNAMIC_TOOL_DISCOVERY=true | Starts with 5 meta-tools; load toolsets at runtime |
| Static | FMP_TOOL_SETS=search,company | Pre-loads specified toolsets on session creation |
| All Tools (default) | (default) | Loads all 250+ tools immediately |

Precedence: CLI args > Environment variables > Session config > Defaults.

See docs/CONFIGURATION.md for the full configuration reference.

Usage

Connect to the server via HTTP/SSE transport:

- Claude.ai / Claude Desktop — add as a remote connector (Settings > Connectors)
- Custom clients — POST to /mcp with mcp-client-id header
- MCP registries — Smithery.ai, Glama.ai, and others

See docs/USAGE.md for client-specific setup, session headers, and request examples.

Available Tools

24 categories covering:

See docs/API_REFERENCE.md for the complete tool catalog.

Registries

This server is listed on multiple MCP registries for easy discovery:

- Smithery.ai
- Glama.ai

See docs/REGISTRIES.md for registry-specific setup instructions.

Contributing

Contributions are welcome. Please see CONTRIBUTING.md for development setup, testing, and pull request guidelines.

License

Apache-2.0

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

searchSymbol

searchName

searchCIK

searchCUSIP

searchISIN

stockScreener

searchExchangeVariants

getCompanySymbols

getFinancialStatementSymbols

getCIKList

getSymbolChanges

getETFList

getActivelyTradingList

getEarningsTranscriptList

getAvailableExchanges

getAvailableSectors

getAvailableIndustries

getAvailableCountries

getAnalystEstimates

getRatingsSnapshot

getHistoricalRatings

getPriceTargetSummary

getPriceTargetConsensus

getPriceTargetNews

getPriceTargetLatestNews

getStockGrades

getHistoricalStockGrades

getStockGradeSummary

getStockGradeNews

getStockGradeLatestNews

getDividends

getDividendsCalendar

getEarningsReports

getEarningsCalendar

getIPOCalendar

getIPODisclosures

getIPOProspectuses

getStockSplits

getStockSplitCalendar

getLightChart

Claude Desktop / Cursor

McpServers

Features

Quick Start

Hosted Instance (Fastest)

Self-Hosted (One-Liner)

Table of Contents

Installation

Configuration

Usage

Available Tools

Registries

Contributing

License

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

`searchSymbol`

`searchName`

`searchCIK`

`searchCUSIP`

`searchISIN`

`stockScreener`

`searchExchangeVariants`

`getCompanySymbols`

`getFinancialStatementSymbols`

`getCIKList`

`getSymbolChanges`

`getETFList`

`getActivelyTradingList`

`getEarningsTranscriptList`

`getAvailableExchanges`

`getAvailableSectors`

`getAvailableIndustries`

`getAvailableCountries`

`getAnalystEstimates`

`getRatingsSnapshot`

`getHistoricalRatings`

`getPriceTargetSummary`

`getPriceTargetConsensus`

`getPriceTargetNews`

`getPriceTargetLatestNews`

`getStockGrades`

`getHistoricalStockGrades`

`getStockGradeSummary`

`getStockGradeNews`

`getStockGradeLatestNews`

`getDividends`

`getDividendsCalendar`

`getEarningsReports`

`getEarningsCalendar`

`getIPOCalendar`

`getIPODisclosures`

`getIPOProspectuses`

`getStockSplits`

`getStockSplitCalendar`

`getLightChart`