# io.github.Akhilgovind02/india-stock-mcp (npm · india-stock-mcp)

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

- Trust score: 68/100 (medium)
- Change this week: +22
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `india-stock-mcp`: 68/100 (this document), [markdown](https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp.md), [page](https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp)

## Channel facts

- Registry: `npm`
- Package: `india-stock-mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 79/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects adm-zip 0.5.18, reached via nse-bse-api > adm-zip. A fixed version is available.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (172 of 173), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 51 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1251 tokens (~78/item across 16 items; 16 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add akhilgovind02-india-stock-mcp -- npx -y india-stock-mcp
```

### Codex

```bash
codex mcp add akhilgovind02-india-stock-mcp -- npx -y india-stock-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "akhilgovind02-india-stock-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "india-stock-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add akhilgovind02-india-stock-mcp --command npx --arg -y --arg india-stock-mcp
```

### Hermes

```yaml
mcp_servers:
  akhilgovind02-india-stock-mcp:
    command: "npx"
    args: ["-y", "india-stock-mcp"]
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 68, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 64, +56)

- [security regression] CVE-2026-39244 affects this package: high
- [security regression] Provenance: unverified → fail
- [security regression] Known CVEs: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Dependency health: partial → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 8, −20)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 28, +4)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-29 (score 24, −22)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (16)

### `get_quote` (~112 tokens)

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

Input parameters:

- `symbol` (string, required): NSE stock symbol (e.g. RELIANCE, TCS, HDFCBANK) or index name (NIFTY 50, NIFTY BANK). Do NOT append .NS — it is added automatically.

### `get_historical` (~107 tokens)

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

Input parameters:

- `from` (string, required): Start date in YYYY-MM-DD format
- `interval` (string): Data interval: 1d (daily), 1wk (weekly), 1mo (monthly)
- `symbol` (string, required): NSE stock symbol e.g. RELIANCE, TCS
- `to` (string, required): End date in YYYY-MM-DD format

### `search_symbol` (~53 tokens)

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

Input parameters:

- `query` (string, required): Company name or partial name e.g. 'HDFC Bank', 'Tata Consul', 'Wipro'

### `search_funds` (~63 tokens)

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

Input parameters:

- `query` (string, required): Fund name or partial name e.g. 'HDFC Top', 'SBI Small Cap', 'Mirae Emerging', 'ELSS'

### `get_fund_nav` (~74 tokens)

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

Input parameters:

- `limit` (number): Number of recent NAV entries to return (max 365)
- `scheme_code` (string, required): AMFI scheme code from search_funds e.g. '119551'

### `get_fundamentals` (~59 tokens)

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

Input parameters:

- `symbol` (string, required): NSE stock symbol e.g. HDFCBANK, INFY, WIPRO

### `compare_stocks` (~65 tokens)

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

Input parameters:

- `symbols` (array, required): Array of NSE symbols to compare e.g. ["HDFCBANK", "ICICIBANK", "SBIN"]

### `get_index` (~136 tokens)

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.

Input parameters:

- `index` (string, required): Index name e.g. 'NIFTY 50', 'NIFTY BANK', 'NIFTY IT', 'SENSEX', 'NIFTY MIDCAP 100'

### `get_market_status` (~25 tokens)

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

### `get_gainers_losers` (~63 tokens)

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

Input parameters:

- `count` (number): How many stocks to return
- `type` (string, required): Whether to get top gainers or top losers

### `get_corporate_actions` (~101 tokens)

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

Input parameters:

- `from` (string): Start date YYYY-MM-DD (default: 1 year ago)
- `symbol` (string): NSE symbol e.g. RELIANCE, INFY. Omit for market-wide list.
- `to` (string): End date YYYY-MM-DD (default: today)

### `get_options_chain` (~140 tokens)

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.

Input parameters:

- `expiry` (string): Optional expiry in DD-Mon-YYYY format e.g. '16-Jun-2026'. Default: nearest expiry.
- `strike_range` (number): Optional +/- range in points around ATM strike to include
- `symbol` (string, required): NSE F&O symbol e.g. NIFTY, BANKNIFTY, RELIANCE, TCS

### `get_ipo_list` (~63 tokens)

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

Input parameters:

- `type` (string): 'current' = open for subscription, 'upcoming' = announced, 'past' = listed in last 3 months

### `get_fund_details` (~64 tokens)

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

Input parameters:

- `scheme_code` (string, required): AMFI scheme code from search_funds e.g. '122639'

### `compare_funds` (~71 tokens)

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

Input parameters:

- `days` (number): Comparison period in days (NAV entries are trading days)
- `scheme_codes` (array, required): Array of AMFI scheme codes e.g. ["122639", "120503"]

### `portfolio_summary` (~55 tokens)

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.

Input parameters:

- `holdings` (array, required): Array of stock holdings

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 64
- 2026-08-01: 8
- 2026-07-31: 28
- 2026-07-29: 24
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/india-stock-mcp
- Socket report: https://socket.dev/npm/package/india-stock-mcp
- Repository: https://github.com/Akhilgovind02/india-stock-mcp
- Changelog RSS feed: https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/akhilgovind02-india-stock-mcp/india-stock-mcp