# quant-brain-mcp [Health: Active] **Category:** πŸ’» Developer Tools **Repository:** https://github.com/paarths-collab/quant-brain-mcp **GitHub Stars:** 4 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/quant-brain-mcp ## Description Stock analysis MCP: 38 indicators, 7 optimizers, 8 backtests, US + India sectors. ## Claude Desktop Quick Installation Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client: ```json "mcpServers": { "quant-brain-mcp": { "url": "https://img.shields.io/badge/MCP%20Registry-listed-0e6e5c)](https://registry.modelcontextprotocol.io/v0.1/servers?search=quant-brain-mcp" } } ``` ## Documentation & README
# 🧠 Quant Brain MCP **Turn Claude into a quantitative analyst for US and Indian equities.** Ask in plain English. Get sized trade plans, portfolio optimization, backtests, and price alerts β€” grounded in real market data, not vibes. [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-0e6e5c)](https://registry.modelcontextprotocol.io/v0.1/servers?search=quant-brain-mcp) [![Tests](https://img.shields.io/badge/tests-161%20passing-0e6e5c)](tests/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](requirements.txt)
--- ```text You: "Scan my watchlist and build a trade plan for whatever looks most actionable. β‚Ή2,00,000 equity, 1% risk." Claude: RELIANCE.NS flagged (at 20-DMA, volume 1.8x average). TRADE PLAN β€” RELIANCE.NS (long) Entry β‚Ή1,310.00 Stop β‚Ή1,270.10 (swing low, 2.1 ATR) Size 50 shares (β‚Ή65,500 β€” 32.8% of equity) Max loss β‚Ή1,995 (1.0% of equity) Targets 1R β‚Ή1,349.90 Β· 2R β‚Ή1,389.80 Β· 3R β‚Ή1,429.70 Invalidation Thesis invalid below β‚Ή1,270.10 β€” exit without debate. ``` No API keys. No accounts. Connect one URL and start asking. ## ⚑ Quickstart **Claude Desktop / Claude Web** β†’ Settings β†’ Connectors β†’ Add custom connector β†’ **Streamable HTTP**: ```text https://mcp-quant-brain.onrender.com/mcp ``` That's the whole setup. Try: *"What's RELIANCE trading at, and is it overbought?"* > Free-tier note: the server sleeps when idle and takes ~50 s to wake. If the first request times out, retry once. Details in [Getting Started](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/getting-started.md). ## πŸ›  What you get β€” 25 tools | | Tools | What they answer | |---|---|---| | πŸ“‹ **Trader workflow** | `get_quote` Β· `get_news` Β· `build_trade_plan` Β· `scan_watchlist` Β· `price_alert` | *What's it at? What happened? **What do I do?** What moved this week? Tell me when it hits my level.* | | πŸ“Š **Indicators** | 6 grouped `analyze_*` tools β€” 38 curated indicators | *Is it overbought? Trending or chopping? How volatile?* | | πŸ’Ό **Portfolio** | `generate_optimized_verdict` β€” 7 optimization methods | *How do I split my money? What's my risk?* | | πŸ§ͺ **Backtests** | 7 rule-based strategies | *Does this strategy actually work, or does it just feel like it?* | | πŸ”­ **Intelligence** | Sector ranking Β· sectorβ†’stock pipeline Β· company profiles | *Which sector is leading? Which stocks inside it?* | | πŸ“ˆ **Charts** | Institutional chart pack, rendered as images | *Show me.* | Full reference with every parameter: **[docs/tools.md](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/tools.md)** ## πŸ”„ The workflow it's built around ```mermaid flowchart LR S["πŸ” scan_watchlist
what moved this week?"] --> N["πŸ“° get_news
why did it move?"] N --> P["πŸ“ build_trade_plan
entry Β· stop Β· size Β· targets"] P --> A["πŸ”” price_alert
watch my levels"] A -.->|level breaks β†’ notified| P subgraph deeper["go deeper anytime"] I["πŸ“Š indicators"] ~~~ B["πŸ§ͺ backtests"] ~~~ O["πŸ’Ό optimizer"] end S -.-> deeper ``` ## πŸ”” Price alerts that survive restarts ```text You: "Alert me if RELIANCE drops below β‚Ή1,270" β†’ stored server-side (Postgres) ... Bot: "PRICE ALERT FIRED β€” RELIANCE.NS moved below 1270.00, now at 1268.20" ``` Alerts are one-shot, persist across server restarts, and pair with a scheduled Claude task that checks hourly during market hours and pushes to your phone. Setup in **[docs/price-alerts.md](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/price-alerts.md)**. ## 🎯 Why this instead of a stock screener? 1. **It answers the trading question, not just the data question.** Indicators tell you RSI is 43. `build_trade_plan` tells you *entry, stop, how many shares, and where your thesis dies* β€” sized to your account. 2. **India is a first-class citizen.** NSE tickers, NIFTY benchmarking, 8 Indian sector indices, β‚Ή formatting. Not a US tool with `.NS` bolted on. 3. **The numbers are audited.** Every calculation was adversarially tested against textbook references and live data β€” 161 automated tests pin the math, including regression tests for 11 real bugs found and fixed along the way. See [docs/architecture.md](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/architecture.md). 4. **Honest about its data.** Delayed quotes are labeled with timestamps. Stale feeds are flagged, not hidden. FX limitations are disclosed, not papered over. ## πŸ“š Documentation | Page | What's in it | |---|---| | [Getting Started](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/getting-started.md) | Connecting from Claude Desktop, Web, and Code; cold starts; troubleshooting | | [Tool Reference](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/tools.md) | All 25 tools, every parameter, response shapes | | [Example Prompts](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/examples.md) | The prompt cookbook β€” from one-liners to full workflows | | [Price Alerts](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/price-alerts.md) | Persistent alerts + the scheduled watcher pattern | | [Architecture & Methodology](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/docs/architecture.md) | How it works, data conventions, the bug audit, telemetry | ## ⚠️ Honest limits - **Data**: Yahoo Finance. US quotes near-real-time; NSE/BSE ~15 min delayed. Daily bars for analysis. - **No** options chains, futures, intraday candles, or tick data. - **Not investment advice.** Educational analysis tooling. Every trade plan says so and means it. ## License [MIT](https://github.com/paarths-collab/quant-brain-mcp/blob/HEAD/LICENSE) β€” use it, fork it, ship it.