{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"smithery_ale-ishizawa-yfinance-mcp-server","slug":"ale-ishizawa-yfinance-mcp-server","name":"yfinance-mcp-server","type":"mcp","url":"https://github.com/ale-ishizawa/yfinance-mcp-server","page_url":"https://unfragile.ai/ale-ishizawa-yfinance-mcp-server","categories":["mcp-servers"],"tags":["mcp","model-context-protocol","smithery:ale-ishizawa/yfinance-mcp-server"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_0","uri":"capability://tool.use.integration.real.time.stock.price.retrieval.via.mcp.protocol","name":"real-time stock price retrieval via mcp protocol","description":"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.","intents":["I want Claude to look up the current price of a stock ticker in real-time during conversation","I need to build an agent that can fetch stock data without making direct API calls","I want to integrate financial data queries into my MCP-compatible application"],"best_for":["AI developers building financial analysis agents with Claude","Teams integrating stock market data into MCP-based workflows","Solo developers prototyping investment research tools"],"limitations":["yfinance relies on web scraping Yahoo Finance, which can be rate-limited or break if Yahoo changes HTML structure","No built-in caching — repeated queries for the same ticker incur network latency","Historical data depth depends on yfinance's data source availability, typically 20+ years but not guaranteed for all tickers","Real-time data is delayed by 15-20 minutes for free tier (Yahoo Finance limitation, not MCP server limitation)"],"requires":["Python 3.8+","yfinance library installed","MCP client compatible with tool-calling (Claude, or custom MCP client)","Network access to Yahoo Finance or yfinance data source"],"input_types":["text (ticker symbol, e.g., 'AAPL')","text (date range specification for historical queries)"],"output_types":["structured JSON (price, volume, market cap, dividend yield)","time-series data (OHLCV: open, high, low, close, volume)"],"categories":["tool-use-integration","data-processing-analysis","financial-data"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_1","uri":"capability://data.processing.analysis.historical.stock.data.aggregation.and.time.series.export","name":"historical stock data aggregation and time-series export","description":"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.","intents":["I need to fetch 5 years of daily stock data for backtesting a trading strategy","I want to analyze historical volatility and price trends for a stock","I need to export stock data in a format compatible with my analysis pipeline"],"best_for":["Quantitative analysts building backtesting systems","Financial researchers analyzing historical price patterns","MCP agents performing multi-step financial analysis workflows"],"limitations":["yfinance data quality varies by ticker and historical period; some delisted or penny stocks have incomplete data","Large date ranges (10+ years) may timeout or return incomplete data depending on yfinance source stability","No built-in data validation or anomaly detection — garbage in, garbage out if source data is corrupted","Aggregation happens in-memory; very large datasets (e.g., minute-level data for 10 years) may exceed memory limits"],"requires":["Python 3.8+","yfinance library with pandas dependency","MCP server instance running","Valid ticker symbol (NYSE, NASDAQ, or other yfinance-supported exchange)"],"input_types":["text (ticker symbol)","text (start date, ISO 8601 format)","text (end date, ISO 8601 format)","text (period: '1d', '1wk', '1mo')"],"output_types":["JSON array of OHLCV records","CSV-formatted text","pandas DataFrame serialized to JSON"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_2","uri":"capability://data.processing.analysis.company.fundamentals.and.metadata.retrieval","name":"company fundamentals and metadata retrieval","description":"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.","intents":["I want Claude to tell me the market cap and P/E ratio of a company during analysis","I need to filter stocks by sector or industry programmatically","I want to check a company's dividend yield and payout history"],"best_for":["Investment research agents analyzing company fundamentals","Portfolio analysis tools comparing metrics across multiple stocks","Financial education chatbots explaining company metrics"],"limitations":["Fundamental data freshness depends on yfinance's update frequency; some metrics may be delayed by hours or days","Not all tickers have complete fundamental data; international or delisted companies may have sparse fields","yfinance's info dictionary structure is inconsistent across tickers — some fields may be missing or null","No real-time updates within a session — metadata is fetched once and cached, missing intraday changes"],"requires":["Python 3.8+","yfinance library","MCP server instance","Valid ticker symbol with available fundamental data on Yahoo Finance"],"input_types":["text (ticker symbol)"],"output_types":["JSON object with company metadata (name, sector, industry, market cap, P/E, dividend yield, etc.)","text (formatted company description)"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_3","uri":"capability://data.processing.analysis.dividend.and.earnings.history.lookup","name":"dividend and earnings history lookup","description":"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.","intents":["I want to see the dividend payment history for a stock to assess income potential","I need to find upcoming earnings dates for a company","I want to analyze dividend growth trends over time"],"best_for":["Income-focused investors analyzing dividend stocks","Financial agents building dividend portfolio analysis tools","Earnings calendar applications"],"limitations":["Dividend data is only available for stocks that have paid dividends; many growth stocks return empty arrays","Earnings dates are historical only — yfinance does not provide forward-looking earnings calendar","Data accuracy depends on Yahoo Finance's corporate action records; splits and special dividends may be misclassified","No dividend adjustment for stock splits — raw dividend amounts may not be directly comparable across split events"],"requires":["Python 3.8+","yfinance library","MCP server instance","Ticker with dividend or earnings history"],"input_types":["text (ticker symbol)","text (optional: start date for filtering)"],"output_types":["JSON array of dividend records (date, amount)","JSON array of earnings dates","calculated metrics (dividend yield, payout frequency)"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_4","uri":"capability://data.processing.analysis.stock.split.and.corporate.action.history","name":"stock split and corporate action history","description":"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.","intents":["I need to understand how stock splits have affected a company's share count over time","I want to adjust historical prices for splits when analyzing long-term trends","I need to verify if a stock has undergone reverse splits or other corporate actions"],"best_for":["Quantitative analysts adjusting historical data for corporate actions","Financial research tools analyzing long-term price trends","Portfolio tracking systems handling split-adjusted returns"],"limitations":["yfinance's splits data is limited to stock splits; other corporate actions (mergers, spinoffs) are not captured","Historical split data may be incomplete for very old events (pre-2000s) or international stocks","No automatic price adjustment — clients must manually apply split ratios to historical prices","Reverse splits and special dividends may be conflated in yfinance's data source"],"requires":["Python 3.8+","yfinance library","MCP server instance","Ticker with split history"],"input_types":["text (ticker symbol)"],"output_types":["JSON array of split events (date, split ratio)","calculated adjusted share count"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_5","uri":"capability://tool.use.integration.multi.ticker.batch.data.retrieval.with.mcp.tool.composition","name":"multi-ticker batch data retrieval with mcp tool composition","description":"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.","intents":["I want to compare prices and fundamentals across a portfolio of 10 stocks in one query","I need to fetch data for an entire sector to analyze relative valuations","I want to build a watchlist comparison without making 20 separate API calls"],"best_for":["Portfolio analysis agents comparing multiple holdings","Sector analysis tools screening stocks by metrics","MCP clients with batch tool-calling support"],"limitations":["Batch performance depends on MCP client's tool-calling implementation; some clients execute sequentially, causing N×latency","No built-in rate limiting — rapid batch queries may trigger yfinance's rate limits or IP blocks","Error isolation is per-tool; if one ticker fails, the client must handle partial results","No transaction semantics — if some tickers succeed and others fail, results are inconsistent across the batch"],"requires":["Python 3.8+","yfinance library","MCP server instance","MCP client with tool-calling support (Claude, or custom MCP client)","Valid ticker symbols"],"input_types":["text array (list of ticker symbols)","text (optional: data type filter, e.g., 'price,fundamentals')"],"output_types":["JSON object with per-ticker data (nested structure)","CSV-formatted comparison table"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yfinance-mcp-server__cap_6","uri":"capability://tool.use.integration.mcp.protocol.compliance.and.tool.schema.generation","name":"mcp protocol compliance and tool schema generation","description":"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.","intents":["I want to use yfinance data in Claude without writing custom integration code","I need to expose yfinance as a standardized tool interface for multiple MCP clients","I want to build an agent that can dynamically discover available financial data tools"],"best_for":["AI developers integrating yfinance into Claude or other MCP clients","Teams standardizing on MCP for tool integration","Builders creating multi-tool agent systems"],"limitations":["MCP server must be running as a separate process; no in-process library mode","Tool discovery is static at server startup; adding new yfinance capabilities requires server restart","MCP protocol overhead adds ~50-100ms per tool call vs. direct library calls","Parameter validation is schema-based; complex yfinance parameters (e.g., custom date formats) may require normalization"],"requires":["Python 3.8+","MCP server library (e.g., mcp package)","yfinance library","MCP client compatible with tool-calling (Claude, or custom MCP client)","Network connectivity between client and MCP server"],"input_types":["MCP tool-calling requests (JSON-RPC format)"],"output_types":["MCP tool responses (JSON-RPC format)","tool schemas (JSON Schema format)"],"categories":["tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":26,"verified":false,"data_access_risk":"high","permissions":["Python 3.8+","yfinance library installed","MCP client compatible with tool-calling (Claude, or custom MCP client)","Network access to Yahoo Finance or yfinance data source","yfinance library with pandas dependency","MCP server instance running","Valid ticker symbol (NYSE, NASDAQ, or other yfinance-supported exchange)","yfinance library","MCP server instance","Valid ticker symbol with available fundamental data on Yahoo Finance"],"failure_modes":["yfinance relies on web scraping Yahoo Finance, which can be rate-limited or break if Yahoo changes HTML structure","No built-in caching — repeated queries for the same ticker incur network latency","Historical data depth depends on yfinance's data source availability, typically 20+ years but not guaranteed for all tickers","Real-time data is delayed by 15-20 minutes for free tier (Yahoo Finance limitation, not MCP server limitation)","yfinance data quality varies by ticker and historical period; some delisted or penny stocks have incomplete data","Large date ranges (10+ years) may timeout or return incomplete data depending on yfinance source stability","No built-in data validation or anomaly detection — garbage in, garbage out if source data is corrupted","Aggregation happens in-memory; very large datasets (e.g., minute-level data for 10 years) may exceed memory limits","Fundamental data freshness depends on yfinance's update frequency; some metrics may be delayed by hours or days","Not all tickers have complete fundamental data; international or delisted companies may have sparse fields","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.24,"ecosystem":0.48999999999999994,"match_graph":0.25,"freshness":0.5,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-05-24T12:16:25.635Z","last_scraped_at":"2026-05-03T15:19:06.728Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=ale-ishizawa-yfinance-mcp-server","compare_url":"https://unfragile.ai/compare?artifact=ale-ishizawa-yfinance-mcp-server"}},"signature":"sqpuj/2f/Amh154hXDlzufEXihsPedMZ8rWSsYJpgCXwNR305hdoVGvbQlbtUjUFfbN7G7q2wiGd2gPibpz4Dw==","signedAt":"2026-06-21T11:38:24.311Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/ale-ishizawa-yfinance-mcp-server","artifact":"https://unfragile.ai/ale-ishizawa-yfinance-mcp-server","verify":"https://unfragile.ai/api/v1/verify?slug=ale-ishizawa-yfinance-mcp-server","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}