
screener-mcp
β 2from LogeshR15
Turn Claude into a personal Indian equity analyst powered by live Screener.in data.
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
"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
claude mcp list
# screener stdio β ConnectedThen ask Claude: "Search for Asian Paints" β you should get results.
Tools available
| Tool | What it does | Login needed? |
|---|---|---|
search_company | Find company by name or symbol | No |
get_company_overview | Key ratios, price, about | No |
get_financials | P&L / Balance Sheet / Cash Flow / Ratios | No |
get_quarterly_results | Last 8 quarters of results | No |
get_shareholding_pattern | Promoter/FII/DII holding trends | No |
get_peer_comparison | Peer comparison table | No |
compare_companies | Side-by-side multi-company comparison | No |
get_full_analysis | All data combined for deep analysis | No |
analyze_red_flags | Structured red flag detection | No |
explain_for_beginners | Plain-language company explainer | No |
screen_stocks | Custom Screener.in query | Yes |
screen_by_theme | Pre-built thematic screens | Yes |
list_investment_themes | Show all available themes | No |
Pre-built themes
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 sectorArchitecture
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 toolsContributing
See CONTRIBUTING.md β adding a new tool takes ~10 minutes.
contact
Mail: logeshl2003@gmail.com Linkedin: inkedin.com/in/logesh-ramasamy/
claude mcp add screener -s user -- uvx screener-mcpQuick install (recommended)
If you have uv installed (pip install uv or brew install uv):
claude mcp add screener -s user -- uvx screener-mcpThat's it. No cloning, no venv setup β uvx handles everything automatically.
Don't have uv? Install it:
pip install uvorbrew install uv
Manual install (alternative)
git clone https://github.com/LogeshR15/screener-mcp
cd screener-mcp
python3.11 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install httpx beautifulsoup4 lxml "mcp[cli]"
claude mcp add screener -s user -- \
$(pwd)/.venv/bin/python3.11 \
$(pwd)/run_server.pySetup credentials (required for stock screening)
Company data (financials, ratios, shareholding) works without login. Stock screening requires a free Screener.in account.
1. Register free at screener.in/register
2. Add to your shell profile (~/.zshrc or ~/.bashrc):
export SCREENER_USERNAME="your@email.com"
export SCREENER_PASSWORD="yourpassword"3. Reload your shell (source ~/.zshrc) and restart Claude Code.
Data source & limitations
All data comes from Screener.in β India's most popular stock research platform covering BSE and NSE listed companies with 10+ years of financial history.
- Financial data is updated quarterly (lags by ~1 quarter)
- This is a research tool β not financial advice
- Always verify critical data directly on Screener.in