Screener Stock Research
logeshr15/screener-mcp
Indian stock research (BSE/NSE) via Screener.in: financials, screens, filings, earnings calls.
- GitHub stars
- 22
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Nov 12, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
search_companyFind company by name or symbol
Find company by name or symbol
No parameter schema in public metadata yet.
get_company_overviewKey ratios, price, 52W range, NSE/BSE codes, about, Screener's pros/cons
Key ratios, price, 52W range, NSE/BSE codes, about, Screener's pros/cons
No parameter schema in public metadata yet.
get_financialsP&L (TTM separate) / Balance Sheet / Cash Flow / Ratios incl. year-end P/E, P/B, ROE, debt-to-equity
P&L (TTM separate) / Balance Sheet / Cash Flow / Ratios incl. year-end P/E, P/B, ROE, debt-to-equity
No parameter schema in public metadata yet.
get_quarterly_resultsLast 8 quarters of results
Last 8 quarters of results
No parameter schema in public metadata yet.
get_shareholding_pattern8-quarter holding trends per category, promoter-group detection, promoter pledge
8-quarter holding trends per category, promoter-group detection, promoter pledge
No parameter schema in public metadata yet.
get_peer_comparisonSector peer comparison table
Sector peer comparison table
No parameter schema in public metadata yet.
compare_companies2–6 stocks side by side, with point-in-time red flags; interactive dashboard (MCP App) where supported, JSON everywhere
2–6 stocks side by side, with point-in-time red flags; interactive dashboard (MCP App) where supported, JSON everywhere
No parameter schema in public metadata yet.
get_full_analysisAll data combined for deep analysis (same windows as the standalone tools)
All data combined for deep analysis (same windows as the standalone tools)
No parameter schema in public metadata yet.
analyze_red_flagsRule-based red-flag checks over the full history, each with evidence and thresholds
Rule-based red-flag checks over the full history, each with evidence and thresholds
No parameter schema in public metadata yet.
screen_stocksScreener.in query plus technical clauses (52W distance, RSI, DMA, volume spike)
Screener.in query plus technical clauses (52W distance, RSI, DMA, volume spike)
No parameter schema in public metadata yet.
get_52_week_low_candidatesQuality filters + proximity to 52-week low, with overview fields per match
Quality filters + proximity to 52-week low, with overview fields per match
No parameter schema in public metadata yet.
get_relative_valuationP/E and ROCE vs the industry median for up to 20 stocks at once
P/E and ROCE vs the industry median for up to 20 stocks at once
No parameter schema in public metadata yet.
compare_to_sectorStock's return vs its sector index and Nifty 50, with a market-vs-company verdict
Stock's return vs its sector index and Nifty 50, with a market-vs-company verdict
No parameter schema in public metadata yet.
screen_by_themePre-built thematic screens — every theme's criteria are in the tool description
Pre-built thematic screens — every theme's criteria are in the tool description
No parameter schema in public metadata yet.
get_document_listList annual reports & earnings call transcripts
List annual reports & earnings call transcripts
No parameter schema in public metadata yet.
ask_company_researchAsk a question over a company's annual reports and earnings calls — all recent ones, one doc_type, or one document (year / quarter / pdf_url)
Ask a question over a company's annual reports and earnings calls — all recent ones, one doc_type, or one document (year / quarter / pdf_url)
No parameter schema in public metadata yet.
search_market_commentarySearch a question across multiple companies' already-indexed documents at once
Search a question across multiple companies' already-indexed documents at once
No parameter schema in public metadata yet.
get_company_announcementsNSE corporate announcements with category filter — incl. credit_rating (CRISIL/ICRA/CARE/India Ratings) and esg_rating
NSE corporate announcements with category filter — incl. credit_rating (CRISIL/ICRA/CARE/India Ratings) and esg_rating
No parameter schema in public metadata yet.
get_bulk_dealsNSE bulk deals by company (symbol), by investor (name), or both
NSE bulk deals by company (symbol), by investor (name), or both
No parameter schema in public metadata yet.
get_insider_tradingSEBI PIT promoter/KMP/designated-person trade disclosures, no size threshold (both NSE PIT feeds merged)
SEBI PIT promoter/KMP/designated-person trade disclosures, no size threshold (both NSE PIT feeds merged)
No parameter schema in public metadata yet.
get_recent_newsRecent news headlines for a company (Google News), newest first
Recent news headlines for a company (Google News), newest first
No parameter schema in public metadata yet.
get_analyst_targetsConsensus target price (mean/median/high/low, analyst count, rating split) + broker targets in recent headlines
Consensus target price (mean/median/high/low, analyst count, rating split) + broker targets in recent headlines
No parameter schema in public metadata yet.
get_forward_outlookAnalyst EPS/revenue estimates, order wins and capex filings, management guidance from the latest earnings call
Analyst EPS/revenue estimates, order wins and capex filings, management guidance from the latest earnings call
No parameter schema in public metadata yet.
get_moat_signalsRevenue share/rank and industry concentration (HHI), plus ROCE, margin and promoter-holding durability
Revenue share/rank and industry concentration (HHI), plus ROCE, margin and promoter-holding durability
No parameter schema in public metadata yet.
get_commodity_pricesInternational benchmark price, period moves, ≈INR price + exposed companies' symbols (incl. wheat; tobacco and wood pulp as exposure-only)
International benchmark price, period moves, ≈INR price + exposed companies' symbols (incl. wheat; tobacco and wood pulp as exposure-only)
No parameter schema in public metadata yet.
notebook_aiSave, read, and AI-summarize research notes locally
Save, read, and AI-summarize research notes locally
No parameter schema in public metadata yet.
add_portfolio_stockAdd/merge a holding into your local portfolio (quantity-weighted avg cost)
Add/merge a holding into your local portfolio (quantity-weighted avg cost)
No parameter schema in public metadata yet.
update_portfolio_stockOverwrite quantity/avg price on an existing holding (partial sell, cost correction)
Overwrite quantity/avg price on an existing holding (partial sell, cost correction)
No parameter schema in public metadata yet.
remove_portfolio_stockRemove a holding entirely
Remove a holding entirely
No parameter schema in public metadata yet.
get_portfolioView holdings with live price, P&L (₹ and %), and weight
View holdings with live price, P&L (₹ and %), and weight
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SCREENER_USERNAMEScreener.in login email. Optional; without it only public data is available and fundamental screens are disabled.
SCREENER_PASSWORDsecretScreener.in password. Optional; pair with SCREENER_USERNAME.
Readme
screener-mcp
An MCP (Model Context Protocol) server that gives Claude live access to Screener.in, NSE, and MCX data — turning Claude into a research assistant for Indian stocks.
Report an issue · LinkedIn · logeshl2003@gmail.com
Details
- Repository
- github.com/logeshr15/screener-mcp
- Website
- logeshr15.github.io/screener-mcp
- Package
screener-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active