MCP server for US stock Maximum Drawdown analytics
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":"mdd-stock-mcp","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.
# mdd-stock-mcp > An MCP server for Maximum Drawdown (MDD) analytics across US stocks, Korean stocks (KOSPI/KOSDAQ), and cryptocurrencies. Plug it into Claude Desktop and ask questions like "What was SPY's worst drawdown during COVID?" or "비트코인 2022년 MDD 알려줘" — Claude will fetch the data and discuss it conversationally. [](https://opensource.org/licenses/MIT) [](https://www.python.org/) [](https://modelcontextprotocol.io/) > **Disclaimer**: This project uses [yfinance](https://github.com/ranaroussi/yfinance), an unofficial Yahoo Finance scraper. Not affiliated with Yahoo, not for production trading systems, not for financial advice. Data may be inaccurate, delayed, or unavailable. Use at your own risk. --- ## What it does - Calculates Maximum Drawdown for any supported asset over a date range - Returns OHLCV price history for plotting - Returns a daily drawdown (underwater) series - Compares MDD across multiple tickers side-by-side **Supported markets** (via the `market` parameter): | `market` | Examples | Notes | |---|---|---| | `us` (default) | `AAPL`, `SPY`, `QQQ` | NYSE / NASDAQ | | `kr` | `005930` → `005930.KS` (Samsung), `035720.KQ` (KOSDAQ) | 6-digit codes auto-append `.KS` (KOSPI). Use explicit `.KQ` for KOSDAQ. | | `crypto` | `BTC` → `BTC-USD`, `ETH-USD`, `BTC-KRW` | Bare symbols auto-append `-USD`. | --- ## Quickstart (Claude Desktop) **1. Clone the repo:** ```bash git clone https://github.com/librarywon/mdd-stock-mcp.git cd mdd-stock-mcp ``` **2. Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:** ```json { "mcpServers": { "mdd-stock-mcp": { "command": "uvx", "args": ["--from", "/absolute/path/to/mdd-stock-mcp", "mdd-stock-mcp"] } } } ``` Replace `/absolute/path/to/mdd-stock-mcp` wit…
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.