yfinance-mcp-server
@onori
About yfinance-mcp-server
Unofficial MCP server for Yahoo Finance stock data.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"yfinance": {
"command": "npx",
"args": [
"@onori/yfinance-mcp-server"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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").
Frequently asked questions
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").
Basic information
More Finance & Commerce MCP servers
₿itcoin & Lightning Network MCP Server
AbdelStarkBitcoin & Lightning Network MCP Server.
Financial Datasets MCP Server
financial-datasetsAn MCP server for interacting with the Financial Datasets stock market API.
Velarion — Executive Compensation Intelligence
VelarionVelarion exposes deterministic executive-compensation and governance intelligence for ~3,000 US public companies as callable MCP tools — sourced from SEC proxy filings, not LLM guesses. Nine tools: look up CEO/NEO pay an
Polygon.io MCP Server
polygon-ioAn MCP server for Massive.com Financial Market Data
Synci
SynciSynci connects your real bank, brokerage, and crypto-exchange accounts to AI assistants, read-only. Ask about balances, transactions, holdings, and spending across all your accounts in one place.
Comments