{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"smithery_ale-ishizawa-yahoo-finance-mcp","slug":"ale-ishizawa-yahoo-finance-mcp","name":"yahoo-finance-mcp","type":"mcp","url":"https://github.com/ale-ishizawa/yahoo-finance-mcp","page_url":"https://unfragile.ai/ale-ishizawa-yahoo-finance-mcp","categories":["mcp-servers"],"tags":["mcp","model-context-protocol","smithery:ale-ishizawa/yahoo-finance-mcp"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_0","uri":"capability://tool.use.integration.real.time.stock.quote.retrieval.via.mcp.protocol","name":"real-time stock quote retrieval via mcp protocol","description":"Fetches current stock prices, bid-ask spreads, and market data from Yahoo Finance API through the Model Context Protocol, enabling LLM agents to query live market data without direct API integration. Implements MCP tool schema binding to expose Yahoo Finance endpoints as callable functions that Claude or other MCP-compatible models can invoke with ticker symbols as parameters.","intents":["Get the current price of a stock ticker to include in an LLM response","Retrieve bid-ask spreads and volume data for a security within an agent workflow","Enable an AI assistant to answer real-time financial questions without hallucinating prices"],"best_for":["AI agents and LLM applications needing live financial data","Teams building financial chatbots or investment analysis tools","Developers integrating Claude with real-time market information"],"limitations":["Dependent on Yahoo Finance API availability and rate limits (typically 2000 requests/hour per IP)","Data latency matches Yahoo Finance backend (typically 15-20 minute delay for free tier)","No built-in caching — repeated queries for same ticker incur repeated API calls","Limited to securities available on Yahoo Finance (excludes some international exchanges)"],"requires":["MCP client implementation (Claude Desktop, custom MCP runner, or compatible LLM framework)","Network access to Yahoo Finance API endpoints","Node.js runtime or equivalent for running the MCP server process"],"input_types":["ticker symbol (string, e.g., 'AAPL', 'BTC-USD')","optional parameters for data granularity"],"output_types":["structured JSON with price, bid, ask, volume, market cap","timestamp of last quote update"],"categories":["tool-use-integration","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_1","uri":"capability://tool.use.integration.historical.stock.price.data.retrieval.with.date.range.filtering","name":"historical stock price data retrieval with date range filtering","description":"Queries Yahoo Finance historical price data (OHLCV: open, high, low, close, volume) for a given ticker and date range, returning time-series data suitable for technical analysis or backtesting. Implements date parameter validation and pagination to handle large datasets, exposing the data through MCP tool interface for agent-driven historical analysis workflows.","intents":["Retrieve 1-year or 5-year historical price data for a stock to analyze trends","Get OHLCV data for a specific date range to backtest a trading strategy","Fetch historical dividends or stock splits for a security"],"best_for":["Financial analysis agents that need historical context for decision-making","Backtesting frameworks integrated with LLM-driven strategy development","Educational tools teaching technical analysis with real market data"],"limitations":["Historical data completeness depends on Yahoo Finance coverage (some delisted securities unavailable)","Free tier may have rate limits on large historical queries (e.g., 10+ years of daily data)","No intraday data for most free tier access (daily granularity only)","Adjusted close prices may differ from other data providers due to adjustment methodology"],"requires":["MCP client with support for parameterized tool calls","Ticker symbol and valid start/end date parameters (ISO 8601 format recommended)","Network connectivity to Yahoo Finance API"],"input_types":["ticker symbol (string)","start date (ISO 8601 or Unix timestamp)","end date (ISO 8601 or Unix timestamp)","optional interval parameter (daily, weekly, monthly)"],"output_types":["array of OHLCV candles with timestamps","structured JSON with price history and volume data"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_2","uri":"capability://tool.use.integration.company.fundamentals.and.financial.metrics.lookup","name":"company fundamentals and financial metrics lookup","description":"Retrieves company financial metrics (P/E ratio, market cap, dividend yield, earnings per share, debt-to-equity, etc.) from Yahoo Finance for fundamental analysis. Implements MCP tool binding to expose these metrics as queryable data, enabling agents to perform valuation comparisons and fundamental screening without manual data aggregation.","intents":["Compare P/E ratios and dividend yields across multiple stocks for value investing analysis","Retrieve earnings per share and revenue growth metrics for a company","Get market cap and sector information to contextualize a stock within its industry"],"best_for":["Fundamental analysis agents and investment research tools","Stock screening applications that filter by financial metrics","Educational platforms teaching value investing principles"],"limitations":["Metrics update frequency depends on Yahoo Finance refresh cycle (typically daily or quarterly for earnings data)","Some metrics may be unavailable for small-cap or international stocks","Earnings data lags actual reporting by 1-2 days","No access to SEC filings or detailed footnotes — only summary metrics"],"requires":["MCP client implementation","Valid ticker symbol","Network access to Yahoo Finance"],"input_types":["ticker symbol (string)","optional metric filter (e.g., 'pe_ratio', 'dividend_yield')"],"output_types":["structured JSON with financial metrics","timestamp of last metric update"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_3","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 agents to request data for multiple tickers in a single MCP tool invocation or through sequential calls with optimized batching. Implements parameter arrays or loop-friendly tool schemas to allow agents to analyze portfolios or compare multiple securities without individual API calls per ticker. Handles response aggregation and formatting for comparative analysis.","intents":["Get current prices for all stocks in a portfolio in one agent step","Compare historical performance across 5-10 related stocks","Screen multiple tickers against financial metric thresholds"],"best_for":["Portfolio analysis agents managing multiple positions","Comparative stock analysis tools","Sector-wide screening and benchmarking applications"],"limitations":["Batch size may be limited by Yahoo Finance rate limits or MCP message size constraints","Response latency scales with number of tickers (no parallel requests in basic implementation)","Partial failures (one ticker unavailable) may require retry logic in agent","No built-in deduplication if agent requests same ticker multiple times"],"requires":["MCP client supporting array parameters or loop constructs","List of valid ticker symbols","Sufficient rate limit quota for batch size"],"input_types":["array of ticker symbols","optional data type filter (quotes, fundamentals, historical)"],"output_types":["array of structured JSON objects, one per ticker","aggregated comparison data"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_4","uri":"capability://tool.use.integration.mcp.protocol.server.lifecycle.and.tool.registration","name":"mcp protocol server lifecycle and tool registration","description":"Implements the Model Context Protocol server specification, handling client connection negotiation, tool schema registration, and request routing. Manages the server process lifecycle (startup, shutdown, error handling) and exposes Yahoo Finance capabilities as standardized MCP tools with JSON schema definitions. Handles protocol versioning and capability advertisement to ensure compatibility with MCP clients.","intents":["Set up a persistent MCP server that Claude Desktop or other clients can connect to","Register financial data tools with proper JSON schemas so clients understand parameters and return types","Handle connection lifecycle and graceful shutdown without losing in-flight requests"],"best_for":["Developers integrating financial data into Claude or other MCP-compatible LLM applications","Teams deploying MCP servers in production environments","Organizations standardizing on MCP for tool integration across multiple AI applications"],"limitations":["MCP is a relatively new protocol — ecosystem tooling and documentation still maturing","Server must be running continuously for client access (no serverless deployment model)","No built-in authentication or authorization — relies on network isolation or client-side secrets management","Debugging MCP protocol issues requires understanding of JSON-RPC 2.0 and MCP specification"],"requires":["Node.js runtime with MCP SDK or equivalent implementation","MCP client library (Claude Desktop, custom MCP runner, etc.)","Understanding of JSON schema for tool definitions"],"input_types":["MCP protocol messages (JSON-RPC 2.0 format)","tool invocation requests with parameters"],"output_types":["MCP protocol responses","tool results in JSON format"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_5","uri":"capability://tool.use.integration.error.handling.and.graceful.api.failure.recovery","name":"error handling and graceful api failure recovery","description":"Implements error handling for Yahoo Finance API failures (rate limits, timeouts, invalid tickers, network errors) with appropriate MCP error responses. Provides fallback strategies such as cached data, partial results, or clear error messages that agents can interpret and act upon. Distinguishes between transient errors (retry-able) and permanent failures (invalid ticker).","intents":["Handle rate limit errors gracefully and inform agents when to retry","Return meaningful error messages when a ticker doesn't exist or data is unavailable","Provide partial results if some tickers in a batch request fail"],"best_for":["Production agents that need robust error handling for unreliable external APIs","Applications requiring high availability despite Yahoo Finance API instability","Teams building user-facing financial applications with clear error messaging"],"limitations":["No built-in retry logic with exponential backoff — agents must implement retry strategies","Cached fallback data may be stale if API is down for extended periods","Rate limit detection depends on Yahoo Finance returning standard HTTP status codes","Some network errors (DNS failures, timeouts) may not be distinguishable from API errors"],"requires":["MCP error response handling in client","Agent logic to interpret error codes and decide on retry vs. fallback"],"input_types":["any tool invocation that may fail"],"output_types":["MCP error responses with error codes and messages","partial results with error indicators"],"categories":["tool-use-integration","safety-moderation"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_6","uri":"capability://data.processing.analysis.dividend.and.earnings.data.retrieval","name":"dividend and earnings data retrieval","description":"Fetches dividend history, upcoming dividend dates, and earnings information from Yahoo Finance for a given ticker. Returns structured data including dividend per share, ex-dividend dates, earnings dates, and EPS estimates. Enables fundamental analysis and income-focused portfolio evaluation through Claude's reasoning capabilities.","intents":["I want Claude to tell me when the next dividend payment is for my stocks and how much I'll receive","I need to analyze dividend yield and growth trends to evaluate income-generating investments","I want to understand upcoming earnings dates to plan my portfolio activity around earnings announcements"],"best_for":["Income-focused investors analyzing dividend stocks","Financial advisors evaluating retirement portfolios","Developers building fundamental analysis or earnings calendar tools"],"limitations":["Dividend and earnings data is often incomplete or delayed; not all companies report consistently to Yahoo Finance","EPS estimates are consensus forecasts and may differ significantly from actual results","No built-in handling of special dividends or one-time payouts; may be conflated with regular dividends","Historical dividend data may be incomplete for recently IPO'd companies or those with complex dividend histories"],"requires":["MCP-compatible client","Network access to Yahoo Finance API","Valid ticker symbol"],"input_types":["text (ticker symbol)"],"output_types":["structured JSON (dividend history array, next ex-dividend date, earnings dates, EPS estimates)"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_ale-ishizawa-yahoo-finance-mcp__cap_7","uri":"capability://data.processing.analysis.stock.split.and.corporate.action.tracking","name":"stock split and corporate action tracking","description":"Retrieves information about stock splits, reverse splits, mergers, and other corporate actions from Yahoo Finance. Enables accurate historical price analysis by accounting for adjustments and helps Claude understand why historical prices may appear discontinuous. Integrates with historical price retrieval to provide context for price anomalies.","intents":["I want Claude to explain why a stock's price dropped 50% overnight (stock split)","I need to understand how corporate actions have affected my cost basis and historical returns","I want to analyze a stock's true performance by adjusting for splits and mergers"],"best_for":["Long-term investors analyzing multi-decade holdings","Tax professionals calculating adjusted cost basis","Developers building accurate historical analysis tools"],"limitations":["Corporate action data is often incomplete or delayed; Yahoo Finance may not have all historical actions","No built-in automatic adjustment of historical prices; Claude must manually apply split factors","Merger and acquisition data may be incomplete; only major actions are typically recorded","Data quality varies by ticker; smaller companies may have missing or inaccurate corporate action records"],"requires":["MCP-compatible client","Network access to Yahoo Finance API","Valid ticker symbol"],"input_types":["text (ticker symbol)"],"output_types":["structured JSON array of corporate actions with dates, types, and adjustment factors"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":28,"verified":false,"data_access_risk":"moderate","permissions":["MCP client implementation (Claude Desktop, custom MCP runner, or compatible LLM framework)","Network access to Yahoo Finance API endpoints","Node.js runtime or equivalent for running the MCP server process","MCP client with support for parameterized tool calls","Ticker symbol and valid start/end date parameters (ISO 8601 format recommended)","Network connectivity to Yahoo Finance API","MCP client implementation","Valid ticker symbol","Network access to Yahoo Finance","MCP client supporting array parameters or loop constructs"],"failure_modes":["Dependent on Yahoo Finance API availability and rate limits (typically 2000 requests/hour per IP)","Data latency matches Yahoo Finance backend (typically 15-20 minute delay for free tier)","No built-in caching — repeated queries for same ticker incur repeated API calls","Limited to securities available on Yahoo Finance (excludes some international exchanges)","Historical data completeness depends on Yahoo Finance coverage (some delisted securities unavailable)","Free tier may have rate limits on large historical queries (e.g., 10+ years of daily data)","No intraday data for most free tier access (daily granularity only)","Adjusted close prices may differ from other data providers due to adjustment methodology","Metrics update frequency depends on Yahoo Finance refresh cycle (typically daily or quarterly for earnings data)","Some metrics may be unavailable for small-cap or international stocks","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.26,"ecosystem":0.48999999999999994,"match_graph":0.25,"freshness":0.6,"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:16.962Z","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-yahoo-finance-mcp","compare_url":"https://unfragile.ai/compare?artifact=ale-ishizawa-yahoo-finance-mcp"}},"signature":"wfnpEIYYhbpiF2seJilph5X+2YDtKUZeShOtRdH6T16Qe1BL8Ie3VBRgSCaqeNblMOP7S5ChnJtZHDWQgZT8BA==","signedAt":"2026-06-21T03:21:23.372Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/ale-ishizawa-yahoo-finance-mcp","artifact":"https://unfragile.ai/ale-ishizawa-yahoo-finance-mcp","verify":"https://unfragile.ai/api/v1/verify?slug=ale-ishizawa-yahoo-finance-mcp","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"}}