Skip to main content
Glama
indian-markets-mcp

indian-markets-mcp

indian-markets-mcp

Portfolio ci License: MIT

An MCP server exposing Indian market and regulatory data from official, openly published sources — NSE's bhavcopy archive, NIFTY Indices constituent files, AMFI's industry NAV file, and a local SEBI enforcement-order corpus.

Built against MCP Python SDK v2 (mcp >= 2.0.0).

The eight tools the server advertises over tools/list

The server's real tools/list response, fetched in-process with the MCP SDK client (no upstream calls). Regenerate: python scripts/render_tool_list.py.

Why this one exists

There are already several Indian-market MCP servers (see docs/SURVEY.md for the full landscape review). Almost all of them wrap either yfinance or a paid third-party API, and they compete on live quote coverage.

This server deliberately does not compete there. It covers what the others do not: official primary sources with a clean terms position, plus regulatory data. Where a source will not permit automated access, this server says so and omits the tool rather than working around the block.

Related MCP server: mftool-mcp

What it does and does not cover

Tool

Source

Status

nse_eod_quote

NSE bhavcopy archive

Working — end-of-day only

nse_eod_history

NSE bhavcopy archive

Working — capped at 120 days

list_nse_indices

static list

Working

nse_index_constituents

niftyindices.com CSV

Working — no weights

mf_search_schemes

AMFI NAVAll.txt

Working — ~14,200 schemes

mf_scheme

AMFI NAVAll.txt

Working

mf_nav_history

mfapi.in

Working

sebi_search_orders

local corpus

Working — 25-order sample

Deliberately not implemented, with reasons:

  • Live/intraday quotes. nseindia.com/api/quote-equity returns 403 Access Denied to non-browser clients (verified 2026-08-06). Reaching it means forging browser headers to defeat an access control the exchange put there on purpose. Not done.

  • Index constituent weights. NSE publishes weights only in factsheet PDFs and a paid data product. The free constituent CSVs carry no weight column, so the tool reports weights_available: false rather than estimating.

  • Corporate actions (dividends, splits, bonuses). The spec asked for these. No free source was found that serves them to an automated client under terms that permit it — NSE's corporate-actions endpoint sits behind the same 403. Not implemented rather than half-implemented. See docs/SOURCES.md.

Install

Not yet published to PyPI. From a checkout:

git clone https://github.com/siddharthgaur1/indian-markets-mcp
cd indian-markets-mcp
python -m venv .venv && .venv/bin/pip install -e .

Claude Desktop configuration

{
  "mcpServers": {
    "indian-markets": {
      "command": "/absolute/path/to/indian-markets-mcp/.venv/bin/indian-markets-mcp"
    }
  }
}

On Windows use .venv\\Scripts\\indian-markets-mcp.exe.

The SEBI tool additionally needs a corpus; point it at one with:

"env": { "INDIAN_MARKETS_MCP_SEBI_DB": "/path/to/sebi_orders.db" }

Every other tool works with no API keys and no configuration.

Behaviour guarantees

  • No fabricated data. A dead upstream raises a clear error. Missing values stay null; they are never coerced to zero.

  • Caching. On-disk SQLite at ~/.cache/indian-markets-mcp/. Settled bhavcopies are cached permanently because they are immutable.

  • Rate limiting. One-second minimum interval per host, enforced centrally, with exponential backoff. Not left to the caller.

  • Stale-cache fallback. If an upstream is down and a stale cached copy exists, it is served rather than failing — and never presented as live.

Tests

.venv/bin/pytest            # offline tests only (default)
.venv/bin/pytest -m live    # additionally hits real upstream sources

Network-dependent tests are marked live and deselected by default, so CI does not depend on NSE being reachable.

Licence

MIT. Data served by this tool belongs to its publishers (NSE, NIFTY Indices, AMFI, SEBI) and is subject to their terms — see docs/SOURCES.md.

Available Tools

8 tools
list_nse_indicesList NSE indicesA
Read-onlyIdempotent

Names of the NSE/NIFTY indices whose constituents this server can return.

