{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nsbust6gne74","handle":"mcp-stock-analysis","url":"https://wellknown.network/agents/mcp-stock-analysis","links":{"self":"https://wellknown.network/agents/mcp-stock-analysis/record.json","html":"https://wellknown.network/agents/mcp-stock-analysis","markdown":"https://wellknown.network/agents/mcp-stock-analysis/record.md","api":"https://wellknown.network/api/v1/agents/mcp-stock-analysis","status":"https://wellknown.network/api/v1/agents/mcp-stock-analysis/status","claim":"https://wellknown.network/agents/mcp-stock-analysis/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-stock-analysis/claim.json","badge":"https://wellknown.network/agents/mcp-stock-analysis/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-stock-analysis/history","tools":"https://wellknown.network/api/v1/agents/mcp-stock-analysis/tools"},"ard":{"identifier":"urn:air::server:mcp-stock-analysis","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-stock-analysis","summary":"MCP server for stock portfolio analysis and reporting","description":"# 📊 Stock Analysis MCP Server\n\nThis 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.\n\n---\n\n## 🚀 Features\n\n* Fetch historical market data and fundamentals\n* Analyze volatility, RSI, moving averages, drawdowns, P\\&L\n* Sentiment scraping via Yahoo Finance\n* Portfolio aggregation (returns, weight concentration, volatility)\n* Async parallel processing for multiple tickers\n* Generates markdown-based report summaries with insights\n\n---\n\n## 🧠 UVX Integration Config\n\nInclude this block in your UVX configuration:\n\n```json\n{\n  \"name\": \"mcp_stock_analysis\",\n  \"command\": \"uvx\",\n  \"args\": [\n    \"mcp-stock-analysis@latest\"  /// The package name and executable name are different\n  ]\n}\n```\n\nThis MCP module will then be discoverable and callable by your agents or chains.\n\n---\n\n## 🧰 Tools Overview\n\n### `fetch_market_data(symbol)`\n\nFetches OHLCV history, company info, dividends, splits, analyst recommendations, and insider transactions for a stock.\n\n### `fetch_market_data_multiple_tickers_parallel(symbols)`\n\nParallel async variant of above for multiple stocks.\n\n### `analyze_stock(data, qty, avg_cost)`\n\nComputes:\n\n* Invested amount, current value, P\\&L\n* Volatility (annualized), drawdown\n* RSI, MA50, MA200\n\n### `analyze_multiple_stocks_parallel(stock_inputs)`\n\nParallelized multi-stock analyzer. Accepts a list of dictionaries with each stock’s market data, quantity, and average cost.\n\n### `summarize_sentiment(symbol)`\n\nScrapes Yahoo Finance news headlines for the stock. Returns recent 5 with title + timestamp.\n\n### `aggregate_portfolio(analyses)`\n\nComputes overall portfolio metrics:\n\n* Total invested, current value, return %\n* Concentration risks (stocks >10%)\n* Weighted volatility\n\n### `generate_recommendations(summary, analyses)`\n\nAlerts for:\n\n* Overweight positions (>…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-stock-analysis","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"},{"slug":"content.writing","name":"Writing & Editing","confidence":0.825,"provenance":"derived"},{"slug":"data.news","name":"News & Feeds","confidence":0.791,"provenance":"derived"}],"categories":["content","data","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-stock-analysis","registry":"pypi","observedAt":"2026-11-03T16:26:01.842Z","publishedAt":"2025-10-22T17:32:06.305773Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-stock-analysis","url":"https://pypi.org/project/mcp-stock-analysis/","firstSeenAt":"2026-09-10T04:23:25.431Z","fetchedAt":"2026-11-03T16:24:34.739Z","normalizedAt":"2026-11-03T16:24:34.739Z"}]},"firstSeenAt":"2026-09-10T04:23:25.431Z","updatedAt":"2026-11-03T16:26:01.842Z"}