
FinStack MCP
Built for Indian equity research workflows inside Claude and MCP clients. Connects NSE/BSE real-time data, FII/DII flows, bulk deals, and options chain data with a layer of AI analysis tools including multi-agent stock debate, social sentiment aggregation from StockTwits and Reddit, unusual activity detection across OI and volume, and portfolio risk scanning. The stock brief tool runs six simulated market personas that return a consensus signal with reasoning. Also includes F&O setup suggestions, watchlist ranking, and a morning brief generator. Replaces the usual stack of Screener, Trendlyne, and Sensibull with a single stdio interface. Open source, pip installable, works locally without API keys for most features.
- GitHub stars
- 9
- tools
- 28
- transport
- STDIO
- last updated
- Mar 25, 2026
Tools
28 toolsPublic tool metadata for what this MCP can expose to an agent.
get_stock_brief6 AI agents debate any stock → BUY/HOLD/SELL consensus
6 AI agents debate any stock → BUY/HOLD/SELL consensus
No parameter schema in public metadata yet.
get_stock_debate3-round sequential agent debate with rebuttals and emergent consensus
3-round sequential agent debate with rebuttals and emergent consensus
No parameter schema in public metadata yet.
get_social_sentimentStockTwits + Reddit + ET RSS → sentiment signal
StockTwits + Reddit + ET RSS → sentiment signal
No parameter schema in public metadata yet.
detect_unusual_activityOI buildup + block deals + promoter change + volume spike
OI buildup + block deals + promoter change + volume spike
No parameter schema in public metadata yet.
get_nifty_outlook6-signal probability model for next session direction
6-signal probability model for next session direction
No parameter schema in public metadata yet.
get_fno_trade_setupNIFTY / BANKNIFTY options call: BUY_CE, BUY_PE, or NO_TRADE with ATM strike guidance
NIFTY / BANKNIFTY options call: BUY_CE, BUY_PE, or NO_TRADE with ATM strike guidance
No parameter schema in public metadata yet.
predict_earningsbeat/miss probability before quarterly results
beat/miss probability before quarterly results
No parameter schema in public metadata yet.
get_fii_retail_divergencehighest-conviction Indian market signal
highest-conviction Indian market signal
No parameter schema in public metadata yet.
get_morning_fno_briefdaily NIFTY/BANKNIFTY F&O brief with approval-ready setup summary
daily NIFTY/BANKNIFTY F&O brief with approval-ready setup summary
No parameter schema in public metadata yet.
scan_watchlistbatch-rank a watchlist so automation can surface top buys and top risks
batch-rank a watchlist so automation can surface top buys and top risks
No parameter schema in public metadata yet.
get_stock_signal_scoreautomation-friendly score with factor impacts, supports, and risks
automation-friendly score with factor impacts, supports, and risks
No parameter schema in public metadata yet.
get_stock_timelineone feed for news, results, insider, bulk deals, sentiment, pledge, and smart money
one feed for news, results, insider, bulk deals, sentiment, pledge, and smart money
No parameter schema in public metadata yet.
get_sector_peer_contextsector strength plus peer rank / valuation context
sector strength plus peer rank / valuation context
No parameter schema in public metadata yet.
evaluate_signal_qualityhonest proof layer for the price-action core before making accuracy claims
honest proof layer for the price-action core before making accuracy claims
No parameter schema in public metadata yet.
analyze_portfolioP&L, XIRR, sector concentration, risk flags, diversification score
P&L, XIRR, sector concentration, risk flags, diversification score
No parameter schema in public metadata yet.
get_mf_overlapfund overlap % from AMFI public disclosures
fund overlap % from AMFI public disclosures
No parameter schema in public metadata yet.
get_pledge_alertpromoter pledge early warning with QoQ velocity
promoter pledge early warning with QoQ velocity
No parameter schema in public metadata yet.
scan_pledge_risksbatch pledge scan across your watchlist
batch pledge scan across your watchlist
No parameter schema in public metadata yet.
predict_circuitlower circuit risk prediction
lower circuit risk prediction
No parameter schema in public metadata yet.
detect_pumppump-and-dump pattern detector for small/micro caps
pump-and-dump pattern detector for small/micro caps
No parameter schema in public metadata yet.
get_sebi_alertsSEBI enforcement order tracker (early crash warning)
SEBI enforcement order tracker (early crash warning)
No parameter schema in public metadata yet.
get_morning_brief8:15 AM pre-market brief
8:15 AM pre-market brief
No parameter schema in public metadata yet.
correlate_gst_to_stocksGST monthly data as 1-3mo sector leading indicator
GST monthly data as 1-3mo sector leading indicator
No parameter schema in public metadata yet.
get_agm_briefAGM/EGM unusual resolution detector (debt raise, salary hike, pledge approval)
AGM/EGM unusual resolution detector (debt raise, salary hike, pledge approval)
No parameter schema in public metadata yet.
get_insider_signalSEBI SAST insider buy/sell pattern vs forward returns
SEBI SAST insider buy/sell pattern vs forward returns
No parameter schema in public metadata yet.
get_telegram_trackerDalal Street tip channel accuracy + pump-and-dump scoring
Dalal Street tip channel accuracy + pump-and-dump scoring
No parameter schema in public metadata yet.
analyze_budget_livepaste FM speech → instant sector/stock signals (Feb 1st)
paste FM speech → instant sector/stock signals (Feb 1st)
No parameter schema in public metadata yet.
get_budget_impacthistorical Union Budget winners + losers by year
historical Union Budget winners + losers by year
No parameter schema in public metadata yet.
Sponsors
Readme
FinStack MCP
95 free tools for Indian + global markets. Works inside Claude, Cursor, and any MCP client.
Open-source market intelligence for Indian equities, global markets, and MCP-native AI workflows.
Ask one question like Should I buy Reliance? and get debate, sentiment, smart-money, risk, peer context, and ranking in one stack.
pip install finstack-mcp
Or run without installing:
uvx finstack-mcp
Ask Claude things like:
"Give me a full stock brief on Reliance"
-> 6 AI agents debate: FII Desk + Algo Trader + Value Investor + Retail Pulse + Macro Analyst + Options Flow
-> Consensus: BUY/HOLD/SELL with reasoning
"Is someone accumulating HDFC Bank quietly?"
-> Checks OI buildup, block deals, promoter buying, volume spike simultaneously
Details
- Repository
- github.com/finstacklabs/finstack-mcp
- Category
- Monitoring & Observability
- Package
finstack-mcp- Transport
- STDIO
- Registry
- MCP registry, active