get_stock_price_date_range
Retrieve historical stock prices for a specific symbol within a defined date range using YYYY-MM-DD format, enabling detailed financial analysis.
Instructions
Get the stock prices for a given date range for a given stock symbol.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | The end date in YYYY-MM-DD format. | |
| start_date | Yes | The start date in YYYY-MM-DD format. | |
| symbol | Yes | Stock symbol in Yahoo Finance format. |
Implementation Reference
- src/mcp_yahoo_finance/server.py:48-61 (handler)Core handler function implementing the tool logic: fetches historical stock data using yfinance for the given symbol and date range, serializes Close prices to JSON.def get_stock_price_date_range( self, symbol: str, start_date: str, end_date: str ) -> str: """Get the stock prices for a given date range for a given stock symbol. Args: symbol (str): Stock symbol in Yahoo Finance format. start_date (str): The start date in YYYY-MM-DD format. end_date (str): The end date in YYYY-MM-DD format. """ stock = Ticker(ticker=symbol, session=self.session) prices = stock.history(start=start_date, end=end_date) prices.index = prices.index.astype(str) return f"{prices['Close'].to_json(orient='index')}"
- src/mcp_yahoo_finance/server.py:220-235 (registration)Tool registration in the MCP server's list_tools handler, where generate_tool creates and registers the tool schema for get_stock_price_date_range.@server.list_tools() async def list_tools() -> list[Tool]: return [ generate_tool(yf.get_current_stock_price), generate_tool(yf.get_stock_price_by_date), generate_tool(yf.get_stock_price_date_range), generate_tool(yf.get_historical_stock_prices), generate_tool(yf.get_dividends), generate_tool(yf.get_income_statement), generate_tool(yf.get_cashflow), generate_tool(yf.get_earning_dates), generate_tool(yf.get_news), generate_tool(yf.get_recommendations), generate_tool(yf.get_option_expiration_dates), generate_tool(yf.get_option_chain), ]
- src/mcp_yahoo_finance/server.py:246-248 (registration)Dispatch logic in the MCP server's call_tool handler that invokes the get_stock_price_date_range method with parsed arguments.case "get_stock_price_date_range": price = yf.get_stock_price_date_range(**args) return [TextContent(type="text", text=price)]
- src/mcp_yahoo_finance/utils.py:31-66 (schema)Helper function that generates the inputSchema and Tool object from the handler's signature and docstring, used for schema definition of get_stock_price_date_range and all other tools.def generate_tool(func: Any) -> Tool: """Generates a tool schema from a Python function.""" signature = inspect.signature(func) docstring = inspect.getdoc(func) or "" param_descriptions = parse_docstring(docstring) schema = { "name": func.__name__, "description": docstring.split("Args:")[0].strip(), "inputSchema": { "type": "object", "properties": {}, }, } for param_name, param in signature.parameters.items(): param_type = ( "number" if param.annotation is float else "string" if param.annotation is str else "string" ) schema["inputSchema"]["properties"][param_name] = { "type": param_type, "description": param_descriptions.get(param_name, ""), } if "required" not in schema["inputSchema"]: schema["inputSchema"]["required"] = [param_name] else: if "=" not in str(param): schema["inputSchema"]["required"].append(param_name) return Tool(**schema)