finstacklabs avatar

FinStack MCP

finstacklabs/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 tools

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

PyPI License: MIT Python 3.10+

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

View the full README on GitHub

Details

Repository
github.com/finstacklabs/finstack-mcp
Category
Monitoring & Observability
Package
finstack-mcp
Transport
STDIO
Registry
MCP registry, active

Related Monitoring & Observability MCP servers

View all
1sarahpark avatarGoogle Search Consolesarahpark/google-search-console-mcpGoogle Search Console MCP server — search analytics, URL inspection, and sitemaps9stars
2dmarcoff avatarDMARKOFF — DMARC, SPF & DKIM Analyticsdmarcoff/mcpDMARC analytics for AI assistants: SPF/DKIM, compliance, anomalies, p=reject readiness, onboarding.0stars
3mikusnuz avatarGscmikusnuz/gsc-mcpMCP server for Google Search Console & Indexing API — search analytics, sitemaps, URL inspection8stars
4gosodax avatarSODAX Builders MCPgosodax/builders-sodax-mcp-serverCross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.0stars
5jonradoff avatarLLM Optimizerjonradoff/llmoptAI brand visibility analytics: visibility scores, optimizations, video, Reddit, and search rankings.7stars
6peturgeorgievv-factory avatarPostFastpeturgeorgievv-factory/postfast-mcpSchedule posts on 11 social networks, answer comments and read analytics, hosted or local7stars