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-pro Show me the financial snapshot for HDFC Bank"
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.
An MCP server that gives an LLM (e.g. Claude) rich, structured data on Indian-listed companies: fundamentals and financial statements scraped from Screener.in, plus price-based technical indicators from Yahoo Finance. Built for deep, one-stock-at-a-time research — ratios, multi-year financials, shareholding trends, peer comparisons, annual reports/credit ratings/concall links, and SMA/RSI/ATR — in a single tool call.
Not affiliated with screener.in or Yahoo Finance.
Tool | What it returns | Login needed? |
| Everything below, in one call | No |
| P/E, book value, ROE, ROCE, market cap, dividend yield, About, pros/cons | No |
| Quarterly sales/profit table | No |
| Multi-year P&L with compounded growth | No |
| Multi-year balance sheet | No |
| Multi-year cash flow, incl. free cash flow | No |
| Promoter/FII/DII/govt/public % trend | No |
| Peer CMP/P/E/market cap/ROCE table | No |
| Announcements, annual reports, credit ratings, concall links | No |
| Headcount, $100M+ clients, revenue mix by geography/vertical, TCV, attrition | Yes (see below) |
| SMA20/50/200, RSI14, ATR14, 52w high/low (Yahoo Finance) | No |
| Diagnostic: are credentials configured, did login succeed | N/A |
Related MCP server: india-stock-mcp
claude mcp add screener-pro -- uvx --from git+https://github.com/vidyasagardivi9/screener-mcp-pro- screener-mcp-pro(Registered as screener-pro so it doesn't collide with any other screener MCP server you may already have.)
Every tool above except screener_get_company_insights works with zero configuration — screener.in serves company
pages, financial statements, peer data, and documents publicly. The Insights section (headcount, client counts,
revenue mix, etc.) is different: screener.in only sends those numbers to logged-in sessions. If you want that tool to
return real values instead of just the metric names, register with your own credentials:
claude mcp add screener-pro -e SCREENER_USERNAME=you@example.com -e SCREENER_PASSWORD=your_password \
-- uvx --from git+https://github.com/vidyasagardivi9/screener-mcp-pro- screener-mcp-proCredentials are read only from these environment variables, kept in an in-memory cookie jar for the process's
lifetime, and never written to disk or logged. See .env.example for all supported variables.
No company-search tool. screener.in's robots.txt disallows crawling its ?q= search endpoint, so every tool
takes an explicit symbol (the screener.in slug, normally identical to the NSE trading symbol — e.g. TCS,
INFY, RELIANCE). Resolve the ticker yourself or let the calling LLM infer it from general knowledge.
Scraping-based, not an official API. Parsers degrade gracefully (partial results plus a warnings list) if
screener.in changes its page structure, but they can still break. tests/test_parsers.py runs against saved HTML
fixtures to catch regressions early — if screener.in changes its markup, update the fixtures and parsers together.
screener_get_company_insights values are genuinely locked without login — this isn't a scraping trick to get
around, screener.in simply doesn't send the numbers to anonymous requests. With valid credentials and a successful
login, the tool currently still reports metric names only (numeric-value parsing for the authenticated table layout
is a follow-up, since it couldn't be verified without a live logged-in session during development).
Respectful by design: a single shared HTTP client, a descriptive User-Agent, retry/backoff only on
429/5xx/timeouts, a configurable minimum delay between requests (default 1.5s), and a defense-in-depth check
(robots.py) against screener.in's robots.txt disallow rules. No CAPTCHA or bot-detection bypass of any kind.
Intended for personal/educational use consistent with screener.in's terms and your own account's usage limits — not a redistribution or resale of screener.in's data.
uv sync
uv run pytest
uv run screener-mcp-pro # runs the server over stdioTo inspect tools interactively:
npx @modelcontextprotocol/inspector uv run screener-mcp-proMIT — see LICENSE.
Multi-year balance sheet: equity, reserves, borrowings, assets.
Inputs: symbol (required), consolidated, response_format. Returns: result
Multi-year cash flow statement: operating/investing/financing activity, free cash flow.
Inputs: symbol (required), consolidated, response_format. Returns: result
Headcount, $100M+ client counts, revenue mix by geography/vertical, TCV, attrition, and similar operational metrics. NOTE: screener.in only sends the actual numbers to logged-in sessions -- without SCREENER_USERNAME/SCREENER_PASSWORD configured (or if login fails), this returns the available metric names only, with values locked.
Inputs: symbol (required), consolidated, response_format. Returns: result
Key ratios (P/E, book value, ROE, ROCE, market cap, dividend yield), the company's About text, and its pros/cons checklist from screener.in.
Inputs: symbol (required), consolidated, response_format. Returns: result
Links to recent announcements, annual reports, credit rating updates, and concall transcripts/presentations/recordings.
Inputs: symbol (required), consolidated, response_format. Returns: result
Everything in one call: overview, all financial statements, shareholding, peer comparison, documents, and insights for a company. Use this for a full analysis; use the individual tools when you only need one section.
Inputs: symbol (required), consolidated, response_format. Returns: result
Peer comparison table: CMP, P/E, market cap, dividend yield, quarterly profit/sales and growth, ROCE for the company and its industry peers.
Inputs: symbol (required), consolidated, response_format. Returns: result
Multi-year Profit & Loss statement including compounded growth rows.
Inputs: symbol (required), consolidated, response_format. Returns: result
Quarterly sales, expenses, operating profit, and net profit table.
Inputs: symbol (required), consolidated, response_format. Returns: result
SMA20/50/200, RSI14, ATR14, and price-vs-SMA flags from free Yahoo Finance daily price history. No login required.
Inputs: symbol (required), period, exchange, response_format. Returns: result
Diagnostic: whether Screener.in credentials are configured and whether login succeeded. Never exposes the credentials themselves.
Inputs: no named parameters. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
Each tool targets a specific financial statement or aspect (balance sheet, cash flow, shareholding, etc.) with no overlap. The full snapshot tool aggregates everything but is distinct.
All tools follow a consistent pattern: 'screener_get_' followed by a descriptive noun phrase (e.g., 'balance_sheet', 'company_insights'). No mixing of conventions.
12 tools cover the essential financial data retrieval needs for a company analysis server. Each tool serves a clear purpose without redundancy.
The tool set covers all major financial statements, peer comparison, ownership, technical indicators, and a composite snapshot. No obvious gaps for fundamental analysis.
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
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
Stock analysis MCP: 38 indicators, 7 optimizers, 8 backtests, US + India sectors.
