Skip to main content
Glama
aryamanw

screener-mcp

by aryamanw
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

screener-mcp

MCP server for Screener.in financial data — Indian stock market fundamentals, ratios, quarterly results, shareholding, and peer comparison.

Install

pip install git+https://github.com/aw-bii/mcp-screener.git

To update to the latest version:

pip install --force-reinstall git+https://github.com/aw-bii/mcp-screener.git

Related MCP server: sfinance-mcp-server

Configuration

  1. Log into screener.in in your browser

  2. Open DevTools (F12) → Application → Cookies → screener.in → copy the sessionid value

  3. Add to your MCP client config:

{
  "mcpServers": {
    "screener-mcp": {
      "command": "screener-mcp",
      "env": {
        "SCREENER_SESSION_ID": "your_session_id_here"
      }
    }
  }
}

Without a session ID, all company data tools work. A session ID unlocks peer comparison data.

Tools

Tool

Description

get_company_info

Company profile, BSE/NSE codes, market cap, P/E, book value

get_financials

P&L, balance sheet, cash flow

get_quarterly_results

Quarterly sales/profit/margins

get_trading_multiples

Market Cap, CMP, High/Low, P/E, P/B, Dividend Yield, ROCE, ROE

get_ratios

ROCE, ROE, OPM, NPM, D/E, current ratio, etc.

get_shareholding

Promoter, FII, DII trends

get_peers

All companies in the same industry with key financials

Development

git clone https://github.com/aw-bii/mcp-screener.git
cd mcp-screener
pip install -e .
screener-mcp
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • NSE/BSE MCP Server

    vanshikaaa01
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that provides comprehensive Indian stock market data from the NSE and BSE, including live quotes, historical trends, and fundamental analysis. Users can compare stock performance, track major indices, and access financial statements without the need for an API key.
    2
    MIT

  • screener-mcp-pro

    vidyasagardivi9
    A
    license
    A
    quality
    C
    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