Yahoo Finance MCP Server

1# Yahoo Finance MCP Server
2 
3A 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.
4 
5<a href="https://glama.ai/mcp/servers/@narumiruna/yfinance-mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@narumiruna/yfinance-mcp/badge" />
7</a>
8 
9## Tools
10 
11- **yfinance_get_ticker_info**
12 
13  - Retrieve stock data including company info, financials, trading metrics and governance data.
14  - Inputs:
15    - `symbol` (string): The stock symbol.
16 
17- **yfinance_get_ticker_news**
18 
19  - Fetches recent news articles related to a specific stock symbol with title, content, and source details.
20  - Inputs:
21    - `symbol` (string): The stock symbol.
22 
23- **yfinance_search**
24 
25  - Fetches and organizes search results from Yahoo Finance, including stock quotes and news articles.
26  - Inputs:
27    - `query` (string): The search query (ticker symbol or company name).
28    - `search_type` (string): Type of search results to retrieve (options: "all", "quotes", "news").
29 
30- **yfinance_get_top**
31 
32  - Get top entities (ETFs, mutual funds, companies, growth companies, or performing companies) in a sector.
33  - Inputs:
34    - `sector` (string): The sector to get.
35    - `top_type` (string): Type of top companies to retrieve (options: "top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", "top_performing_companies").
36    - `top_n` (number, optional): Number of top entities to retrieve (default 10).
37 
38- **yfinance_get_price_history**
39 
40  - Fetch historical price data for a given stock symbol over a specified period and interval. Can return data as a markdown table or generate professional financial charts using mplfinance, including candlestick charts with volume bars, VWAP overlays, and volume profile analysis.
41  - Inputs:
42    - `symbol` (string): The stock symbol.
43    - `period` (string, optional): Time period to retrieve data for (e.g. '1d', '1mo', '1y'). Default is '1mo'.
44    - `interval` (string, optional): Data interval frequency (e.g. '1d', '1h', '1m'). Default is '1d'.
45    - `chart_type` (string, optional): Type of chart to generate. If not specified, returns price data as markdown table. Options:
46      - "price_volume": Candlestick chart with volume bars
47      - "vwap": Volume Weighted Average Price chart with VWAP overlay
48      - "volume_profile": Candlestick chart with volume profile showing volume distribution by price level (displayed as a histogram on the right side)
49  - Output:
50    - If `chart_type` is not specified: Returns historical price data as a markdown table
51    - If `chart_type` is specified: Returns a base64-encoded WebP image for efficient token usage
52 
53## Usage
54 
55You can use this MCP server via uv (Python package installer), Docker, or local development.
56 
57### Via uv
58 
591. [Install uv](https://docs.astral.sh/uv/getting-started/installation/)
602. Add the following configuration to your MCP server configuration file:
61 
62```json
63{
64  "mcpServers": {
65    "yfmcp": {
66      "command": "uvx",
67      "args": ["yfmcp@latest"]
68    }
69  }
70}
71```
72 
73### Via Docker
74 
75Add the following configuration to your MCP server configuration file:
76 
77```json
78{
79  "mcpServers": {
80    "yfmcp": {
81      "command": "docker",
82      "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
83    }
84  }
85}
86```
87 
88### Local Development
89 
90For local development, add the following configuration to your MCP server configuration file:
91 
92```json
93{
94  "mcpServers": {
95    "yfmcp": {
96      "command": "uv",
97      "args": [
98        "run",
99        "--directory",
100        "/path/to/yfinance-mcp",
101        "yfmcp"
102      ]
103    }
104  }
105}
106```
107 
108Replace `/path/to/yfinance-mcp` with the actual path to your local repository.
109 
110## Demo Chatbot
111 
112This repository includes a demo chatbot built with [Chainlit](https://github.com/Chainlit/chainlit) that provides a conversational interface to the Yahoo Finance MCP server.
113 
114### Features
115 
116- Interactive chat interface for querying stock information
117- Automatic display of financial charts and data visualizations
118- Support for both OpenAI and LiteLLM backends
119- Tool calling integration with the MCP server
120 
121### Setup
122 
1231. Install demo dependencies:
124 
125```bash
126uv sync --extra dev
127```
128 
1292. Configure environment variables:
130 
131```bash
132# Recommended: start from the template
133cp .env.example .env
134 
135# For OpenAI
136OPENAI_API_KEY=your_openai_api_key
137DEFAULT_MODEL=gpt-4.1
138 
139# For LiteLLM (alternative)
140LITELLM_API_KEY=your_litellm_api_key
141LITELLM_BASE_URL=your_litellm_base_url
142DEFAULT_MODEL=gpt-4.1
143```
144 
1453. Run the demo:
146 
147```bash
148uv run chainlit run demo.py
149```
150 
151The chatbot will be available at `http://localhost:8000`.
152 
153### Example Queries
154 
155- "Get AAPL stock information"
156- "Show me recent TSLA news"
157- "Display NVDA price history for the past month"
158- "Show me a candlestick chart for MSFT over the last 3 months"
159