yfinance-mcp-server

What is yfinance-mcp-server?

yfinance-mcp-server is an unofficial Message Control Protocol (MCP) server that provides a simple interface to retrieve stock market data from Yahoo Finance. It is built with TypeScript and intended for use with any MCP client to fetch historical stock data for given symbols.

How to use yfinance-mcp-server?

Install and run using npx @onori/yfinance-mcp-server. Configure your MCP client (e.g., Cursor) with the command and arguments shown above. The server exposes one tool, getStockHistory, which requires a symbol (e.g., "AAPL") and a period (e.g., "1d", "1mo", "1y"), with an optional interval ("1d", "1wk", "1mo").

Key features of yfinance-mcp-server

• Get historical stock data with customizable periods and intervals.
• Easy to use with any MCP client.
• Built with TypeScript for type safety.
• Single tool for retrieving stock history.
• Supports common stock symbols via Yahoo Finance.

Use cases of yfinance-mcp-server

• Fetch daily stock prices for a given symbol over the past week.
• Retrieve monthly historical data for portfolio analysis.
• Obtain stock data to render as formatted markdown tables in MCP clients.

FAQ from yfinance-mcp-server

What data does yfinance-mcp-server provide?

It provides historical stock data including Date, Open, High, Low, Close, and Volume for a given symbol and period.

How do I configure yfinance-mcp-server with my MCP client?

Add the following to your MCP client configuration: "command": "npx", "args": ["@onori/yfinance-mcp-server"].

What are the runtime requirements?

You need Node.js and npx installed. The server runs as a command-line tool and fetches data from Yahoo Finance.

Is yfinance-mcp-server an official Yahoo Finance product?

No, it is an unofficial MCP server and not affiliated with Yahoo Finance.

What parameters does the getStockHistory tool accept?

It requires symbol (string) and period (string, e.g., "1d", "1mo", "1y") and optionally interval ("1d", "1wk", "1mo").