India Market MCP

An MCP server that gives Claude and other AI assistants live Indian market data: NSE quotes and indices, option chains with positioning analytics, company financials, shareholding, corporate actions, exchange filings and mutual fund performance. No API keys needed.

Ask things like:

• "How did the market do today, and which sectors led?"

• "Compare HDFC Bank and ICICI Bank on valuation, growth and promoter holding."

• "What is NIFTY's option chain saying for this week's expiry? Where are the OI walls and max pain?"

• "Show Parag Parikh Flexi Cap's 3, 5 and 10-year returns and its worst drawdown."

• "What did Reliance announce to the exchange this month?"

Tools

The server also provides three prompts: research_stock, market_brief and options_positioning.

Related MCP server: Tapetide MCP Server

Set up

You need uv. It fetches the right Python and runs the server without a separate install step.

Claude Code

claude mcp add -s user india-market -- uvx --from git+https://github.com/kcodweb/india-market-mcp india-market-mcp

Claude Desktop, Cursor, Windsurf and other clients. Add this to the client's MCP config (for Claude Desktop: Settings → Developer → Edit Config):

{
  "mcpServers": {
    "india-market": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kcodweb/india-market-mcp", "india-market-mcp"]
    }
  }
}

Restart the client and ask about the market.

From a clone

git clone https://github.com/kcodweb/india-market-mcp
cd india-market-mcp
uv sync
uv run india-market-mcp            # stdio, for local clients
uv run india-market-mcp --transport streamable-http --port 8000   # HTTP at http://127.0.0.1:8000/mcp

Data sources

How it works

• NSE access. NSE's JSON endpoints sit behind bot protection. The server loads a normal page first to collect session cookies, sends browser-like headers, refreshes the session once if NSE answers 401/403, spaces its requests at least 350 ms apart and caches responses. It uses the endpoints NSE's current website calls, several of which replaced the older /api/quote-equity family that NSE now blocks.

• Compact output. Results are small JSON documents: nulls dropped, money in ₹ crore, long lists capped with a note on how to see more. That keeps an assistant's context free for reasoning.

• Errors the model can act on. A mistyped symbol returns suggestions (RELIANC → "Did you mean: RELIANCE (Reliance Industries Limited)…"), an unknown expiry lists the live ones, and a blocked request says why.

• Analytics in plain Python. Black-Scholes, Greeks, the implied-volatility solver, max pain, CAGR, drawdown, RSI and the rest have no NumPy or SciPy dependency, and all are unit-tested.

Limitations

• These are unofficial website endpoints, not a licensed data feed. NSE changes them from time to time, and it blocks many cloud and non-Indian networks. Run the server on your own machine; a server in a US data centre will likely be refused.

• Shareholding covers promoter and public totals only; NSE's summary does not break out FII, DII or mutual fund holdings.

• Yahoo's statements for banks and financial companies are less complete than for other companies.

• This is market data for research and education, not investment advice. Check the terms of use of NSE, Yahoo and AMFI before building anything commercial on it. Not affiliated with NSE, BSE, AMFI or Yahoo.

Development

uv sync                  # installs the dev tools too
uv run pytest            # 118 offline tests, about a second
uv run pytest -m live    # checks the real endpoints (run from an Indian connection)
uv run ruff check src tests && uv run ruff format --check src tests

The offline suite replays real responses recorded in tests/fixtures/, through a real MCP client, so it is deterministic and never calls NSE from CI. To refresh the recordings, run python tests/record_fixtures.py from a network NSE allows, update RECORDED_AT in tests/scenarios.py, and fix any assertions that depend on the data.

src/india_market_mcp/
  server.py        tool and prompt definitions, CLI
  features/        one module per area: market, history, derivatives, company, funds
  sources/         HTTP clients for NSE, Yahoo Finance and mfapi.in
  analytics/       option pricing and return statistics (pure functions)

License

MIT