MCP server for stock portfolio analysis and reporting
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-stock-analysis","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 📊 Stock Analysis MCP Server This is a modular, async-capable **Multi-Component Protocol (MCP)** server for comprehensive stock portfolio analysis using `yfinance`, `pandas`, `numpy`, and `BeautifulSoup`. It exposes a set of tools for use by LLM agents or other MCP clients via the `uvx` ecosystem. --- ## 🚀 Features * Fetch historical market data and fundamentals * Analyze volatility, RSI, moving averages, drawdowns, P\&L * Sentiment scraping via Yahoo Finance * Portfolio aggregation (returns, weight concentration, volatility) * Async parallel processing for multiple tickers * Generates markdown-based report summaries with insights --- ## 🧠 UVX Integration Config Include this block in your UVX configuration: ```json { "name": "mcp_stock_analysis", "command": "uvx", "args": [ "mcp-stock-analysis@latest" /// The package name and executable name are different ] } ``` This MCP module will then be discoverable and callable by your agents or chains. --- ## 🧰 Tools Overview ### `fetch_market_data(symbol)` Fetches OHLCV history, company info, dividends, splits, analyst recommendations, and insider transactions for a stock. ### `fetch_market_data_multiple_tickers_parallel(symbols)` Parallel async variant of above for multiple stocks. ### `analyze_stock(data, qty, avg_cost)` Computes: * Invested amount, current value, P\&L * Volatility (annualized), drawdown * RSI, MA50, MA200 ### `analyze_multiple_stocks_parallel(stock_inputs)` Parallelized multi-stock analyzer. Accepts a list of dictionaries with each stock’s market data, quantity, and average cost. ### `summarize_sentiment(symbol)` Scrapes Yahoo Finance news headlines for the stock. Returns recent 5 with title + timestamp. ### `aggregate_portfolio(analyses)` Computes overall portfolio metrics: * Total invested, current value, return % * Concentration risks (stocks >10%) * Weighted volatility ### `generate_recommendations(summary, analyses)` Alerts for: * Overweight positions (>…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.