Skip to main content
Glama
india-stock-mcp

india-stock-mcp

india-stock-mcp

CI npm

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

Related MCP server: Indian Market MCP

Requirements

  • Node.js 22+

Setup

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

Available Tools

16 tools
compare_fundsA

Compare 2–4 mutual funds side by side: latest NAV and % return over the chosen period.

Inputs: scheme_codes (required), days.

compare_stocksA

Compare 2–5 stocks side by side: price, P/E, EPS, market cap, margins, growth rates.

Inputs: symbols (required).

get_corporate_actionsA

Get dividends, stock splits, bonus issues, and rights issues. Pass a symbol for one stock, or omit it for recent market-wide corporate actions.

Inputs: to, from, symbol.

get_fundamentalsA

Get fundamental financial data: P/E ratio, EPS, ROE, revenue, profit margins, debt, and more.

Inputs: symbol (required).

get_fund_detailsA

Get mutual fund details: fund house, category, current NAV. Includes Morningstar rating, expense ratio, and AUM when the rich data source is available.

Inputs: scheme_code (required).

get_fund_navA

Get NAV (Net Asset Value) history for a mutual fund scheme. Use search_funds first to get scheme code.

Inputs: scheme_code (required), limit.

get_gainers_losersA

Get top gainers or losers among NIFTY 50 stocks, ranked by % change (live Yahoo quotes).

Inputs: type (required), count.

get_historicalA

Get OHLCV historical price data for a stock. Returns date, open, high, low, close, volume.

Inputs: to (required), from (required), symbol (required), interval.

get_indexA

Get live data for a market index: price, change, P/E, P/B, year high/low, advances/declines. Available: NIFTY 50, NIFTY BANK, NIFTY IT, NIFTY MIDCAP 100, NIFTY SMALLCAP 100, NIFTY AUTO, NIFTY PHARMA, SENSEX, and all other NSE indices.

Inputs: index (required).

get_ipo_listA

Get list of current, upcoming, or recently listed (past 3 months) IPOs on NSE.

Inputs: type.

get_market_statusA

Check if NSE market is currently open or closed, and get trading session info.

Inputs: no named parameters.

get_options_chainA

Get F&O options chain for a stock or index: calls and puts around the ATM strike with last price, OI, OI change, IV, and volume. Works for NIFTY, BANKNIFTY, and F&O stocks like RELIANCE.

Inputs: symbol (required), expiry, strike_range.

get_quoteA

Get live price, volume, 52-week range, and basic stats for an NSE/BSE stock. Examples: RELIANCE, TCS, HDFCBANK, NIFTY 50 (index), ^NSEI (Nifty index code).

Inputs: symbol (required).

portfolio_summaryA

Analyze a stock portfolio. Pass holdings with buy price and quantity, get current value, P&L, allocation breakdown, and gain/loss per holding. Max 20 holdings.

Inputs: holdings (required).

search_fundsA

Search Indian mutual funds by name. Returns scheme codes and names for use with other fund tools.

Inputs: query (required).

search_symbolA

Search for a stock symbol by company name. Returns matching symbols with exchange info.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool targets a distinct domain or action: compare functions for stocks vs funds are separate; get_* tools for different data types (fundamentals, historical, quote, etc.); search tools for symbols and funds; portfolio summary is unique. No overlap.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (get_, compare_, search_) in lowercase snake_case. 'portfolio_summary' is the exception as it starts with a noun, but it remains descriptive and fits the overall style. The inconsistency is minor.

    Tool Count4/5

    With 16 tools covering stocks, mutual funds, indices, IPOs, market status, options, and portfolio analysis, the count is slightly high but well-justified for the breadth. It feels comprehensive without being excessive.

    Completeness4/5

    The tool set covers core data retrieval and analysis for stocks and mutual funds, including fundamentals, historical prices, comparisons, and portfolio summary. Missing areas like technical analysis or trading are likely out of scope. Minor gaps exist (e.g., no direct tool for stock screener), but overall it's thorough.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides comprehensive Indian stock market data from the NSE and BSE, including live quotes, historical trends, and fundamental analysis. Users can compare stock performance, track major indices, and access financial statements without the need for an API key.
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server for the Indian stock market, providing 68 tools for stocks, derivatives, mutual funds, commodities, and more without any API keys.
      68
      30 PyPI
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing real-time Indian stock market data through 15 tools, including stock details, historical data, market overview, and news. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients using an API key from IndianAPI.in.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for Indian stock market data — search companies, analyze fundamentals, compare stocks, browse sectors and screens.
      11
      -