MCP.Market

India Stock MCP server

by Akhilgovind02·io.github.Akhilgovind02/india-stock-mcp·v1.0.1·5 stars
No reviews yet

Indian stock market: NSE/BSE quotes, fundamentals, mutual fund NAV, F&O chains, IPOs. No API keys.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

5 stars60 downloads/wk

Reviews

Write one

Nobody has reviewed India Stock yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

India Stock tools (16)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compare_funds

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

  • compare_stocks

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

  • get_corporate_actions

    Get dividends, stock splits, bonus issues, and rights issues. Pass a symbol for one stock,

  • get_fund_details

    Get mutual fund details: fund house, category, current NAV. Includes Morningstar rating,

  • get_fund_nav

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

  • get_fundamentals

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

  • get_gainers_losers

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

  • get_historical

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

  • get_index

    Get live data for a market index: price, change, P/E, P/B, year high/low, advances/declines.

  • get_ipo_list

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

  • get_market_status

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

  • get_options_chain

    Get F&O options chain for a stock or index: calls and puts around the ATM strike with

  • get_quote

    Get live price, volume, 52-week range, and basic stats for an NSE/BSE stock.

  • portfolio_summary

    Analyze a stock portfolio. Pass holdings with buy price and quantity, get current value,

  • search_funds

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

  • search_symbol

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

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan9 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 107 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How India Stock compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 73% of 1,761 Finance servers
Tools
16
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
5
more than 86% of 946 Finance servers
Downloads a week
60
more than 55% of 421 Finance servers with a package

What its tools let an agent do: 16 read

Install India Stock in Claude Code, Cursor or VS Code

Runs npx -y india-stock-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add india-stock-mcp -- npx -y india-stock-mcp
Add to Cursor

What the publisher says

From the India Stock repository's README, as published. We do not edit it. Read it on GitHub

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)

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

India Stock: common questions

Is India Stock MCP server safe?
Mostly: it is graded B (82/100). Read the India Stock safety report
How do I install India Stock?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does India Stock need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is India Stock maintained?
The last commit was 145 days ago (2026-06-12). The latest release is v1.0.1.
What can I use instead of India Stock?
Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, Stock Screener MCP server and TickDB Market Data MCP server.
How does India Stock compare with other Finance MCP servers?
safety score 82/100 (higher than 73% of 1,761 Finance servers); tools 16 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to India Stock

Same job from other publishers: the closest match first, then the best rated.

  • Tapetide - Indian Stock Market MCP
    48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
    A
  • Stock Screener
    Daily stock screens, RS ratings, market breadth and group rankings for 12 markets. No API keys.
    A
  • TickDB Market Data
    Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes
    B
  • Hood
    Robinhood Chain data + guarded trading for AI agents: Stock Token quotes, portfolios, launches
    More from nirholas →
    B
  • Akshare One
    MCP server that provides access to Chinese stock market data using akshare-one
    A