Yfinance MCP Server

Overview

The yfinance‑mcp-server is an unofficial Message Control Protocol (MCP) server that exposes Yahoo Finance data to AI assistants. It bridges the gap between conversational agents and real‑time market information, allowing developers to request stock prices, historical trends, and other financial metrics directly from within an AI workflow. By packaging the popular Python library behind a lightweight MCP interface, this server gives Claude and similar assistants instant access to a broad range of equities without requiring custom API keys or handling raw HTTP requests.

At its core, the server offers a single, well‑documented tool—. The tool accepts a stock symbol, a time period (e.g., “1d”, “5y”, “max”), and an optional interval (“1d”, “1wk”, “1mo”). It returns a structured dataset that can be rendered as Markdown tables, charts, or fed into downstream analysis routines. This simplicity lets developers focus on higher‑level logic: generating investment reports, building trading dashboards, or creating data‑driven narratives—all without wrestling with the intricacies of Yahoo’s API.

Key features include:

• TypeScript implementation for compile‑time safety and clear interface contracts.
• Customizable time frames that let clients fetch just the data they need, reducing bandwidth and latency.
• Interval flexibility (daily, weekly, monthly) which supports both high‑frequency traders and long‑term investors.
• Seamless integration with any MCP client, from the browser to command‑line tools.

Real‑world use cases span financial education platforms that generate lesson plans based on live market data, automated report generators for portfolio managers, and even chatbot assistants that answer “What was Apple’s closing price last Friday?” with instant precision. Because the server abstracts away authentication and data parsing, it can be dropped into existing AI pipelines with minimal friction.

What sets this MCP server apart is its focus on developer ergonomics. By wrapping in a TypeScript‑typed MCP interface, it eliminates the need for manual HTTP handling and provides a clear contract that AI assistants can invoke. The result is a plug‑and‑play component that enriches conversational agents with authoritative financial data, empowering developers to build smarter, data‑centric applications quickly.