Labsco
LogeshR15 logo

screener-mcp

β˜… 2

from LogeshR15

Turn Claude into a personal Indian equity analyst powered by live Screener.in data.

πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeQuick setup

screener-mcp β€” Indian Stock Research for Claude - 300+ Active users

Contact; logeshl2003@gmail.com inkedin.com/in/logesh-ramasamy/

Turn Claude into a personal Indian equity analyst powered by live Screener.in data.

Ask Claude naturally β€” it fetches real financial data and reasons over it like a seasoned analyst.


Demo

<!-- Add a GIF here showing Claude answering "Compare TCS and Infosys" -->

Screenshot / GIF coming soon. Try it yourself and see!


What you can ask

Copy & paste β€” that's it
"Compare ITC and HUL"
"Find chemical stocks with low debt and strong growth"
"Explain Jyothy Labs like I'm a beginner"
"What are the red flags in Asian Paints?"
"Find hidden gems below β‚Ή5000 crore market cap"
"Show me TCS quarterly results for last 2 years"
"What is the promoter holding trend for Titan?"
"Find companies with improving ROCE over 5 years"
"Which companies benefit from EV adoption?"
"Give me businesses with 15%+ profit growth and low debt"

Verify it's connected

Copy & paste β€” that's it
claude mcp list
# screener  stdio  βœ“ Connected

Then ask Claude: "Search for Asian Paints" β€” you should get results.


Tools available

ToolWhat it doesLogin needed?
search_companyFind company by name or symbolNo
get_company_overviewKey ratios, price, aboutNo
get_financialsP&L / Balance Sheet / Cash Flow / RatiosNo
get_quarterly_resultsLast 8 quarters of resultsNo
get_shareholding_patternPromoter/FII/DII holding trendsNo
get_peer_comparisonPeer comparison tableNo
compare_companiesSide-by-side multi-company comparisonNo
get_full_analysisAll data combined for deep analysisNo
analyze_red_flagsStructured red flag detectionNo
explain_for_beginnersPlain-language company explainerNo
screen_stocksCustom Screener.in queryYes
screen_by_themePre-built thematic screensYes
list_investment_themesShow all available themesNo

Pre-built themes

Copy & paste β€” that's it
undervalued_small_cap     β€” Small caps with ROCE > 15%, low debt
high_roce_low_debt        β€” ROCE > 20%, debt to equity < 0.3
compounders               β€” 15%+ growth: revenue, profit, ROE, ROCE
turnaround                β€” Strong recent profit recovery
rising_profit_falling_price β€” Improving profits, compressed PE
hidden_gems               β€” Small cap, high ROCE, strong growth
dividend_aristocrats      β€” Consistent dividends with quality financials
qarp                      β€” Quality at reasonable price
micro_cap_growth          β€” High-growth micro caps < β‚Ή1000 Cr
ev_theme                  β€” EV & auto ancillary growth companies
chemicals                 β€” Specialty chemicals with strong fundamentals
defense                   β€” Defense sector with revenue momentum
railways                  β€” Railway infra/equipment companies
renewable_energy          β€” Renewable energy sector

Architecture

Copy & paste β€” that's it
screener-mcp/
β”œβ”€β”€ run_server.py                  # Entry point
└── src/screener_mcp/
    β”œβ”€β”€ server.py                  # FastMCP server β€” tool definitions
    β”œβ”€β”€ client.py                  # HTTP client (auth, rate limiting)
    β”œβ”€β”€ parsers/
    β”‚   β”œβ”€β”€ company.py             # Parse company HTML pages
    β”‚   └── screener.py            # Parse screener results
    └── tools/
        β”œβ”€β”€ company_tools.py       # Company data tools
        β”œβ”€β”€ screening_tools.py     # Stock screening tools
        └── analysis_tools.py     # Deep analysis tools

Contributing

See CONTRIBUTING.md β€” adding a new tool takes ~10 minutes.

contact

Mail: logeshl2003@gmail.com Linkedin: inkedin.com/in/logesh-ramasamy/