How do I install India Stock?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does India Stock need an API key?

No required environment variable is listed on this record.

What transport does India Stock use?

India Stock runs locally over stdio.

When was India Stock last checked?

Last checked 2026-11-08. Indian stock market: NSE/BSE quotes, fundamentals, mutual fund NAV, F&O chains, IPOs. No API keys.

India Stock MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.akhilgovind02-india-stock-mcp -- npx -y india-stock-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.akhilgovind02-india-stock-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

india-stock-mcp

MCP server for Indian stock market data — NSE/BSE quotes, historical prices, fundamentals, mutual fund NAV, indices, corporate actions, F&O option chains, IPOs, and portfolio analysis.

Works with any MCP client: Claude Desktop, Claude Code, Cursor, etc. No API keys, no auth, all free data sources.

Tools (16)

Tool	What it does
`get_quote`	Live price, volume, 52-week range for NSE/BSE stocks and indices
`get_historical`	OHLCV history — daily / weekly / monthly
`search_symbol`	Find stock symbols by company name
`get_fundamentals`	P/E, EPS, ROE, margins, debt, growth rates
`compare_stocks`	2–5 stocks side by side
`get_index`	Any NSE index (P/E, P/B, advances/declines) + SENSEX
`get_market_status`	Is the market open? Session info per segment
`get_gainers_losers`	Top NIFTY 50 movers ranked by % change
`get_corporate_actions`	Dividends, splits, bonuses — per stock or market-wide
`get_options_chain`	F&O chain around ATM: LTP, OI, OI change, IV, volume
`get_ipo_list`	Current / upcoming / recently listed IPOs
`search_funds`	Search 15,000+ Indian mutual fund schemes
`get_fund_nav`	NAV history for a scheme
`get_fund_details`	Fund house, category, current NAV
`compare_funds`	2–4 funds: NAV + % return over any period
`portfolio_summary`	Holdings → current value, P&L, allocation breakdown

Requirements

Node.js 22+

Setup

Via npm (recommended)

No clone, no build:

Claude Code

claude mcp add india-stock -- npx -y india-stock-mcp

Claude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "india-stock": {
      "command": "npx",
      "args": ["-y", "india-stock-mcp"]
    }
  }
}

From source

git clone https://github.com/Akhilgovind02/india-stock-mcp.git
cd india-stock-mcp
npm install
npm run build
claude mcp add india-stock -- node /absolute/path/to/india-stock-mcp/dist/index.js

Restart Claude Desktop fully, then look for the tools icon in a new chat.

Example prompts

"Quote for RELIANCE and how far is it from its 52-week high?"
"Compare HDFC Bank vs ICICI Bank vs SBI fundamentals"
"Top 5 NIFTY 50 gainers today"
"NIFTY option chain — where's the max open interest?"
"Compare Parag Parikh Flexi Cap vs Quant Small Cap over 3 years"
"Analyze my portfolio: 10 RELIANCE @ 1200, 5 TCS @ 3000"

Development

npm run dev                      # run from TypeScript directly
npx tsx scripts/test-mcp.ts      # end-to-end test of all 16 tools (live data)
npx tsx scripts/test-edge.ts     # 24 edge-case assertions
npm run build                    # compile to dist/

Sample test output

Real output from npx tsx scripts/test-mcp.ts (live data, market hours, June 2026 — trimmed):

TOOLS: get_quote, get_historical, search_symbol, search_funds, get_fund_nav,
get_fundamentals, compare_stocks, get_index, get_market_status, get_gainers_losers,
get_corporate_actions, get_options_chain, get_ipo_list, get_fund_details,
compare_funds, portfolio_summary

PASS get_quote: {"source":"Yahoo Finance","symbol":"RELIANCE.NS","name":"RELIANCE
  INDUSTRIES LTD","price":1266,"changePct":0.23,"volume":6107188,...}
PASS get_index: {"source":"NSE","index":"NIFTY BANK","last":55915,"percentChange":1.34,
  "yearHigh":61764.85,"pe":...}
PASS get_market_status: [{"market":"Capital Market","marketStatus":"Open",...}]
PASS get_gainers_losers: {"type":"gainers","universe":"NIFTY 50","data":[{"symbol":
  "SHRIRAMFIN","changePct":3.17,...}]}
PASS get_corporate_actions: {"symbol":"RELIANCE","actions":[{"subject":"Dividend -
  Rs 5.5 Per Share","exDate":"14-Aug-2025",...}]}
PASS get_options_chain: {"symbol":"NIFTY","underlyingValue":23331,"atmStrike":23350,
  "availableExpiries":["16-Jun-2026",...],"data":[{"strikePrice":...,"CE":{"lastPrice":
  130.95,"openInterest":144769,"impliedVolatility":12.26},...}]}
PASS get_ipo_list: {"type":"current","ipos":[{"companyName":"Utkal Speciality
  Industries India Limited","status":"Active",...}]}
PASS compare_funds: {"comparison":[{"name":"Parag Parikh Flexi Cap Fund - Direct
  Plan - Growth","latestNAV":88.484,...}]}
PASS portfolio_summary: {"summary":{"totalInvested":41000,"totalCurrentValue":38663,
  "totalPnL":-2337,"totalPnLPct":-5.7,...}}

... all 16 tools PASS

Data sources

Source	Used for	Notes
Yahoo Finance (`yahoo-finance2`)	Quotes, history, fundamentals, search	Primary source, may be delayed a few minutes
NSE India (`nse-bse-api`)	Market status, indices, corporate actions, IPOs, option chains	Some NSE endpoints (quote, autocomplete) are no longer publicly accessible — the server falls back to Yahoo automatically
mfapi.in	Mutual fund NAV and search	Free, occasionally flaky — requests retry once
mfdata.in	Fund ratings / expense ratio	Often unreachable; falls back to mfapi.in

Known limitations

get_gainers_losers ranks a built-in NIFTY 50 constituent list (verified June 2026). NSE reconstitutes the index ~2×/year — update NIFTY50_SYMBOLS in src/index.ts when that happens.
Quotes may be delayed (Yahoo free feed); not suitable for live trading decisions.
NSE may rate-limit or block heavy usage.

Disclaimer

Data comes from free public sources and may be delayed, incomplete, or wrong. This is not financial advice and not a substitute for a licensed broker or advisor. Do your own research before trading or investing.

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install India Stock?

Does India Stock need an API key?

What transport does India Stock use?

When was India Stock last checked?

Documentation

india-stock-mcp

Tools (16)

Requirements

Setup

Via npm (recommended)

From source

Example prompts

Development

Sample test output

Data sources

Known limitations

Disclaimer

License