What is StockMCP?
StockMCP is a comprehensive Model Context Protocol (MCP) server for real‑time stock market data, leveraging Yahoo Finance as its primary data source. It exposes a JSON‑RPC 2.0 interface ideal for AI applications, financial analysis tools, and trading bots.
How to use StockMCP?
You can use the free hosted endpoint (https://stockmcp.leoguerin.fr/api/mcp) immediately with no API key, or run the server locally via Docker or Python (uv sync / pip install -e .). Configure MCP clients (Claude Desktop, Cursor, etc.) to point to the endpoint and use tools/list for discovery and tools/call for execution.
Key features of StockMCP
- Real‑time quotes, fundamentals, and historical OHLCV data
- Dividend analysis with quality metrics and consistency scoring
- Analyst forecasts (price targets, consensus ratings, EPS)
- Forward growth projections (revenue, EPS, FCF with CAGR)
- Optional Alpha Vantage integration for enhanced earnings estimates
- Docker‑ready and supports custom port mapping
Use cases of StockMCP
- Retrieving current market data for investment dashboards
- Feeding historical price and fundamental data into AI models
- Automating trading bot decisions with analyst forecasts
- Performing dividend quality analysis for income portfolios
- Generating growth projections for company research reports
评论