# india-stock-mcp

Gives your agent NSE and BSE quotes, company fundamentals, mutual fund NAV, option chains and IPO lists. No API keys required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Akhilgovind02
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Akhilgovind02/india-stock-mcp
- Updated: 2026-06-12
- HTML: https://affpapa.org/en/nevibecode/mcp/india-stock-mcp

## What it does

The server exposes 16 tools. `get_quote` returns price, volume and the 52-week range, while `get_historical` pulls OHLCV history by day, week or month. You also get symbol lookup by company name, fundamentals such as P/E, EPS, ROE, margins and debt, side-by-side comparison of two to five stocks, and index data for any NSE index plus SENSEX.

Funds and derivatives sit in their own group. `search_funds` looks up Indian mutual fund schemes, `get_fund_nav` returns NAV history, and `compare_funds` lines up two to four funds by return over a chosen period. `get_options_chain` builds the chain around the ATM strike with LTP, open interest, its change and implied volatility. `portfolio_summary` turns holdings into current value, P&L and an allocation breakdown.

Node.js 22 is the only prerequisite — the data sources are free and there is no auth. Quotes come from Yahoo Finance, NSE India and mfapi.in, so they can lag by a few minutes; live trading decisions are out of scope. Some NSE endpoints are no longer publicly reachable and the server falls back to Yahoo on its own. Heavy use can get you rate-limited or blocked by NSE. The NIFTY 50 list behind `get_gainers_losers` is hardcoded as `NIFTY50_SYMBOLS` in `src/index.ts`, and since NSE reconstitutes the index roughly twice a year, that list needs a manual update when it happens.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add india-stock-mcp -- npx -y india-stock-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add india-stock-mcp -- npx -y india-stock-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "india-stock-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "india-stock-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "india-stock-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "india-stock-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add india-stock-mcp npx -y india-stock-mcp
```

## When to use it
- check a stock quote and how far it sits from its 52-week high
- compare fundamentals across two or three banks
- find the top NIFTY 50 gainers for the day
- see where open interest clusters in the NIFTY option chain
- value a portfolio from a list of holdings and buy prices

## Example prompts
- Compare HDFC Bank vs ICICI Bank vs SBI fundamentals
- NIFTY option chain — where's the max open interest?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

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