# Screener Stock Research

> Screener Stock Research is an open-source MCP server for finance and payments. Indian stock research over Screener.in, NSE and MCX with 30 tools and a local notebook. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://logeshr15.github.io/screener-mcp/
- **Repository:** https://github.com/logeshr15/screener-mcp
- **MCP Registry name:** io.github.LogeshR15/screener-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/screener-stock-research
