Screener India MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SCREENER_EMAIL | No | Login email for Screener.in, used only for headless Linux without a keyring. Company data works without an account; screens need a (free) Screener.in login. Normally the password lives in your OS secure store (Windows Credential Manager / macOS Keychain / Linux Secret Service). | |
| SCREENER_PASSWORD | No | Login password for Screener.in, used only for headless Linux without a keyring (less safe than the OS keyring). The password is never printed, logged or sent anywhere except Screener's own login form. | |
| SCREENER_CACHE_DIR | No | Directory for the local page cache (company pages 6 h, prices 3 h, search 7 days). OS defaults are used if unset. | |
| SCREENER_STATE_DIR | No | Directory for the machine-wide governor state (request spacing, daily budget, cool-down). OS defaults are used if unset. | |
| SCREENER_DAILY_BUDGET | No | Requests per day with login. Can only make the server more polite, never less: max 1000. Default 300. | 300 |
| SCREENER_MIN_INTERVAL | No | Seconds between requests. Can only make the server more polite, never less: never below 2 s. Default 3 s. | 3 |
| SCREENER_DAILY_BUDGET_ANON | No | Requests per day without login. Can only make the server more polite, never less: max 60. Default 40. | 40 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_companyA | Find a company's Screener.in symbol from its name or part of its ticker (e.g. "caplin", "hdfc bank"). |
| company_snapshotA | Best first call. One request gives: key ratios, sector/industry, pros/cons, compounded growth,
8-quarter earnings trend, deterministic red-flag checks, latest shareholding and recent documents.
|
| company_overviewB | Key ratios (market cap, P/E, book value, ROCE, ROE, 52-week range…), about, sector/industry, pros/cons and 10/5/3-year compounded growth. view: auto | consolidated | standalone. |
| financial_statementC | A full statement as periods × rows. statement: quarters | profit_loss | balance_sheet | cash_flow | ratios. periods: keep only the latest N columns (0 = all). |
| earnings_trendB | Quarterly sales/profit/margin/EPS with year-on-year growth and whether growth is accelerating, steady or decelerating. |
| red_flagsB | Twelve fixed, explainable checks on reported numbers: cash conversion, debtor/inventory days, other-income share, leverage, debt vs sales growth, profit vs sales growth, falling returns, promoter selling, low tax, CWIP build-up, share-capital increase. Each with evidence. |
| shareholdingB | Promoter / FII / DII / government / public holding history. period: quarterly | yearly. |
| documentsB | Links to exchange announcements, annual reports, credit ratings and concall transcripts / presentations / recordings. kind: all | announcements | annual_reports | credit_ratings | concalls. |
| peersB | Peer comparison table for the company's industry (price, P/E, market cap, quarterly growth, ROCE). |
| price_historyC | Daily history. metric: price (with 50/200-day averages and volume) | pe | margins | ev_ebitda | pb | mcap_sales. days snaps to 30, 90, 180, 365, 1095, 1825, 3652 or 10000. |
| compare_companiesB | Side-by-side valuation, returns, margins and growth for 2–6 companies. |
| run_screenA | Run a Screener.in query, e.g. "Return on capital employed > 20 AND Debt to equity < 0.3".
Needs a Screener.in login set up once with |
| theme_screenA | Ready-made screens (quality compounders, earnings acceleration, margin expansion, turnaround…). Call with no theme to list them. Needs a login like run_screen. |
| service_statusB | Login state, requests used/remaining today, cool-down status and cache size. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Most tools are conceptually distinct, but company_snapshot duplicates data from company_overview, earnings_trend, red_flags, shareholding, and documents, so agents must infer when to use summary vs detail. Descriptions label snapshot as the best first call, which helps, but boundaries remain fuzzy.
All names use snake_case, but the pattern mixes verb_noun (search_company, compare_companies, run_screen) with noun phrases (company_snapshot, financial_statement, shareholding, peers). Readable but not a predictable single convention.
14 tools is reasonable for a comprehensive financial research server and sits in the recommended range, though the aggregate snapshot plus several overlapping detail tools makes the set slightly redundant.
The toolset covers the full research workflow: symbol lookup, snapshot/overview, statements, trends, red flags, shareholding, documents, peers, price history, comparisons, and both custom and themed screening. No obvious lifecycle gaps for the stated Screener.in domain.