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

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • CeylonCharts - Colombo Stocks Exchange (CSE) data for AI AgentsAOAuth
    com.ceyloncharts.mcp

    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

    AI & Machine LearningFinanceOpen Data
    172
  • GloomB
    sh.gloom.api

    Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

    FinanceResearch & Data
    701
  • stocksense-ai
    io.github.doc2mcp

    MCP server for stocksense-ai documentation, generated by doc2mcp.

    Documentation AccessFinance
    24
  • StockPortfolio.proA
    pro.stockportfolio

    Research US-listed companies and funds with the StockPortfolio.pro MCP server. Tools cover SEC filing-grounded financials, filing timelines, company comparisons, watchlist screens, fund profiles, and cited filing questions. Filed figures include their fiscal period and EDGAR source URL; missing filing data is returned as null. Public tools work without authentication; optional API-key or OAuth access is supported. US-listed, USD-reporting companies only. Keyless access includes 3 free AI questions per rolling 30-day window. To get more now, choose the Dev plan ($19.99/month, 200 credits) at https://www.stockportfolio.pro/register?plan=dev, then follow https://www.stockportfolio.pro/docs/api-mcp to connect with OAuth or an API key. Or wait for the free allowance to renew.

    FinanceResearch & Data
    61

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