search_companyLABSCO SUMMARY
Fundamentals, screening and the primary documents behind them, in one place.
The document tools are what lift it above a data wrapper: you can ask what management actually said about margins last quarter and get an answer grounded in the transcript, with the index built and cached on your own machine. Two-thirds of it works without any login — only the screening queries need a Screener.in account.
What it is
An MCP server that turns an assistant into an Indian equity research desk. Company fundamentals come from Screener.in, corporate events and bulk deals from NSE, and a local RAG pipeline lets you ask questions across annual report PDFs and earnings call transcripts.
What you get
- search_company, get_company_overview and get_full_analysis — find a company by name or symbol, read key ratios, price and 52-week range, or pull everything at once
- get_financials, get_quarterly_results and get_shareholding_pattern — P&L, balance sheet, cash flow and ratios; the last eight quarters; and the promoter, FII and DII holding trend
- get_peer_comparison, compare_companies and compare_stocks_ui — the sector peer table, two to five stocks side by side, and an interactive dashboard on hosts that render it
- analyze_red_flags and explain_for_beginners — structured red-flag detection, and a plain-language explainer of what the company does
- screen_stocks, screen_by_theme and list_investment_themes — a custom Screener.in query, or one of the pre-built themes such as high ROCE with low debt or small caps with strong growth
- get_document_list, analyze_annual_report and analyze_earnings_call — the available annual reports and transcripts, and free-text questions answered over their contents
- get_company_announcements and search_shareholder — NSE corporate announcements with category filters, and investor activity via bulk deals
- get_commodity_prices and notebook_ai — commodity price context with the companies it affects, and local research notes you can save, read and summarise
Requirements
uv, then claude mcp add screener -s user -- uvx screener-mcp. Company financials work with no login; stock screening needs a free Screener.in account, with SCREENER_USERNAME and SCREENER_PASSWORD exported in your shell. Document analysis needs the extra dependencies (pip install pdfplumber sentence-transformers chromadb, or the [ai] extra) — PDFs are parsed and indexed locally and cached on disk, so a report is never re-downloaded or re-indexed.
Setup effort
One command — claude mcp add screener -s user -- uvx screener-mcp
USE CASES
01
Sizing up a company you just heard about
Find it, read the overview and financials, and get a plain-language explanation of the business.
02
Comparing two competitors
Put them side by side on ratios and check them against their sector peers.
03
Finding candidates that fit a rule
Run a custom screen, or start from a pre-built theme and narrow it.
04
Checking what management actually said
List the available documents and ask your question over the transcript or annual report.
05
Looking for reasons to walk away
Run the red-flag pass, then read the recent corporate announcements and shareholding trend.
21 tools
Listed in project docs. Your client may show a different list.
get_company_overviewget_financialsget_quarterly_resultsget_shareholding_patternget_peer_comparisoncompare_companiescompare_stocks_uiget_full_analysisanalyze_red_flagsexplain_for_beginnersscreen_stocksscreen_by_themelist_investment_themesget_document_listanalyze_annual_reportanalyze_earnings_callget_company_announcementssearch_shareholderget_commodity_pricesnotebook_aiBEFORE YOU INSTALL
What to know first
Tools you get
21 tools named in the project's documentation.
Requires
uvx on PATH
Optional
- SCREENER_PASSWORD in your environment
- SCREENER_USERNAME in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
claude mcp add screener -s user -- uvx screener-mcpMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add screener -s user -- uvx screener-mcpSCREENER_USERNAME and SCREENER_PASSWORD are only needed for stock screening (screen_stocks, screen_by_theme); company financials work without a login. To use screening, register free at screener.in and export both variables in ~/.zshrc or ~/.bashrc, then restart Claude Code.
