screener-mcp-server
This server lets you research Indian listed stocks by pulling fundamental data from Screener.in and technical indicators via Yahoo Finance.
Search for companies: Look up a company's Screener ID/URL by name or ticker symbol (e.g. "TCS", "HDFC Bank") — useful before calling other tools.
Get company overview: Fetch key ratios (Market Cap, P/E, ROE, ROCE, Book Value, Dividend Yield, etc.), a short "About" description, and Screener's auto-generated Pros/Cons list.
Get financial statements: Retrieve multi-period tables — quarterly results, annual P&L, balance sheet, cash flow, or efficiency ratios — spanning multiple years.
Get peer comparison: Pull the industry peer-comparison table, benchmarking a company against sector peers on metrics like CMP, P/E, market cap, and ROE.
Run custom stock screens: Filter the entire Indian listed universe using Screener.in's query syntax (e.g.
Market Capitalization > 500 AND Return on equity > 22) to find stocks matching your criteria.Calculate technical indicators: Compute RSI (Wilder's method), SMA, EMA, or MACD (12/26/9) for any NSE/BSE stock using historical price data from Yahoo Finance — no API key required.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@screener-mcp-server search for Infosys"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
screener-mcp-server
An MCP server for Screener.in — search Indian listed companies, pull key ratios, multi-year financial statements, peer comparisons, and run custom fundamental screens, all from Claude (or any MCP client).
Important: no official API
Screener.in explicitly states they don't provide an API — only CSV export from the UI. This server works by reading the same public, signed-out pages a browser would see (search, company pages, and the /screen/raw/ query endpoint). It does not require login for the core tools.
Because this isn't an official API:
Please keep request volume reasonable — the server throttles and caches requests for you (5 min cache, ~600ms min gap between requests), don't work around that.
Guest (logged-out) access to custom screens is capped by Screener to a small number of result rows. If you want more rows or CSV-export-only data, set
SCREENER_SESSION_COOKIE(see below) to a cookie from your own logged-in session.Screener's HTML structure can change without notice; if a tool starts erroring, the CSS selectors in
src/services/scraper.tslikely need a small update.Review Screener's Terms before heavy or commercial use.
Related MCP server: sfinance-mcp-server
Tools
Tool | What it does |
| Look up a company's Screener ID/URL by name or ticker |
| Key ratios (Market Cap, P/E, ROE, ROCE, etc.), About text, Pros/Cons |
| Quarterly results, P&L, balance sheet, cash flow, or ratios — multi-year table |
| The peer-comparison table shown on a company's page |
| Run a Screener query-builder screen (e.g. |
| RSI, SMA, EMA, or MACD for an NSE/BSE stock, via Alpha Vantage |
Why compute indicators ourselves instead of using Groww or Alpha Vantage?
Groww's official MCP (
mcp.groww.in) is account-linked via OAuth (it's built to read your portfolio/trades). Folding it into this server would mean building a full OAuth pass-through proxy — a much bigger project, and unnecessary for public technicals like RSI.Alpha Vantage's NSE/BSE coverage (
NSE:TICKERformat) turned out to be unreliable in practice — it often only returns NASDAQ data despite documentation claiming Indian exchange support.
Instead, technical_get_indicator pulls raw historical close prices from Yahoo Finance's public chart endpoint (ticker + .NS/.BO suffix — the same data source most community NSE tooling, like yfinance, relies on) and computes RSI (Wilder's method), SMA, EMA, and MACD (12/26/9) server-side using standard formulas. No API key, no OAuth, no external rate limits — just one more tool in the same connector.
Since this is an unofficial-but-widely-used endpoint (not a documented Yahoo API), if it ever breaks, check src/services/yahoo.ts — the fix is usually just adjusting the URL or response shape to match Yahoo's current chart endpoint.
Setup
npm install
npm run buildRun locally (stdio) — for Claude Desktop / Claude Code
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"screener": {
"command": "node",
"args": ["/absolute/path/to/screener-mcp-server/dist/index.js"]
}
}
}Run as a remote HTTP server
TRANSPORT=http PORT=3000 npm startThen point your MCP client at http://localhost:3000/mcp.
Optional: logged-in session for more screen results
export SCREENER_SESSION_COOKIE="csrftoken=...; sessionid=..."Grab this from your browser's DevTools → Network tab → any request to screener.in → Cookie request header, while logged into your own Screener account. Never share this value; it's your personal session.
Development
npm run dev # tsc --watchIf Screener changes their page markup and a tool starts failing, check the selectors in src/services/scraper.ts (#top-ratios, .pros/.cons, #profit-loss/#balance-sheet/etc. table sections, #peers table) against the current HTML.
Available Tools
5 toolsscreener_get_company_overviewGet Company Overview from Screener.inARead-onlyIdempotent
Fetch a company's snapshot from its Screener.in page: key ratios (Market Cap, Current Price, Stock P/E, Book Value, Dividend Yield, ROCE, ROE, Face Value, etc.), a short "About" description, and Screener's machine-generated Pros/Cons list.
This does NOT include multi-year financial statements — use screener_get_financial_statement for those, or screener_get_peer_comparison for peer benchmarking.
Args:
identifier (string): Ticker (e.g. "TCS"), company name (e.g. "Tata Consultancy Services"), or a screener.in company URL/path. If unsure of the exact match, call screener_search_companies first.
consolidated (boolean, default true): Consolidated (with subsidiaries) vs standalone financials.
Returns: JSON: { "name": string, "screenerUrl": string, "aboutText": string|null, "topRatios": [{name, value}], "pros": string[], "cons": string[] }
Examples:
Use when: "What's TCS's current P/E and ROE?" -> identifier="TCS"
Don't use when: You need 10 years of quarterly revenue (use screener_get_financial_statement instead)
Error Handling:
Returns an error if no matching company is found — try screener_search_companies to confirm the right name/ticker first.
Inputs: identifier (required), consolidated.
screener_get_financial_statementGet Financial Statement from Screener.inARead-onlyIdempotent
Fetch a multi-period financial statement table for a company from Screener.in: quarterly results, annual profit & loss, balance sheet, cash flow, or per-year efficiency ratios.
Args:
identifier (string): Ticker, company name, or screener.in URL/path.
statement (enum): One of "quarters", "profit-loss", "balance-sheet", "cash-flow", "ratios".
consolidated (boolean, default true): Consolidated vs standalone.
Returns: JSON: { "section": string, "periods": string[], "rows": [{ "label": string, "values": string[] }] } Each row's values align positionally with "periods".
Examples:
Use when: "Show me TCS's last few years of profit & loss" -> identifier="TCS", statement="profit-loss"
Use when: "What's Infosys's debtor days trend?" -> identifier="INFY", statement="ratios"
Don't use when: You just want current P/E or market cap (use screener_get_company_overview)
Error Handling:
Returns an error if the statement section isn't present for that company (e.g. some companies don't report all statements) or if the company can't be found.
Inputs: statement (required), identifier (required), consolidated.
screener_get_peer_comparisonGet Peer Comparison from Screener.inARead-onlyIdempotent
Fetch the peer-comparison table Screener.in shows on a company's page — the same industry peers, compared on CMP, P/E, market cap, ROE, and other columns Screener selects.
Args:
identifier (string): Ticker, company name, or screener.in URL/path.
consolidated (boolean, default true): Consolidated vs standalone.
Returns: JSON: { "columns": string[], "peers": [{ "name": string, "values": { [column]: string } }] }
Examples:
Use when: "How does TCS compare to its industry peers on P/E and ROE?" -> identifier="TCS"
Don't use when: You want a custom peer set with your own filter criteria (use screener_run_custom_screen instead)
Error Handling:
Returns an error if no peer table is found for the company (uncommon, but can happen for delisted or very niche companies).
Inputs: identifier (required), consolidated.
screener_run_custom_screenRun a Custom Stock Screen on Screener.inARead-onlyIdempotent
Run a custom stock screen using Screener.in's query-builder syntax against 10+ years of financial data for all listed Indian companies, and return the matching companies.
This is the core "screener" feature — filter the whole market by fundamental criteria in one call, instead of checking companies one by one.
Args:
query (string): Screener query syntax. Combine conditions with AND/OR. Examples: "Market Capitalization > 500 AND Return on capital employed > 22" "Price to Earning < 15 AND Debt to equity < 0.5 AND Sales growth 3Years > 10" Common fields: Market Capitalization, Current Price, Price to Earning, Return on equity, Return on capital employed, Debt to equity, Sales growth, Profit growth, Dividend yield, Book value, Promoter holding.
limit (number, 1-100, default 25): Max rows to return. Note: without a logged-in session (SCREENER_SESSION_COOKIE env var), Screener itself caps guest results to a small number regardless of this limit.
Returns: JSON: { "columns": string[], "rows": [{name, values}], "totalFound": number|null, "truncated": boolean }
Examples:
Use when: "Find small-cap companies with ROE > 20% and low debt" -> query="Market Capitalization < 5000 AND Return on equity > 20 AND Debt to equity < 0.3"
Don't use when: You want data for one specific known company (use screener_get_company_overview instead)
Error Handling:
Returns "Error: Screener rejected this query: ..." if the query syntax is invalid — check field names and operators.
If truncated=true and totalFound is much larger than what's returned, note that a logged-in session would unlock more rows.
Inputs: query (required), limit.
screener_search_companiesSearch Companies on Screener.inARead-onlyIdempotent
Search Screener.in for listed Indian companies by name or ticker symbol.
Use this first when you're not sure of a company's exact ticker or how Screener.in identifies it — the result's "id" or "url" can be passed as the identifier to the other screener_* tools.
Args:
query (string): Company name or ticker, e.g. "TCS", "Infosys", "HDFC Bank"
Returns: JSON with a "results" array, each item having: { "id": string, "name": string, "url": string (relative screener.in path) }
Examples:
Use when: "Find the ticker for Tata Consultancy Services" -> query="Tata Consultancy"
Don't use when: You already have the exact ticker (just call screener_get_company_overview directly)
Error Handling:
Returns an empty "results" array if nothing matches
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct aspect: company overview, financial statements, peer comparison, custom screening, and company search. No functional overlap; descriptions clearly differentiate them.
All tool names follow the 'screener_verb_noun' pattern (e.g., screener_get_company_overview, screener_search_companies). Naming is uniform and predictable.
With 5 tools, the server covers the essential functionalities for fundamental stock analysis without excess or deficiency. Each tool earns its place.
The tool set covers all major Screener.in features: company snapshot, multi-period financials, peer comparison, custom screening, and search. No obvious gaps for the intended domain.
Maintenance
Related MCP Connectors
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server for stocksense-ai documentation, generated by doc2mcp.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for screening Indian stocks and mutual funds by wrapping screener.in and Morningstar India, enabling fundamental queries from Claude or Cursor.-
- FlicenseNot gradedqualityDmaintenanceProvides access to Indian stock market data via screener.in, enabling stock analysis, document access, screening, and more through MCP.-
- AlicenseNot gradedqualityDmaintenanceMCP server that provides access to screener.in financial data for Indian stocks, enabling queries for company info, financials, ratios, quarterly results, shareholding, and stock screening.MIT
- AlicenseAqualityDmaintenanceMCP server providing fundamental and technical data on Indian-listed companies from Screener.in and Yahoo Finance, including financial statements, ratios, and technical indicators.12MIT