screener-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SCREENER_PASSWORD | No | Non-interactive login, for CI/headless. Used with SCREENER_USERNAME. | |
| SCREENER_USERNAME | No | Non-interactive login, for CI/headless. Used with SCREENER_PASSWORD. | |
| SCREENER_SESSION_ID | No | Use this cookie instead of the stored session. Overrides the file, so login can't replace an expired value here | |
| SCREENER_USER_AGENT | No | Override the User-Agent sent to Screener | |
| SCREENER_MCP_CONFIG_DIR | No | Override where the session, browser profile and universe cache are stored | |
| SCREENER_PLAYWRIGHT_PATH | No | Path to a playwright module dir, if it isn't in cwd or the global npm root | |
| SCREENER_BROWSER_HEADLESS | No | Run browser login headless. Only refreshes an already signed-in profile — it cannot complete a first-time sign-in | |
| SCREENER_BROWSER_EXECUTABLE | No | Path to the browser to use for --chrome or --browser | |
| SCREENER_UNIVERSE_TTL_HOURS | No | How long screen_stocks reuses its cached sweep (default 12) | 12 |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_fundamentalsA | Key ratios scorecard for an Indian stock (P/E, P/B, ROE, ROCE, market cap, dividend yield, etc.), plus pros/cons and a short about, from Screener.in. |
| get_financialsB | Financial statement tables (quarterly results, P&L, balance sheet, cash flow, ratios, shareholding) for an Indian stock, from Screener.in. |
| get_peersB | Sector peer comparison table for an Indian stock (peers with P/E, ROE, market cap, etc.), from Screener.in. |
| get_chartA | Time-series for an Indian stock from Screener.in's chart API. Metric examples: 'Price-DMA50-Volume', 'Price', 'Quarter Sales', 'EPS'. days: lookback window. |
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 4 tools
The four tools target distinct data resources: financial statements, peer comparison, chart time-series, and fundamentals scorecard. get_financials vs get_fundamentals have some descriptive overlap (both include ratios), but their descriptions are distinct enough to typically select correctly.
All tools follow a consistent get_noun pattern with clear camelCase-free snake_case naming. Each name clearly indicates retrieving a specific resource type.
Four tools is on the low end for a general stock screener/research server. It feels somewhat thin for a 'screener' purpose, which typically expects searching/screening functionality in addition to viewing a single stock's data.
The server covers data retrieval for a single stock but is missing obvious screening/search capabilities despite the 'screener' name. There's no way to search stocks by criteria, scan the market, or discover tickers—significant gaps for the stated screener purpose.