Skip to main content
Glama
screener-mcp-server

screener-mcp-server

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.ts likely need a small update.

  • Review Screener's Terms before heavy or commercial use.

Related MCP server: sfinance-mcp-server

Tools

Tool

What it does

screener_search_companies

Look up a company's Screener ID/URL by name or ticker

screener_get_company_overview

Key ratios (Market Cap, P/E, ROE, ROCE, etc.), About text, Pros/Cons

screener_get_financial_statement

Quarterly results, P&L, balance sheet, cash flow, or ratios — multi-year table

screener_get_peer_comparison

The peer-comparison table shown on a company's page

screener_run_custom_screen

Run a Screener query-builder screen (e.g. Market Capitalization > 500 AND Return on equity > 22) across the whole market

technical_get_indicator

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:TICKER format) 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 build

Run 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 start

Then 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 --watch

If 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 tools
screener_get_company_overviewGet Company Overview from Screener.inA
Read-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.inA
Read-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.inA
Read-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.inA
Read-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.inA
Read-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

    A4.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct aspect: company overview, financial statements, peer comparison, custom screening, and company search. No functional overlap; descriptions clearly differentiate them.

    Naming Consistency5/5

    All tool names follow the 'screener_verb_noun' pattern (e.g., screener_get_company_overview, screener_search_companies). Naming is uniform and predictable.

    Tool Count5/5

    With 5 tools, the server covers the essential functionalities for fundamental stock analysis without excess or deficiency. Each tool earns its place.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for screening Indian stocks and mutual funds by wrapping screener.in and Morningstar India, enabling fundamental queries from Claude or Cursor.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • A
      license
      A
      quality
      D
      maintenance
      MCP server providing fundamental and technical data on Indian-listed companies from Screener.in and Yahoo Finance, including financial statements, ratios, and technical indicators.
      12
      MIT