Inputs: no named parameters.

mf_nav_historyMutual fund NAV historyA
Read-onlyIdempotent

Historical NAV series for one scheme, oldest first. Optionally bounded by start/end ISO dates. Sourced from mfapi.in, which mirrors AMFI's historical NAV archive.

Inputs: scheme_code (required), end, start.

mf_schemeMutual fund scheme detailA
Read-onlyIdempotent

Latest NAV and metadata for one AMFI scheme code.

Inputs: scheme_code (required).

mf_search_schemesSearch mutual fund schemesA
Read-onlyIdempotent

Search all ~14,000 Indian mutual fund schemes by name, AMC or category, from AMFI's daily industry NAV file. Returns scheme code, name, AMC, category, ISINs and latest NAV. Use the returned scheme_code with mf_nav_history. A scheme's NAV may be null when it did not report that day.

Inputs: query (required), limit.

nse_eod_historyNSE end-of-day historyA
Read-onlyIdempotent

Daily OHLCV series for one NSE symbol over a date range. Each day is a separate archive file, so the range is capped at 120 calendar days; for multi-year history use a pre-built warehouse instead. Non-trading days are absent from the series and counted in days_unavailable.

Inputs: end (required), start (required), symbol (required).

nse_eod_quoteNSE end-of-day quoteA
Read-onlyIdempotent

End-of-day OHLCV for an NSE-listed stock, from NSE's official published bhavcopy archive. This is SETTLED END-OF-DAY data, never a live intraday price — do not present it as the current price. Omit trade_date for the most recent published trading day. Returns open/high/low/close, previous close, volume, turnover and trade count.

Inputs: symbol (required), trade_date.

nse_index_constituentsNSE index constituentsA
Read-onlyIdempotent

Constituent stocks of an NSE index (e.g. 'NIFTY 50', 'NIFTY BANK'), from the CSV that NIFTY Indices publishes. Returns company name, industry, symbol, series and ISIN. CONSTITUENT WEIGHTS ARE NOT AVAILABLE — NSE publishes them only in factsheet PDFs and a paid product, so do not infer or estimate them.

Inputs: index (required).

sebi_search_ordersSearch SEBI enforcement ordersA
Read-onlyIdempotent

Search a LOCAL SAMPLE of SEBI enforcement orders by text, entity or year. IMPORTANT: this corpus is a small sample (see corpus_size in the response), NOT SEBI's complete enforcement archive. If a search returns nothing, say that the sample contains no match — never conclude that SEBI has issued no order against the entity.

Inputs: year, limit, query, entity.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: single-day NSE quote vs. history, index listing vs. constituents, mutual fund search vs. latest scheme data vs. historical NAV, and SEBI orders. The descriptions clearly separate even the closest pairs, so an agent should not confuse them.

    Naming Consistency3/5

    All names are readable snake_case, but conventions are mixed: some use verb-first forms like list_nse_indices, mf_search_schemes, and sebi_search_orders, while others are noun-first like nse_eod_quote, nse_index_constituents, and mf_nav_history. The prefix placement is also inconsistent (nse_ vs. list_nse_).

    Tool Count5/5

    Eight tools is well-scoped for a financial data server covering NSE equities, indices, mutual funds, and SEBI sample data. Each tool provides a meaningful capability with no obvious redundancy or padding.

    Completeness3/5

    The surface covers core EOD equity, index constituents, mutual fund NAV, and SEBI order search workflows, but there are notable gaps: no index quote/history tool, no way to search/list NSE symbols, and no mutual fund category-level or performance comparisons. SEBI search is intentionally limited to a sample, which is documented but still restricts coverage.

    Maintenance

    ActivityStale
    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
      A
      quality
      D
      maintenance
      MCP server for Indian stock market data. Provides 16 tools for quotes, history, fundamentals, mutual funds, indices, corporate actions, options, IPOs, and portfolio analysis.
      16
      90 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides access to screener.in financial data for Indian stocks, enabling queries for company info, financials, ratios, quarterly results, shareholding, and stock screening.
      MIT