Finance MCP

🚀 Financial Modeling Prep MCP Server

This is a Model Context Protocol (MCP) server that offers comprehensive financial data from Financial Modeling Prep. It enables users to retrieve detailed stock information, including historical prices, company details, financial statements, options data, and market news.

🚀 Quick Start

This MCP server provides access to a wealth of financial data. To get started, follow the steps in the "Setup" section below.

✨ Features

Demo

MCP Tools

The server exposes various tools through the Model Context Protocol, categorized as follows:

Stock Information

Financial Statements

Options Data

Stock Grades

Reference Data

Corporate Events

Cryptocurrency Data

Real-World Use Cases

With this MCP server, you can use Claude for the following purposes:

Stock Analysis

• Price Analysis: "Show me the historical stock prices for AAPL over the last 6 months with daily intervals."
• Financial Health: "Get the quarterly balance sheet for Microsoft."
• Performance Metrics: "What are the key financial metrics for Tesla from the stock info?"
• Trend Analysis: "Compare the quarterly income statements of Amazon and Google."
• Cash Flow Analysis: "Show me the annual cash flow statement for NVIDIA."

Market Research

• News Analysis: "Get the latest news articles about Meta Platforms."
• Market Movers: "List today's top gainers and losers."
• Options Analysis: "Get the options chain for SPY with expiration date 2024-06-21 for calls."

Investment Research

• "Create a comprehensive analysis of Microsoft's financial health using their latest quarterly financial statements."
• "Compare the dividend history and stock splits of Coca-Cola and PepsiCo."
• "Generate a report on the options market activity for Apple stock with expiration in 30 days."

📦 Installation

Requirements

• Python 3.11 or higher
• Dependencies as listed in pyproject.toml, including:
  • mcp
  • requests
  • pandas
  • pydantic
  • and other packages for data processing

Setup Steps

1. Clone this repository:

   git clone https://github.com/Alex2Yang97/financialmodelingprep-mcp.git
   cd financialmodelingprep-mcp
   

2. Create and activate a virtual environment and install dependencies:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   uv pip install -e .
   

3. Set your Financial Modeling Prep API key:

   export FMP_API_KEY=YOUR_API_KEY
   

💻 Usage Examples

Development Mode

You can test the server with MCP Inspector by running:

uv run server.py

This will start the server and allow you to test the available tools.

Integration with Claude for Desktop

To integrate this server with Claude for Desktop:

1. Install Claude for Desktop to your local machine.

2. Install VS Code to your local machine. Then run the following command to open the claude_desktop_config.json file:

   • MacOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: code $env:AppData\Claude\claude_desktop_config.json

3. Edit the Claude for Desktop config file, located at:

   • macOS:

     {
       "mcpServers": {
         "financialmodelingprep": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/financialmodelingprep-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • Windows:

     {
       "mcpServers": {
         "financialmodelingprep": {
           "command": "uv",
           "args": [
             "--directory",
             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\financialmodelingprep-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   ⚠️ Important Note

   You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.

4. Restart Claude for Desktop

📄 License

This project is licensed under the MIT license.