real-time stock price retrieval via mcp protocol
Exposes yfinance's stock ticker data fetching through MCP server tools, allowing Claude and other MCP clients to query current and historical stock prices by ticker symbol. Implements MCP tool schema binding that translates natural language requests into yfinance API calls, handling ticker validation and price data serialization back to the client as structured JSON responses.
Unique: Bridges yfinance (Python financial data library) directly into MCP protocol as callable tools, eliminating the need for custom REST API wrappers or direct library imports in client code. Uses MCP's tool schema system to expose yfinance methods as first-class client capabilities.
vs alternatives: Simpler than building a custom REST API wrapper around yfinance; tighter integration with Claude and MCP ecosystem than calling yfinance directly from Python scripts
historical stock data aggregation and time-series export
Retrieves multi-period historical OHLCV (open, high, low, close, volume) data for a given ticker and date range, aggregating yfinance responses into structured time-series format. Handles date range validation, period granularity selection (daily, weekly, monthly), and formats output as JSON arrays or CSV-compatible structures suitable for analysis or downstream processing.
Unique: Exposes yfinance's period-based data fetching (daily, weekly, monthly) as MCP tools with automatic date range validation and format conversion, allowing clients to request historical data without managing yfinance's pandas DataFrame output directly.
vs alternatives: More flexible than static data exports; allows dynamic date range queries within MCP conversations vs. pre-computed CSV files
company fundamentals and metadata retrieval
Fetches company-level metadata and fundamental metrics (market cap, P/E ratio, dividend yield, sector, industry, 52-week high/low) from yfinance's Ticker object, exposing these as MCP tools. Implements lazy-loading of ticker info to minimize network requests, caching metadata within a single MCP session, and serializing complex objects (e.g., company info dictionaries) into JSON-safe formats.
Unique: Wraps yfinance's Ticker.info dictionary (which returns inconsistent, nested JSON) into a normalized MCP tool schema with optional field filtering, allowing clients to request specific fundamentals without handling yfinance's raw data structure.
vs alternatives: Simpler than parsing yfinance's raw info dict in client code; more complete than REST APIs that only expose price data
dividend and earnings history lookup
Retrieves historical dividend payments and earnings dates for a ticker using yfinance's dividends and earnings attributes, formatting them as time-indexed JSON arrays. Handles missing data gracefully (some tickers have no dividend history), validates date ranges, and provides both raw dividend amounts and calculated metrics like dividend yield and payout frequency.
Unique: Exposes yfinance's dividends and earnings Series objects as queryable MCP tools with automatic date filtering and yield calculation, avoiding the need for clients to manipulate pandas Series directly.
vs alternatives: More accessible than raw yfinance API for dividend queries; integrated into MCP workflow vs. separate dividend data source
stock split and corporate action history
Retrieves historical stock splits and corporate actions (reverse splits, mergers, spinoffs) from yfinance's splits attribute, providing adjusted share counts and split ratios. Implements date-indexed lookup allowing clients to understand historical share count changes and their impact on price comparisons across split events.
Unique: Surfaces yfinance's splits Series as a queryable MCP tool with automatic ratio calculation and date indexing, enabling agents to understand and adjust for historical corporate actions without manual data wrangling.
vs alternatives: More transparent than pre-adjusted price data; integrated into MCP workflow vs. requiring external corporate action databases
multi-ticker batch data retrieval with mcp tool composition
Enables MCP clients to request data for multiple tickers in a single logical operation by composing individual ticker tools into batch queries, handling parallel or sequential fetching depending on MCP client implementation. Implements error handling per ticker (one failure doesn't block others) and aggregates results into a unified response structure suitable for comparative analysis.
Unique: Leverages MCP's tool-calling protocol to enable batch queries without implementing a custom batch endpoint; clients compose multiple ticker tools into a single logical batch operation, with error handling per ticker.
vs alternatives: More flexible than a single batch endpoint; allows clients to mix and match tools (price, fundamentals, dividends) per ticker without predefined batch schemas
mcp protocol compliance and tool schema generation
Implements the Model Context Protocol (MCP) server specification, automatically generating tool schemas for all yfinance capabilities and exposing them via MCP's tool-calling interface. Handles MCP request/response serialization, tool discovery, and parameter validation according to MCP spec, allowing any MCP-compatible client (Claude, custom agents) to discover and invoke yfinance tools without prior knowledge of their signatures.
Unique: Implements full MCP server specification with automatic tool schema generation from yfinance methods, enabling zero-configuration integration with MCP clients; uses MCP's standardized tool discovery and invocation protocol rather than custom REST or gRPC APIs.
vs alternatives: More standardized than custom REST wrappers; tighter integration with Claude and MCP ecosystem than direct yfinance imports