Skip to content
MCP server

Screener Stock Research

Indian stock research over Screener.in, NSE and MCX with 30 tools and a local notebook

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.6.0
Listing updated
3 days ago

About Screener Stock Research

Screener Stock Research is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Built for investors in Indian equities, this server turns a Claude session into a research desk covering BSE and NSE companies. It groups 30 tools into six areas: company research, stock screening, document analysis, corporate events, market and research notes, and portfolio tracking. Company research needs no login, while custom screens need a free Screener.in account.

Document analysis is the unusual part. Annual reports and earnings calls are processed with a local retrieval pipeline, so nothing leaves the machine. That feature needs the [ai] extra, which adds roughly 1 to 2 GB of dependencies; without it those tools return a not-installed error and the rest still works.

There are 15 pre-built screening themes, rule-based red-flag checks, bulk-deal and insider-trading lookups, and a local portfolio with live profit and loss.

Install

Run in a terminal

claude mcp add screener-mcp --env SCREENER_PASSWORD='<SCREENER_PASSWORD>' -- uvx screener-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "screener-mcp": {
      "command": "uvx",
      "args": [
        "screener-mcp"
      ],
      "env": {
        "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "screener-mcp": {
      "command": "uvx",
      "args": [
        "screener-mcp"
      ],
      "env": {
        "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "screener-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "screener-mcp"
      ],
      "env": {
        "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "screener-mcp": {
      "command": "uvx",
      "args": [
        "screener-mcp"
      ],
      "env": {
        "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "screener-mcp": {
      "command": "uvx",
      "args": [
        "screener-mcp"
      ],
      "env": {
        "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
      }
    }
  }
}

Configuration

  • SCREENER_USERNAMEScreener.in login email. Optional; without it only public data is available and fundamental screens are disabled.
  • SCREENER_PASSWORDScreener.in password. Optional; pair with SCREENER_USERNAME.

What it does

Company research
Financials with P/E and ROE history, shareholding, pledges and peer comparison.
Screens and themes
Custom, technical and 15 pre-built themed screens.
Local document analysis
Annual reports and earnings calls analysed on your own machine.
Corporate events
NSE announcements, bulk deals and insider trading.
Portfolio tracker
Add holdings and see live profit and loss.

Good for

  • Compare two listed companies on key ratios
  • Find low-debt, high-ROCE stocks in a sector
  • Summarize risks from an annual report
  • Review recent NSE announcements for a ticker
  • Keep research notes on a stock

Pricing

Open source

Free and open source; screening tools need a free Screener.in login

Prices change. Check logeshr15.github.io before you buy.

Screener Stock Research FAQ

Do I need an API key?

No. Company research needs none; a free Screener.in login is only for screening tools.

How do I install it?

With uvx, using the claude mcp add command in the README.

Is the full install heavy?

Yes, the [ai] extra adds about 1 to 2 GB; the lightweight install skips document analysis.

Does it send my documents anywhere?

Document analysis runs through a local pipeline.

Is Screener Stock Research free?

Yes. Screener Stock Research is open source, so you can use and self-host it for free.

How do I add Screener Stock Research to Claude Code?

Run this command in your terminal: claude mcp add screener-mcp --env SCREENER_PASSWORD='<SCREENER_PASSWORD>' -- uvx screener-mcp

What are the best alternatives to Screener Stock Research?

The closest alternatives to Screener Stock Research are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Screener Stock Research

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments