# Screener Stock Research

The Screener Stock Research MCP server for Claude Code researches Indian stocks using company financials, market screens and exchange updates. Ask about a ticker, compare companies or filter stocks by criteria.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28 repo stars
- Author: LogeshR15
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LogeshR15/screener-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/screener-stock-research

## What it does

The server retrieves Indian company and market information through Screener.in, NSE and MCX. It can compare financial metrics, screen stocks, find analyst targets and news, and retrieve corporate announcements. It also supports questions about annual reports and earnings-call transcripts, plus a local portfolio tracker and research notes.

Fundamental screens require a free Screener.in account; technical-only screens do not. Installation uses `uv` and `uvx`. Claude Code receives Screener.in credentials through the `SCREENER_USERNAME` and `SCREENER_PASSWORD` environment variables.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `SCREENER_USERNAME`, `SCREENER_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SCREENER_USERNAME=<SCREENER_USERNAME> --env SCREENER_PASSWORD=<SCREENER_PASSWORD> --transport stdio screener-stock-research -- uvx screener-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add screener-stock-research --env SCREENER_USERNAME=<SCREENER_USERNAME> --env SCREENER_PASSWORD=<SCREENER_PASSWORD> -- uvx screener-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "screener-stock-research": {
            "command": "uvx",
            "args": [
                "screener-mcp"
            ],
            "env": {
                "SCREENER_USERNAME": "<SCREENER_USERNAME>",
                "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "screener-stock-research": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "screener-mcp"
            ],
            "env": {
                "SCREENER_USERNAME": "<SCREENER_USERNAME>",
                "SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SCREENER_USERNAME=<SCREENER_USERNAME> -e SCREENER_PASSWORD=<SCREENER_PASSWORD> screener-stock-research uvx screener-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>

## When to use it
- compare financial metrics across Indian companies
- screen stocks by debt and return-on-capital criteria
- find analyst targets, recent news and exchange announcements for a ticker
- pull risks from an annual report or earnings-call transcript
- track profit and loss for a local portfolio

## Example prompts
- Compare ITC and HINDUNILVR across their key financial metrics.
- Find stocks with low debt and high return on capital.
- What risks appear in Reliance's 2024 annual report?

## Similar
- [stock-screener](https://affpapa.org/en/nevibecode/skills/stock-screener.md) — skill · ★ 69 repo stars
- [Stock Screener](https://affpapa.org/en/nevibecode/mcp/stock-screener.md) — MCP server · ★ 424 repo stars
- [Tapetide - Indian Stock Market MCP](https://affpapa.org/en/nevibecode/mcp/tapetide-indian-stock-market-mcp.md) — MCP server · ★ 151 repo stars
- [canslim-screener](https://affpapa.org/en/nevibecode/skills/canslim-screener.md) — skill · 3900 installs
- [pair-trade-screener](https://affpapa.org/en/nevibecode/skills/pair-trade-screener.md) — skill · 3800 installs
- [HPSILab - Quant Finance MCP Server for Stock Analysis and Options Analytics](https://affpapa.org/en/nevibecode/mcp/hpsilab-quant-finance-mcp-server-for-stock-analysis-and-options-analytics.md) — MCP server · 796 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
