Indian Stock Research MCP server powered by Screener.in
Indian Stock Research MCP server powered by Screener.in
claude mcp add screener -s user -- \ $(pwd)/.venv/bin/python3.11 \ $(pwd)/run_server.py ```
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| search_company | Find company by name or symbol |
| get_company_overview | Key ratios, price, 52W range, NSE/BSE codes, about, Screener's pros/cons |
| get_financials | P&L (TTM separate) / Balance Sheet / Cash Flow / Ratios incl. year-end P/E, P/B, ROE, debt-to-equity |
| get_quarterly_results | Last 8 quarters of results |
| get_shareholding_pattern | 8-quarter holding trends per category, promoter-group detection, promoter pledge |
| get_peer_comparison | Sector peer comparison table |
| compare_companies | 2–6 stocks side by side, with point-in-time red flags; interactive dashboard (MCP App) where supported, JSON everywhere |
| get_full_analysis | All data combined for deep analysis (same windows as the standalone tools) |
| analyze_red_flags | Rule-based red-flag checks over the full history, each with evidence and thresholds |
| screen_stocks | Screener.in query plus technical clauses (52W distance, RSI, DMA, volume spike) |
| get_52_week_low_candidates | Quality filters + proximity to 52-week low, with overview fields per match |
| get_relative_valuation | P/E and ROCE vs the industry median for up to 20 stocks at once |
| compare_to_sector | Stock's return vs its sector index and Nifty 50, with a market-vs-company verdict |
| screen_by_theme | Pre-built thematic screens — every theme's criteria are in the tool description |
| get_document_list | List annual reports & earnings call transcripts |
| ask_company_research | 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) |
| search_market_commentary | Search a question across multiple companies' already-indexed documents at once |
| get_company_announcements | NSE corporate announcements with category filter — incl. credit_rating (CRISIL/ICRA/CARE/India Ratings) and esg_rating |
| get_bulk_deals | NSE bulk deals by company (symbol), by investor (name), or both |
| get_insider_trading | SEBI PIT promoter/KMP/designated-person trade disclosures, no size threshold (both NSE PIT feeds merged) |
| get_recent_news | Recent news headlines for a company (Google News), newest first |
| get_analyst_targets | Consensus target price (mean/median/high/low, analyst count, rating split) + broker targets in recent headlines |
| get_forward_outlook | Analyst EPS/revenue estimates, order wins and capex filings, management guidance from the latest earnings call |
| get_moat_signals | Revenue share/rank and industry concentration (HHI), plus ROCE, margin and promoter-holding durability |
| get_commodity_prices | International benchmark price, period moves, ≈INR price + exposed companies' symbols (incl. wheat; tobacco and wood pulp as exposure-only) |
| notebook_ai | Save, read, and AI-summarize research notes locally |
| add_portfolio_stock | Add/merge a holding into your local portfolio (quantity-weighted avg cost) |
| update_portfolio_stock | Overwrite quantity/avg price on an existing holding (partial sell, cost correction) |
| remove_portfolio_stock | Remove a holding entirely |
| get_portfolio | View holdings with live price, P&L (₹ and %), and weight |
{
"mcpServers": {
"screener": {
"command": "uvx",
"args": [
"--from",
"screener-mcp[ai]",
"screener-mcp"
],
"env": {
"SCREENER_USERNAME": "your@email.com",
"SCREENER_PASSWORD": "YOUR_SCREENER_PASSWORD"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| SCREENER_USERNAME | Declared in the maintainer’s client configuration. | Check documentation |
| SCREENER_PASSWORD | Declared in the maintainer’s client configuration. | Check documentation |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.