io.github.Akhilgovind02/india-stock-mcp

NPM · INDIA-STOCK-MCP · SCANNED AUG 3

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

Available components

+22 this week 68 68 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security79

No malware found by supply-chain analysis.Pass
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. View diagnostics → Fail
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (172 of 173), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 51 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1251 tokens (~78/item across 16 items; 16 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · india-stock-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +56
- CVE-2026-39244 affects this package: high ▼ security
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Dependency health: partial → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 −20
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 +4
- Malware scan: pass → unverified ▼ security
- Tool coverage: unverified → 100 ▲ functional
29 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 46

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-xcpc-8h2w-3j85	CVE-2026-39244	high	CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H	yes

Dependencies 172 packages

172 packages in the resolved dependency tree · 166 deprecated · 55 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 16 exposed · ~1,251 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

compare_funds ~71

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

Input Output Examples

Name	Type	Req	Description
days	number	—	Comparison period in days (NAV entries are trading days)
scheme_codes	array	yes	Array of AMFI scheme codes e.g. ["122639", "120503"]

No output schema declared.

No examples provided.

compare_stocks ~65

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

Input Output Examples

Name	Type	Req	Description
symbols	array	yes	Array of NSE symbols to compare e.g. ["HDFCBANK", "ICICIBANK", "SBIN"]

No output schema declared.

No examples provided.

get_corporate_actions ~101

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

Name	Type	Req	Description
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)

No output schema declared.

No examples provided.

get_fund_details ~64

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

Input Output Examples

Name	Type	Req	Description
scheme_code	string	yes	AMFI scheme code from search_funds e.g. '122639'

No output schema declared.

No examples provided.

get_fund_nav ~74

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

Input Output Examples

Name	Type	Req	Description
limit	number	—	Number of recent NAV entries to return (max 365)
scheme_code	string	yes	AMFI scheme code from search_funds e.g. '119551'

No output schema declared.

No examples provided.

get_fundamentals ~59

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

Input Output Examples

Name	Type	Req	Description
symbol	string	yes	NSE stock symbol e.g. HDFCBANK, INFY, WIPRO

No output schema declared.

No examples provided.

get_gainers_losers ~63

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

Input Output Examples

Name	Type	Req	Description
count	number	—	How many stocks to return
type	string	yes	Whether to get top gainers or top losers

No output schema declared.

No examples provided.

get_historical ~107

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

Input Output Examples

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

No output schema declared.

No examples provided.

get_index ~136

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

Name	Type	Req	Description
index	string	yes	Index name e.g. 'NIFTY 50', 'NIFTY BANK', 'NIFTY IT', 'SENSEX', 'NIFTY MIDCAP 100'

No output schema declared.

No examples provided.

get_ipo_list ~63

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

Input Output Examples

Name	Type	Req	Description
type	string	—	'current' = open for subscription, 'upcoming' = announced, 'past' = listed in last 3 months

No output schema declared.

No examples provided.

get_market_status ~25

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_options_chain ~140

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

Name	Type	Req	Description
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	yes	NSE F&O symbol e.g. NIFTY, BANKNIFTY, RELIANCE, TCS

No output schema declared.

No examples provided.

get_quote ~112

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

Name	Type	Req	Description
symbol	string	yes	NSE stock symbol (e.g. RELIANCE, TCS, HDFCBANK) or index name (NIFTY 50, NIFTY BANK). Do NOT append .NS — it is added automatically.

No output schema declared.

No examples provided.

portfolio_summary ~55

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

Name	Type	Req	Description
holdings	array	yes	Array of stock holdings

No output schema declared.

No examples provided.

search_funds ~63

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

Input Output Examples

Name	Type	Req	Description
query	string	yes	Fund name or partial name e.g. 'HDFC Top', 'SBI Small Cap', 'Mirae Emerging', 'ELSS'

No output schema declared.

No examples provided.

search_symbol ~53

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

Input Output Examples

Name	Type	Req	Description
query	string	yes	Company name or partial name e.g. 'HDFC Bank', 'Tata Consul', 'Wipro'

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug