Skip to main content
Glama
yfinance-mcp-server

yfinance-mcp-server

by onori

yfinance-mcp-server

日本語版

Important Note: This is an unofficial MCP server.

A Message Control Protocol (MCP) server for accessing Yahoo Finance data. This server provides a simple interface to retrieve stock market data through yfinance.

Features

  • Get historical stock data with customizable periods and intervals

  • Easy to use with any MCP client

  • Built with TypeScript for type safety and better developer experience

Related MCP server: Yahoo Finance MCP Server

Usage

Example Cursor MCP Client.

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": [
        "@onori/yfinance-mcp-server"
      ]
    }
  }
}

getStockHistory

Retrieves historical stock data for a given symbol.

Parameters:

  • symbol (required): The stock symbol (e.g., "AAPL" for Apple Inc.)

  • period (required): Time period to fetch data for (e.g., "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max")

  • interval (optional): Data interval ("1d", "1wk", "1mo")

Example MCP request:

> (Request) 
Please use the `getStockHistory` tool to fetch the daily stock data for AAPL for the past week (`period`='1w', `interval`='1d'). Then, render the results as a markdown table.

> (Response Example)
I'll help you fetch Apple's stock data and format it nicely as a markdown table.
First, I'll call the getStockHistory tool to fetch the data:

Let me format this data into a more readable markdown table:

| Date | Open | High | Low | Close | Volume |
|------|------|------|-----|-------|---------|
| Mar 31, 2025 | $217.01 | $225.62 | $216.23 | $222.13 | 65.30M |
| Apr 1, 2025 | $219.81 | $223.68 | $218.90 | $223.19 | 36.41M |
| Apr 2, 2025 | $221.32 | $225.19 | $221.02 | $223.89 | 35.91M |
| Apr 3, 2025 | $205.54 | $207.49 | $201.25 | $203.19 | 103.42M |
| Apr 4, 2025 | $193.89 | $199.88 | $187.34 | $188.38 | 125.57M |

Some notable observations from this data:
- The stock showed significant volatility over this period
- There was a sharp decline in the last two trading days
- Trading volume increased substantially during the declining days, with the highest volume (125.57M shares) on April 4th
- The stock price range was from a high of $225.62 to a low of $187.34 during this period
Would you like any specific analysis of this data or would you like to see different metrics?

Development

To set up the development environment:

  1. Clone the repository

  2. Install dependencies:

npm install
  1. Start the development server:

npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC License (ISC)

Available Tools

1 tool
getStockHistoryD

Inputs: symbol (required), period (required), interval.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of confusion between tools.

    Naming Consistency5/5

    A single tool trivially follows its own naming pattern (camelCase verb_noun).

    Tool Count2/5

    A single tool for a finance data server is far too few; expected at least 3-15 tools for basic coverage.

    Completeness1/5

    The tool surface is severely incomplete for stock market data, lacking any other essential operations (e.g., current price, dividends, financials).

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Provides financial data from Yahoo Finance via MCP, enabling AI agents to access real-time stock info, historical prices, financial statements, and market analysis.
      10
      14
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables querying stock data, financial information, news, and historical prices from Yahoo Finance through a set of MCP tools.
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server that exposes Yahoo Finance data through tools for searching instruments, fetching quotes, history, company info, financials, dividends, news, recommendations, and options. Enables AI assistants to answer market-data questions using natural language.
      24
      726 PyPI
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time quotes, historical OHLCV data, options chains, news, and multi-ticker comparisons to any MCP client via Yahoo Finance.
      MIT