Skip to main content
Glama

Yahoo Finance MCP Server

by 16Coffee
MIT License
  • Apple

MseeP.ai Security Assessment Badge

Financial Modeling Prep MCP Server

This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Financial Modeling Prep. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options data, and market news.

smithery badge

Demo

MCP Demo

MCP Tools

The server exposes the following tools through the Model Context Protocol:

Stock Information

Tool

Description

get_historical_stock_prices

Get historical OHLCV data for a stock with customizable period and interval

get_stock_info

Get comprehensive stock data including price, metrics, and company details

get_news_sentiment

Get latest news articles for a stock

get_stock_actions

Get stock dividends and splits history

Financial Statements

Tool

Description

get_financial_statement

Get income statement, balance sheet, or cash flow statement (annual/quarterly) using Financial Modeling Prep

Options Data

Tool

Description

get_option_expiration_dates

Get available options expiration dates

get_option_chain

Get options chain for a specific expiration date and type (calls/puts)

Stock Grades

Tool

Description

get_stock_grades

Get the latest analyst grades for a stock

get_stock_grades_historical

Get historical analyst grades

get_stock_grades_summary

Get a consensus summary of analyst grades

get_stock_grade_news

Get grade-related news for a stock

get_stock_grade_latest_news

Get the most recent analyst grade news

get_analyst_estimates

Retrieve analyst financial estimates

get_ratings

Get ratings snapshot or history

get_price_target_info

Get price target summary, consensus or news

Reference Data

Tool

Description

lookup_identifier

Search by symbol, name, CIK, CUSIP or ISIN

get_directory_list

Retrieve exchange, sector and other lists

Corporate Events

Tool

Description

get_calendar_data

Get dividends, earnings, IPO and split calendars

get_shares_float_info

Retrieve float data for one or all companies

get_ma_data

Get latest or search M&A transactions

get_executive_info

Fetch company executives or compensation info

get_dcf_valuation

Obtain DCF or levered DCF valuation

get_economic_data

Retrieve treasury rates and other macro data

Cryptocurrency Data

Tool

Description

get_crypto_list

Retrieve the list of tradable cryptocurrencies

get_crypto_quote

Get complete quote data for a cryptocurrency

get_crypto_quote_short

Get quick quote data for a cryptocurrency

get_all_crypto_quotes

Get real-time quotes for all cryptocurrencies

get_crypto_price_eod

Get historical cryptocurrency EOD prices in light or full mode

get_crypto_intraday

Get intraday cryptocurrency data by 1min, 5min or 1hour interval

get_crypto_news

Search cryptocurrency-related news

get_crypto_latest_news

Retrieve the latest cryptocurrency news

Real-World Use Cases

With this MCP server, you can use Claude to:

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."

Requirements

  • Python 3.11 or higher

  • Dependencies as listed in pyproject.toml, including:

    • mcp

    • requests

    • pandas

    • pydantic

    • and other packages for data processing

Setup

  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

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" ] } } }
    • 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

MIT

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server providing comprehensive financial data from Yahoo Finance, allowing users to retrieve detailed stock information, financial statements, options data, and market news.

  1. Demo
    1. MCP Tools
      1. Stock Information
      2. Financial Statements
      3. Options Data
      4. Stock Grades
      5. Reference Data
      6. Corporate Events
      7. Cryptocurrency Data
    2. Real-World Use Cases
      1. Stock Analysis
      2. Market Research
      3. Investment Research
    3. Requirements
      1. Setup
        1. Usage
          1. Development Mode
          2. Integration with Claude for Desktop
        2. License

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
            Last updated -
            20
            MIT License
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that enables interaction with Yahoo Finance to retrieve stock pricing, company information, and historical financial data through natural language queries.
            Last updated -
            10
            15
            MIT License
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides tools for interacting with Yahoo Finance, allowing users to retrieve stock prices, company information, and perform financial data comparisons.
            Last updated -
            11
            MIT License
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server built with FastMCP that provides financial data tools for AI agents, enabling them to access and analyze stock market information from Yahoo Finance through natural language queries.
            Last updated -
            2

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/16Coffee/finance-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server