Indian Stock Market MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Indian Stock Market MCP Serverwhat's Reliance's share price today and its RSI?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tapetide is an Indian stock market MCP server that gives AI assistants live, structured data on every NSE and BSE listed company, from Nifty 50 and Sensex heavyweights to SME stocks. Connect it to Claude, ChatGPT, Cursor, VS Code, Codex or Gemini CLI and ask in plain English for share prices, quarterly financials, a 326-ratio stock screener, technical indicators, FII/DII flows, option chains and IV, corporate filings, IPOs, bulk deals and your portfolio P&L.
One-line install (Claude Code, with a free token from tapetide.com/settings/tokens):
claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcpOr skip the install entirely and add the remote server URL https://mcp.tapetide.com/mcp in claude.ai, ChatGPT, Grok or any client that supports remote MCP. You sign in with Google.
55 tools · 8,200+ NSE/BSE stocks · Remote (OAuth) or local (npx / uvx) · Free tier · Setup guides for 16 clients
Works with
Step-by-step setup guides for every major MCP client:
Chat apps | Code editors & IDEs | Terminal agents |
Any other client that speaks the Model Context Protocol works too, over remote HTTP or local stdio.
Related MCP server: Stock-MCP
Quick Start
Option 1: Remote MCP (No install — claude.ai, chatgpt.com, Grok, Gemini)
Add this URL directly in your AI chat app:
https://mcp.tapetide.com/mcpAuthentication happens automatically via Google OAuth. No token needed.
Option 2: Remote MCP with Token (Claude Code, VS Code, Kiro, Zed)
For code editors that support URL-based MCP servers with custom headers:
Get a free token at tapetide.com/settings/tokens
Add to your MCP config:
{
"mcpServers": {
"tapetide": {
"type": "url",
"url": "https://mcp.tapetide.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Option 3: Local MCP via npm (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Kiro, OpenCode)
For stdio-based MCP clients. No cloning or building required — runs via npx:
Get a free token at tapetide.com/settings/tokens
Add to your MCP config:
{
"mcpServers": {
"tapetide": {
"command": "npx",
"args": ["-y", "tapetide-mcp"],
"env": {
"TAPETIDE_TOKEN": "your_token_here"
}
}
}
}Node.js 18+ required for the local option. Run
node --versionto check.
Gemini CLI extension
gemini extensions install https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcpYou'll be prompted for your Tapetide token on install.
Install as a Claude Code plugin
This repo is also a one-plugin Claude Code marketplace. Run these two commands inside Claude Code:
/plugin marketplace add Tapetide-hq/nse-bse-indian-stock-market-data-mcp
/plugin install tapetide-indian-stock-market@tapetideOn Claude Code 2.1.275 or later, one line does both:
/plugin install tapetide-indian-stock-market --marketplace Tapetide-hq/nse-bse-indian-stock-market-data-mcpThe plugin connects to the remote server at https://mcp.tapetide.com/mcp, so there is nothing to install locally. Run /mcp and pick tapetide to sign in with Google the first time.
Prefer a local stdio server with a personal token instead? Skip the plugin and add the npm package directly (get a free token):
claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcpOption 4: Local MCP via Python (uvx / pip)
Same bridge, packaged for Python 3.10+ — tapetide-mcp on PyPI (source):
{
"mcpServers": {
"tapetide": {
"command": "uvx",
"args": ["tapetide-mcp"],
"env": {
"TAPETIDE_TOKEN": "your_token_here"
}
}
}
}How It Works
┌─────────────────┐ stdio (JSON-RPC) ┌──────────────────┐ HTTPS ┌─────────────────────┐
│ AI Assistant │ ◄──────────────────────► │ tapetide-mcp │ ◄────────────► │ mcp.tapetide.com │
│ (Claude, etc.) │ │ (npm package) │ │ (Cloudflare Worker) │
└─────────────────┘ └──────────────────┘ └─────────────────────┘The npm package is a lightweight stdio bridge with zero runtime dependencies. It:
Reads JSON-RPC from stdin, forwards to the remote Tapetide MCP server, writes responses to stdout
Auto-detects framing: Content-Length (VS Code, Claude Desktop) or newline-delimited JSON (Kiro, Claude Code)
Exchanges your refresh token for a 1-hour HMAC access token, auto-refreshes before expiry
Handles SSE responses from the remote server
Identifies your MCP client to the remote via
User-Agent, and echoes the negotiated protocol versionWarns on stderr when the server rate-limits a call, naming the retry delay
Replays the
Mcp-Session-Idthe server mints atinitializeon every later request, so the remote can tie a session's calls togetherForwards MCP Apps traffic untouched —
resources/list,resources/readand the_meta.uihints onget_price_history,market_heatmapandscreen_stocksreach your client exactly as the server sends them
All 55 tools and their logic run on the remote server — the npm package is just the transport layer. Because it forwards JSON-RPC verbatim, tools shipped on the remote are available immediately without upgrading this package.
Authentication
Method | How it works | Best for |
Google OAuth | Browser sign-in, automatic token refresh | AI chat apps (Claude.ai, ChatGPT, Grok, Gemini) |
Personal Token (remote) |
| Code editors with URL-based MCP (VS Code, Kiro, Zed) |
Personal Token (local) |
| stdio MCP clients (Cursor, Windsurf, Claude Desktop, Codex) |
Generate a free personal token at tapetide.com/settings/tokens. Works for both remote and local MCP.
Tools
Tip: ask your assistant to call
read_mefirst. It returns the full in-session guide — every tool by category, usage patterns, and the rules the server expects clients to follow.Three tools carry an interactive view for hosts that support MCP Apps (Claude, Claude Desktop, VS Code Copilot):
get_price_historyrenders the price and volume chart,market_heatmapthe index treemap, andscreen_stocksthe sortable results table. Text-only hosts get the same JSON result with nothing missing.
🔍 Discovery & Screening (5 tools)
Tool | Description |
| Resolve a company to its symbol by name, symbol, BSE code, or ISIN — including brand names and post-rename aliases ( |
| Fundamental screener over 326 ratios — PE, ROCE, sales growth, debt/equity, Piotroski score. Plain-English query syntax with AND/OR logic and cross-field comparisons. |
| Real-time technical screener — RSI, MACD, SMA/EMA crossovers, Bollinger Bands, ADX, volume, momentum. Supports |
| Search or browse the full 326-ratio catalog to get exact ratio names for a query. |
| Today's top gainers, losers, and most-active stocks from the Nifty 500. |
📊 Company Analysis (9 tools)
Tool | Description |
| Full overview — sector, business summary, pros/cons, fundamentals, growth metrics, current quote. Optionally add technicals (20+ indicators), analyst ratings, and peers in the same call. |
| Live price — LTP, change %, volume, market cap, PE, PB, 52-week high/low. |
| Up to 20 stock quotes in a single call. |
| Daily or weekly OHLCV with delivery %. Up to 2,000 sessions per call, pageable further back. |
| Quarterly + annual P&L, balance sheet, cash flow, and ratios. Each period is stamped with when it was actually published, so backtests can avoid look-ahead bias. |
| Promoter, FII, DII, and public holdings quarter by quarter. |
| Analyst EPS, revenue, EBITDA, net income, ROA, and ROE estimates against actuals — for spotting earnings surprises. |
| Sentiment-tagged news, corporate actions (dividends, splits, bonuses, AGMs), and filings (results, presentations, concall transcripts, annual reports). |
| Dividend history with yields + which mutual fund schemes hold the stock and at what share of AUM. |
🏛️ Market-Wide Data (11 tools)
Tool | Description |
| The at-a-glance daily snapshot — FII/DII net flows, Nifty 50 valuations, and India VIX in one call. |
| 30 days of daily cash-market flows, F&O participant long/short OI, weekly/monthly/yearly aggregates, buy/sell streaks, cumulative net flows. |
| Alias of |
| FPI investment by sector — AUM share, fortnightly change, 1-year cumulative flow. |
| Market-wide news across categories with sentiment and related symbols. |
| One dispatcher for seven daily feeds via |
| Every constituent of an index with market cap, PE, PB, returns from 1d to 5y, volume, sector — 16 indices. |
| Index PE, PB, and dividend yield over time. Up to 20 years. |
| The India VIX fear gauge — latest level, daily change, recent history. |
| Rank ~140 NSE indices by return over completed weeks or months. Filter to sectoral, broad, thematic, or strategy families — the right answer to "which sector led last month". |
| OHLC level series plus PE/PB/dividend yield for a single index. The index counterpart of |
🎲 Derivatives & Risk (5 tools)
Tool | Description |
| Per-strike index option chain with IV, full Greeks, bid/ask, open interest, max pain, PCR. NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY — a stamped end-of-day snapshot. |
| Session-by-session ATM IV, IV rank, IV percentile, realised vol, PCR, max pain, 25-delta skew for ~556 underlyings, individual stocks included. |
| Latest per-expiry aggregates — ATM IV, IV rank/percentile, realised vol, PCR by OI and volume, max pain, skew, call/put OI. |
| Promoter share-pledge percentage by quarter plus pledge/release events — a standard governance red-flag check. |
| Credit-rating actions by agency with rating, action, and outlook over time. |
🔬 Research & Scoring (4 tools)
Tool | Description |
| Bulk, block, insider, and substantial-acquisition (SAST) disclosures per stock, with counterparty, side, quantity, value. |
| The deterministic 0-100 Tapetide Score for one stock with its six pillar sub-scores, band, percentile, data confidence, and any governance caps or red flags. |
| Rank and filter the scored universe by band, size bucket, sector, score window, and confidence, with cursor pagination. |
| Structured digest of recent earnings-call transcripts and investor presentations — highlights, risks, guidance, headline metrics. |
📄 Filing Text (3 tools)
Parsed filings as text — read the annual report or transcript itself, not just a digest.
Tool | Description |
| Index of a company's parsed filings — concall transcripts, annual reports, investor presentations, IPO documents — with |
| Investor digest of one filing by |
| The Markdown text of a filing by |
⏳ Point-in-Time & Backtest Safety (5 tools)
Tool | Description |
| Split and bonus adjustment timeline for reconstructing raw prices — plus the rights and demerger events that carry no reliable factor at all. |
| Per-calendar-day reason a price is present or missing: traded, weekend, holiday, pre-listing, delisted, or no print. A missing day is not a zero return. |
| Was a stock in an index on a given date? Answers |
| Map a historical symbol or ISIN to the company that held it on a date, for old holdings files and recycled tickers. |
| The reverse lookup — which symbol and ISIN a company traded under at a point in time. |
💼 Portfolio (4 tools)
Requires a connected Tapetide account.
Tool | Description |
| Holdings with live prices, absolute and % P&L, invested value, weight, sector, market-cap class. |
| Add holdings singly or in bulk, including rows parsed from a broker CSV or screenshot (Zerodha, Groww, Angel One, Dhan, Upstox, 5Paisa, ICICI Direct, Kotak, HDFC Sky, Motilal Oswal). Duplicates merge on a weighted-average price. |
| Update quantity and average price after a top-up or partial sell. |
| Remove holdings from the portfolio. |
👁️ Watchlist (3 tools)
Requires a connected Tapetide account.
Tool | Description |
| Every followed stock with sector and industry. |
| Follow one or many stocks. Idempotent. |
| Unfollow one or many stocks. |
📖 Guide & Aliases (6 tools)
Tool | Description |
| The full in-session guide — every tool by category, the SEBI disclaimer rule, portfolio-first behaviour, parallel-call patterns. Assistants should call it first. |
| Alias of |
| Alias of |
| Alias of |
| Alias of |
| Redirect that points a preset-screen request at the screener tool that can actually answer it. |
Retired tool names
These names were removed. Calling one returns a message naming its replacement, so a client can recover in the same turn — but new integrations should use the replacement directly.
Retired | Replacement |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example Prompts
Stock Research
"Give me a complete analysis of Reliance Industries — financials, debt trend,
analyst target price, and what mutual funds are holding it"
"Compare HDFC Bank and ICICI Bank — quarterly profit growth, ROE, shareholding
changes, and analyst consensus"
"Pull the last 4 quarters of TCS financials — revenue growth, margin trend,
and cash flow. How does it compare to Infosys?"Stock Screening
"Find mid-cap stocks where FII holding increased last quarter, ROE > 15%,
and RSI below 40 — accumulation cThis server cannot be deployed
Maintenance
Related MCP Connectors
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what's on your morning desk, rank a watchlist by ROE, log a trade or save a thesis. OAuth sign-in. Free to start.
Unified financial infrastructure connecting AI agents directly to trade live/demo brokerage accounts, Web3 non-custodial wallets, real-time market data across equities, ETFs, crypto, forex, options, DeFi swaps, and prediction markets, institutional research feeds, and algorithmic strategy backtesters.
Global stock research, ML forecasts, valuation signals, screeners & portfolio tracking in Claude
Related MCP Servers
- AlicenseAqualityBmaintenanceIndian stock market (NSE & BSE) MCP server with 55 tools: live quotes, financials, technicals, a 326-ratio screener, FII/DII flows, option chains with IV, parsed annual reports and concall transcripts, IPOs and portfolio tracking for ~8,200 stocks.55430 npm140MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants like GitHub Copilot to access live stock market data, company information, technical analysis, news, and portfolio analytics.-
- AlicenseAqualityBmaintenanceEnables AI assistants to query live NSE & BSE stock market data, with 55 tools covering quotes, financials, screeners, FII/DII flows, option chains, and company filings.55MIT
- AlicenseBqualityBmaintenanceEnables self-hosted Indian stock research for Claude or any MCP client, pulling quotes, fundamentals, financials, a screener, option chains, FII/DII flows, and more from NSE India and Yahoo Finance without API keys, plus optional Zerodha Kite portfolio pairing.23MIT