Information
# Yahoo Finance MCP Server
A simple MCP server for Yahoo Finance using [yfinance](https://github.com/ranaroussi/yfinance). This server provides a set of tools to fetch stock data, news, and other financial information.
## Tools
- **get_ticker_info**
- Retrieve stock data including company info, financials, trading metrics and governance data.
- Inputs:
- \`symbol\` (string): The stock symbol.
- **get_ticker_news**
- Fetches recent news articles related to a specific stock symbol with title, content, and source details.
- Inputs:
- \`symbol\` (string): The stock symbol.
- **search**
- Fetches and organizes search results from Yahoo Finance, including stock quotes and news articles.
- Inputs:
- \`query\` (string): The search query (ticker symbol or company name).
- \`search_type\` (string): Type of search results to retrieve (options: "all", "quotes", "news").
- **get_top**
- Get top entities (ETFs, mutual funds, companies, growth companies, or performing companies) in a sector.
- Inputs:
- \`sector\` (string): The sector to get.
- \`top_type\` (string): Type of top companies to retrieve (options: "top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", "top_performing_companies").
- \`top_n\` (number, optional): Number of top entities to retrieve (default 10).
- **get_price_history**
- Fetch historical price data for a given stock symbol over a specified period and interval.
- Inputs:
- \`symbol\` (string): The stock symbol.
- \`period\` (string, optional): Time period to retrieve data for (e.g. '1d', '1mo', '1y'). Default is '1mo'.
- \`interval\` (string, optional): Data interval frequency (e.g. '1d', '1h', '1m'). Default is '1d'.
## Usage
You can use this MCP server either via uv (Python package installer) or Docker.
### Via uv
1. [Install uv](https://docs.astral.sh/uv/getting-started/installation/)
2. Add the following configuration to your MCP server configuration file:
\`\`\`json
\{
"mcpServers": \{
"yfmcp": \{
"command": "uvx",
"args": ["yfmcp@latest"]
\}
\}
\}
\`\`\`
### Via Docker
Add the following configuration to your MCP server configuration file:
\`\`\`json
\{
"mcpServers": \{
"yfmcp": \{
"command": "docker",
"args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
\}
\}
\}