Indian Stock Exchange

io.github.prakharv-opsv2.0.0Updated Oct 11, 2026

Indian stocks (NSE/BSE): quotes, fundamentals, analyst targets, IPOs, mutual funds, commodities.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Read-only MCP server giving an assistant live Indian stock market data: NSE/BSE quotes, fundamentals, analyst targets, IPOs, mutual funds and commodities.

What it does
Exposes 27 read-only tools covering Indian equities and funds. It resolves names to NSE/BSE codes, returns price snapshots, history, financial statements, shareholding patterns, analyst estimates and price targets, corporate actions and filings, plus market movers, news, IPO calendars, MCX commodity futures and mutual fund search and details. It also ships five analysis prompts and three resources, including a per-stock resource. Output is condensed for analysis rather than raw API dumps.
When to use it
Useful when an assistant needs current Indian market information for research-style questions: comparing listed companies, drafting a stock note, checking what moved the market, reviewing upcoming IPOs or shortlisting mutual funds. Not intended for trading or portfolio execution.
Requirements
Runs locally over stdio as an npm package; Node.js 20 or newer is required. An API key from indianapi.in must be supplied through the ISE_API_KEY environment variable (or a .env file). An optional HTTP mode binds to localhost by default, with HOST and PORT overrides. Network access to the data provider is needed.
Before you install
Requires the ISE_API_KEY secret, which is sent to the third-party data provider; keep it out of committed files. All tools are described as read-only, so no trades or writes occur. The optional HTTP mode has no authentication, so it should sit behind an authenticating reverse proxy before being exposed beyond the local machine. Output is information, not investment advice, and amounts are in INR with market caps in crore.

Installation

In SourceWeft

  1. Open Indian Stock Exchange in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Indian Stock Exchange MCP Server

An MCP server that gives Claude (and any MCP client) live access to the Indian market: NSE/BSE equities, fundamentals, analyst targets, IPOs, mutual funds and commodities. Ask things like:

  • "Compare TCS, Infosys and Wipro on valuation, margins and momentum."
  • "Give me a research note on Reliance: financials, shareholding changes, analyst targets and recent filings."
  • "What's moving the market today? Any IPOs opening this week?"
  • "Shortlist the best mid-cap mutual funds by 3-year return and compare the top three."

Data comes from the Indian Stock Market API.

[Demo: the compare-stocks tool returning TCS, Infosys and Wipro side by side]

Real output from the compare-stocks tool. Regenerate it with node scripts/capture-demo.mjs && scripts/render-demo.sh.

Features

  • 27 tools, all read-only and annotated as such, with compact, analysis-ready output instead of raw API dumps
  • One-call stock snapshot: price, ranges, valuation, profitability, growth, leverage, returns, moving-average trend, analyst consensus and peers
  • Fundamentals: multi-year P&L, balance sheet, cash flow, ratios, shareholding pattern, analyst estimates and price targets
  • Market: gainers/losers, most active, price shockers, 52-week highs/lows, news, IPO calendar, commodity futures
  • Mutual funds: search, browse by category and return, full scheme details
  • 5 prompts (analyze-stock, compare-stocks, market-briefing, dividend-and-events, mutual-fund-picks) and 3 resources (news, IPO calendar, ise://stock/{name})
  • Reliable client: request timeout, retry with backoff on 429/5xx, in-memory TTL cache, in-flight de-duplication, clear error messages, and the API key is never exposed in output
  • stdio transport for desktop clients and stateless Streamable HTTP for remote use

Tools

AreaToolWhat it does
Stockssearch-stocksResolve a name to NSE/BSE codes and ISIN
get-stock-snapshotCondensed overview of a stock (start here)
get-stock-priceLatest price, day range, 52-week range
get-stock-detailsProfile, key metrics, shareholding, actions, news by section
get-stock-historyPrice, P/E, P/B, margins or EV history over 1m to max
compare-stocksSide-by-side comparison of 2-5 stocks
get-peersPeer companies with valuation and returns
get-stock-recommendationsAnalyst rating breakdown and trend
Fundamentalsget-financial-statementsQuarterly/annual results, balance sheet, cash flow, ratios
get-shareholding-patternPromoter/FII/DII/public holding over time
get-analyst-estimatesConsensus forecasts or actuals (EPS, sales, net income, EBITDA, ROE, ...)
get-price-targetMean/high/low targets and consensus recommendation
get-corporate-actionsDividends, bonus, splits, rights, board meetings
get-announcementsRecent exchange filings with links
Marketget-market-overviewMovers, activity, shockers and headlines in one call
get-top-gainers / get-top-losersToday's biggest movers
get-most-activeHighest-volume stocks (NSE or BSE)
get-price-shockersUnusual price moves (NSE or BSE)
get-52-week-highs-lowsStocks at 52-week extremes
get-news / get-market-newsLatest headlines with summaries
get-iposUpcoming, active, closed and listed IPOs
get-commoditiesMCX futures with open-interest signal
Mutual fundssearch-mutual-fundsFind schemes by name
get-mutual-fund-detailsNAV, returns, risk, expense ratio, holdings
list-mutual-fundsBrowse and rank by category and return period

Setup

Requires Node.js 20+ and an API key from indianapi.in.

sh
git clone <this repo> && cd Indian-Stock-Exchange-MCPcp .env.example .env        # then set ISE_API_KEYnpm installnpm run build

The key is read from the ISE_API_KEY environment variable, .env, or src/.env. Never commit it; all three files are git-ignored.

Claude Desktop

Settings > Developer > Edit Config:

json
{  "mcpServers": {    "indian-stock-exchange": {      "command": "node",      "args": ["/absolute/path/to/Indian-Stock-Exchange-MCP/build/index.js"],      "env": { "ISE_API_KEY": "your_api_key_here" }    }  }}

Restart Claude Desktop.

Claude Code

sh
claude mcp add indian-stock-exchange --env ISE_API_KEY=your_api_key_here -- node /absolute/path/to/build/index.js

HTTP mode

sh
npm run start:http          # http://127.0.0.1:3000/mcp  (health check: /health)

Stateless Streamable HTTP, bound to localhost by default (HOST and PORT override). It has no authentication, so put it behind a reverse proxy with auth before exposing it beyond your machine.

Development

sh
npm test         # build + unit tests (mocked HTTP, no key needed)npm run smoke    # calls every tool against the live API (needs ISE_API_KEY)
src/  index.ts          entry point: stdio or --http  server.ts         builds the McpServer and registers everything  client.ts         API client: auth, timeout, retry, cache  tools/            stocks, fundamentals, market, funds  prompts.ts        reusable analysis prompts  resources.ts      news, IPO and per-stock resources

Notes

  • Amounts are in INR; market caps are in crore.
  • get-top-gainers/get-top-losers come from the API's trending list, which is BSE-listed; use get-price-shockers with exchange: NSE for NSE.
  • Responses are cached for 60 seconds by default (ISE_CACHE_TTL_MS); history and fundamentals for longer.
  • This server provides information, not investment advice.

License

MIT

Source: README.md at commit b75b84a

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v2.0.0LatestOct 11, 2026