Back to Discover

quant-brain-mcp

connector

paarths-collab

Stock analysis MCP: 38 indicators, 7 optimizers, 8 backtests, US + India sectors.

View on GitHub
0 starsSynced Aug 16, 2026

Install to Claude Code

/plugin marketplace add paarths-collab/quant-brain-mcp

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 Tests License: MIT Python 3.12


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:

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.

πŸ›  What you get β€” 25 tools

ToolsWhat they answer
πŸ“‹ Trader workflowget_quote Β· get_news Β· build_trade_plan Β· scan_watchlist Β· price_alertWhat's it at? What happened? What do I do? What moved this week? Tell me when it hits my level.
πŸ“Š Indicators6 grouped analyze_* tools β€” 38 curated indicatorsIs it overbought? Trending or chopping? How volatile?
πŸ’Ό Portfoliogenerate_optimized_verdict β€” 7 optimization methodsHow do I split my money? What's my risk?
πŸ§ͺ Backtests7 rule-based strategiesDoes this strategy actually work, or does it just feel like it?
πŸ”­ IntelligenceSector ranking Β· sectorβ†’stock pipeline Β· company profilesWhich sector is leading? Which stocks inside it?
πŸ“ˆ ChartsInstitutional chart pack, rendered as imagesShow me.

Full reference with every parameter: docs/tools.md

πŸ”„ The workflow it's built around

flowchart LR
    S["πŸ” <b>scan_watchlist</b><br/>what moved this week?"] --> N["πŸ“° <b>get_news</b><br/>why did it move?"]
    N --> P["πŸ“ <b>build_trade_plan</b><br/>entry Β· stop Β· size Β· targets"]
    P --> A["πŸ”” <b>price_alert</b><br/>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

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.

🎯 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.
  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

PageWhat's in it
Getting StartedConnecting from Claude Desktop, Web, and Code; cold starts; troubleshooting
Tool ReferenceAll 25 tools, every parameter, response shapes
Example PromptsThe prompt cookbook β€” from one-liners to full workflows
Price AlertsPersistent alerts + the scheduled watcher pattern
Architecture & MethodologyHow 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 β€” use it, fork it, ship it.

Rendered live from paarths-collab/quant-brain-mcp's GitHub README β€” not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
streamable-http remoteHosted streamable-http endpointmcp-serverhttps://mcp-quant-brain.onrender.com/mcp

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet β€” be the first to share an update.