Skip to content
Back to search

nse-bse-indian-stock-market-data-mcp

NSE BSE Indian Stock Market Data MCP server — search, screen & analyze all 8,200+ NSE/BSE stocks with 52 tools: live quotes, financials, technicals, 326-ratio screener, FII/DII flows, options IV, IPOs & portfolio tracking. Works with Claude, ChatGPT, Cursor & any MCP client

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tapetide-hq--nse-bse-indian-stock-market-data-mcp/badge.svg)](/listings/tapetide-hq--nse-bse-indian-stock-market-data-mcp)

HTML

<a href="/listings/tapetide-hq--nse-bse-indian-stock-market-data-mcp"><img src="/api/listings/tapetide-hq--nse-bse-indian-stock-market-data-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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/mcp

Authentication 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:

1. Get a free token at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens) 2. 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`:

1. Get a free token at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens) 2. 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 --version` to check.

Gemini CLI extension

gemini extensions install https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp

You'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@tapetide

On 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-mcp

The 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](https://tapetide.com/settings/tokens)):

claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp

Option 4: Local MCP via Python (uvx / pip)

Same bridge, packaged for Python 3.10+ — [`tapetide-mcp` on PyPI](https://pypi.org/project/tapetide-mcp/) ([source](https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp-python)):

{
  "mcpServers": {
    "tapetide": {
      "command": "uvx",
      "args": ["tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "your_token_here"
      }
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "tapetide",
  4. "description": "Tapetide plugins for Claude Code: Indian stock market (NSE & BSE) data and research.",
  5. "owner": {
  6. "name": "Tapetide",
  7. "email": "hello@tapetide.com",
  8. "url": "https://tapetide.com"
  9. },
  10. "plugins": [
  11. {
  12. "name": "tapetide-indian-stock-market",
  13. "source": "./",
  14. "description": "Indian stock market research for NSE and BSE: live quotes, financials, technicals, a 326-ratio screener, FII/DII flows, option chains, parsed filings, IPOs, and portfolio tracking.",
  15. "category": "finance",
  16. "tags": ["mcp", "indian-stock-market", "nse", "bse", "finance", "stock-research"]
  17. }
  18. ]
  19. }
README.md · README · 544 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://tapetide.com/mcp">
  3. <img src="https://assets.tapetide.com/logo-filled-tight.svg" alt="Tapetide — Indian Stock Market MCP Server" width="80" />
  4. </a>
  5. </p>
  6. <h1 align="center">Indian Stock Market MCP Server — NSE & BSE Data for Claude, ChatGPT & Cursor</h1>
  7. <p align="center">
  8. <strong>The Indian stock market MCP server for NSE and BSE: 48 tools (55 including aliases) to search, screen and analyze about 8,000 listed stocks from Claude, ChatGPT, Cursor, VS Code, Codex, Gemini CLI and any MCP client.</strong>
  9. </p>
  10. <p align="center">
  11. <a href="https://www.npmjs.com/package/tapetide-mcp"><img src="https://img.shields.io/npm/v/tapetide-mcp?label=npm" alt="npm version" /></a>
  12. <a href="https://www.npmjs.com/package/tapetide-mcp"><img src="https://img.shields.io/npm/dm/tapetide-mcp" alt="npm downloads" /></a>
  13. <a href="https://pypi.org/project/tapetide-mcp/"><img src="https://img.shields.io/pypi/v/tapetide-mcp?label=pypi" alt="PyPI version" /></a>
  14. <a href="https://registry.modelcontextprotocol.io/v0/servers?search=com.tapetide/stock-research-mcp"><img src="https://img.shields.io/badge/MCP%20Registry-com.tapetide%2Fstock--research--mcp-blue" alt="Official MCP Registry" /></a>
  15. <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License" /></a>
  16. <a href="https://glama.ai/mcp/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp"><img src="https://glama.ai/mcp/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp/badges/score.svg" alt="nse-bse-indian-stock-market-data-mcp MCP server" /></a>
  17. </p>
  18. <p align="center">
  19. <a href="https://tapetide.com/mcp">Documentation</a> •
  20. <a href="#quick-start">Quick Start</a> •
  21. <a href="#works-with">Client Setup Guides</a> •
  22. <a href="#tools">48 Tools</a> •
  23. <a href="#example-prompts">Example Prompts</a> •
  24. <a href="https://www.npmjs.com/package/tapetide-mcp">npm</a> •
  25. <a href="https://pypi.org/project/tapetide-mcp/">PyPI</a>
  26. </p>
  27. ---
  28. 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.
  29. **One-line install** (Claude Code, with a free token from [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens)):
  30. ```bash
  31. claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp
  32. ```
  33. Or 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.
  34. **48 tools** (55 including aliases) · **about 8,000 NSE/BSE stocks** · **Remote (OAuth) or local (npx / uvx)** · **Free for your first 7 days: 100 tool calls a day** · [Setup guides for 16 clients](https://tapetide.com/mcp)
  35. ## Works with
  36. Step-by-step setup guides for every major MCP client:
  37. | Chat apps | Code editors & IDEs | Terminal agents |
  38. |---|---|---|
  39. | [Claude.ai](https://tapetide.com/mcp/claude-ai) | [Cursor](https://tapetide.com/mcp/cursor) | [Claude Code](https://tapetide.com/mcp/claude-code) |
  40. | [ChatGPT](https://tapetide.com/mcp/chatgpt) | [VS Code (GitHub Copilot)](https://tapetide.com/mcp/vscode) | [Codex CLI](https://tapetide.com/mcp/codex) |
  41. | [Claude Desktop](https://tapetide.com/mcp/claude-desktop) | [Windsurf](https://tapetide.com/mcp/windsurf) | [Gemini CLI](https://tapetide.com/mcp/gemini-cli) |
  42. | [Grok](https://tapetide.com/mcp/grok) | [Kiro](https://tapetide.com/mcp/kiro) | [OpenCode](https://tapetide.com/mcp/opencode) |
  43. | | [Zed](https://tapetide.com/mcp/zed) | [Command Code](https://tapetide.com/mcp/commandcode) |
  44. | | [Cline](https://tapetide.com/mcp/cline) | |
  45. | | [Antigravity](https://tapetide.com/mcp/antigravity) | |
  46. Any other client that speaks the Model Context Protocol works too, over remote HTTP or local stdio.
  47. ## Quick Start
  48. ### Option 1: Remote MCP (No install — claude.ai, chatgpt.com, Grok, Gemini)
  49. Add this URL directly in your AI chat app:
  50. ```
  51. https://mcp.tapetide.com/mcp
  52. ```
  53. Authentication happens automatically via Google OAuth. No token needed.
  54. ### Option 2: Remote MCP with Token (Claude Code, VS Code, Kiro, Zed)
  55. For code editors that support URL-based MCP servers with custom headers:
  56. 1. Get a free token at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens)
  57. 2. Add to your MCP config:
  58. ```json
  59. {
  60. "mcpServers": {
  61. "tapetide": {
  62. "type": "url",
  63. "url": "https://mcp.tapetide.com/mcp",
  64. "headers": {
  65. "Authorization": "Bearer YOUR_TOKEN_HERE"
  66. }
  67. }
  68. }
  69. }
  70. ```
  71. ### Option 3: Local MCP via npm (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Kiro, OpenCode)
  72. For stdio-based MCP clients. No cloning or building required — runs via `npx`:
  73. 1. Get a free token at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens)
  74. 2. Add to your MCP config:
  75. ```json
  76. {
  77. "mcpServers": {
  78. "tapetide": {
  79. "command": "npx",
  80. "args": ["-y", "tapetide-mcp"],
  81. "env": {
  82. "TAPETIDE_TOKEN": "your_token_here"
  83. }
  84. }
  85. }
  86. }
  87. ```
  88. > **Node.js 18+** required for the local option. Run `node --version` to check.
  89. ### Gemini CLI extension
  90. ```bash
  91. gemini extensions install https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp
  92. ```
  93. You'll be prompted for your Tapetide token on install.
  94. ### Install as a Claude Code plugin
  95. This repo is also a one-plugin Claude Code marketplace. Run these two commands inside Claude Code:
  96. ```
  97. /plugin marketplace add Tapetide-hq/nse-bse-indian-stock-market-data-mcp
  98. /plugin install tapetide-indian-stock-market@tapetide
  99. ```
  100. On Claude Code 2.1.275 or later, one line does both:
  101. ```
  102. /plugin install tapetide-indian-stock-market --marketplace Tapetide-hq/nse-bse-indian-stock-market-data-mcp
  103. ```
  104. The 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.
  105. Prefer a local stdio server with a personal token instead? Skip the plugin and add the npm package directly ([get a free token](https://tapetide.com/settings/tokens)):
  106. ```bash
  107. claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp
  108. ```
  109. ### Option 4: Local MCP via Python (uvx / pip)
  110. Same bridge, packaged for Python 3.10+ — [`tapetide-mcp` on PyPI](https://pypi.org/project/tapetide-mcp/) ([source](https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp-python)):
  111. ```json
  112. {
  113. "mcpServers": {
  114. "tapetide": {
  115. "command": "uvx",
  116. "args": ["tapetide-mcp"],
  117. "env": {
  118. "TAPETIDE_TOKEN": "your_token_here"
  119. }
  120. }
  121. }
  122. }
  123. ```
  124. ## How It Works
  125. ```
  126. ┌─────────────────┐ stdio (JSON-RPC) ┌──────────────────┐ HTTPS ┌─────────────────────┐
  127. │ AI Assistant │ ◄──────────────────────► │ tapetide-mcp │ ◄────────────► │ mcp.tapetide.com │
  128. │ (Claude, etc.) │ │ (npm package) │ │ (Cloudflare Worker) │
  129. └─────────────────┘ └──────────────────┘ └─────────────────────┘
  130. ```
  131. The npm package is a lightweight stdio bridge with zero runtime dependencies. It:
  132. - Reads JSON-RPC from stdin, forwards to the remote Tapetide MCP server, writes responses to stdout
  133. - Auto-detects framing: Content-Length (VS Code, Claude Desktop) or newline-delimited JSON (Kiro, Claude Code)
  134. - Exchanges your refresh token for a 1-hour HMAC access token, auto-refreshes before expiry
  135. - Handles SSE responses from the remote server
  136. - Identifies your MCP client to the remote via `User-Agent`, and echoes the negotiated protocol version
  137. - Warns on stderr when the server rate-limits a call, naming the retry delay
  138. - Replays the `Mcp-Session-Id` the server mints at `initialize` on every later request, so the remote can tie a session's calls together
  139. - Forwards MCP Apps traffic untouched — `resources/list`, `resources/read` and the `_meta.ui` hints on `get_price_history`, `market_heatmap` and `screen_stocks` reach your client exactly as the server sends them
  140. All tools and their logic run on the remote server — the npm package is just the transport layer.
  141. Because it forwards JSON-RPC verbatim, tools shipped on the remote are available immediately without
  142. upgrading this package.
  143. ## Authentication
  144. | Method | How it works | Best for |
  145. |--------|-------------|----------|
  146. | **Google OAuth** | Browser sign-in, automatic token refresh | AI chat apps (Claude.ai, ChatGPT, Grok, Gemini) |
  147. | **Personal Token (remote)** | `Authorization: Bearer tpt_rt_...` header | Code editors with URL-based MCP (VS Code, Kiro, Zed) |
  148. | **Personal Token (local)** | `TAPETIDE_TOKEN` env var via npx | stdio MCP clients (Cursor, Windsurf, Claude Desktop, Codex) |
  149. Generate a free personal token at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens). Works for both remote and local MCP.
  150. ## Tools
  151. > Tip: ask your assistant to call `read_me` first. It returns the full in-session guide — every
  152. > tool by category, usage patterns, and the rules the server expects clients to follow.
  153. >
  154. > Three tools carry an interactive view for hosts that support [MCP Apps](https://github.com/modelcontextprotocol/ext-apps)
  155. > (Claude, Claude Desktop, VS Code Copilot): `get_price_history` renders the price and volume chart,
  156. > `market_heatmap` the index treemap, and `screen_stocks` the sortable results table. Text-only hosts
  157. > get the same JSON result with nothing missing.
  158. <!-- tools:start — mirrors the server's tool catalog. Checked against the live server's tools/list by
  159. scripts/check-catalog-parity.mjs (CI: .github/workflows/ci.yml). When the catalog changes,
  160. regenerate this block; do not hand-edit an individual count. -->
  161. ### 🔍 Discovery & Screening (5 tools)
  162. | Tool | Description |
  163. |------|-------------|
  164. | `search_stocks` | Resolve a company to its symbol by name, symbol, BSE code, or ISIN — including brand names and post-rename aliases (`Zomato` → `ETERNAL`). Filter by sector/industry. |
  165. | `screen_stocks` | 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. |
  166. | `screen_stocks_technical` | Real-time technical screener — RSI, MACD, SMA/EMA crossovers, Bollinger Bands, ADX, volume, momentum. Supports `crosses_above`/`crosses_below`. |
  167. | `get_screener_ratios` | Search or browse the full 326-ratio catalog to get exact ratio names for a query. |
  168. | `get_trending_stocks` | Today's top gainers, losers, and most-active stocks from the Nifty 500. |
  169. ### 📊 Company Analysis (9 tools)
  170. | Tool | Description |
  171. |------|-------------|
  172. | `get_company_profile` | 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. |
  173. | `get_stock_quote` | Live price — LTP, change %, volume, market cap, PE, PB, 52-week high/low. |
  174. | `get_batch_quotes` | Up to 20 stock quotes in a single call. |
  175. | `get_price_history` | Daily or weekly OHLCV with delivery %. Up to 2,000 sessions per call, pageable further back. |
  176. | `get_financials` | 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. |
  177. | `get_shareholding` | Promoter, FII, DII, and public holdings quarter by quarter. |
  178. | `get_forecasts` | Analyst EPS, revenue, EBITDA, net income, ROA, and ROE estimates against actuals — for spotting earnings surprises. |
  179. | `get_stock_events` | Sentiment-tagged news, corporate actions (dividends, splits, bonuses, AGMs), and filings (results, presentations, concall transcripts, annual reports). |
  180. | `get_stock_ownership` | Dividend history with yields + which mutual fund schemes hold the stock and at what share of AUM. |
  181. ### 🏛️ Market-Wide Data (11 tools)
  182. | Tool | Description |
  183. |------|-------------|
  184. | `get_market_pulse` | The at-a-glance daily snapshot — FII/DII net flows, Nifty 50 valuations, and India VIX in one call. |
  185. | `get_fii_dii_detail` | 30 days of daily cash-market flows, F&O participant long/short OI, weekly/monthly/yearly aggregates, buy/sell streaks, cumulative net flows. |
  186. | `get_fii_dii_flows` | Alias of `get_fii_dii_detail`. |
  187. | `get_fpi_sectors` | FPI investment by sector — AUM share, fortnightly change, 1-year cumulative flow. |
  188. | `get_market_news` | Market-wide news across categories with sentiment and related symbols. |
  189. | `get_market_data` | One dispatcher for seven daily feeds via `dataset`: `deals`, `fno_ban`, `deliveries`, `ipo`, `mtf`, `slbm`, `signals`. |
  190. | `market_heatmap` | Every constituent of an index with market cap, PE, PB, returns from 1d to 5y, volume, sector — 16 indices. |
  191. | `market_valuations` | Index PE, PB, and dividend yield over time. Up to 20 years. |
  192. | `get_india_vix` | The India VIX fear gauge — latest level, daily change, recent history. |
  193. | `get_index_performance` | 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". |
  194. | `get_index_history` | OHLC level series plus PE/PB/dividend yield for a single index. The index counterpart of `get_price_history`. |
  195. ### 🎲 Derivatives & Risk (5 tools)
  196. | Tool | Description |
  197. |------|-------------|
  198. | `get_option_chain` | 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. |
  199. | `get_option_iv_history` | Session-by-session ATM IV, IV rank, IV percentile, realised vol, PCR, max pain, 25-delta skew for ~556 underlyings, individual stocks included. |
  200. | `get_options_analytics` | Latest per-expiry aggregates — ATM IV, IV rank/percentile, realised vol, PCR by OI and volume, max pain, skew, call/put OI. |
  201. | `get_promoter_pledge` | Promoter share-pledge percentage by quarter plus pledge/release events — a standard governance red-flag check. |
  202. | `get_credit_ratings` | Credit-rating actions by agency with rating, action, and outlook over time. |
  203. ### 🔬 Research & Scoring (4 tools)
  204. | Tool | Description |
  205. |------|-------------|
  206. | `get_stock_deals` | Bulk, block, insider, and substantial-acquisition (SAST) disclosures per stock, with counterparty, side, quantity, value. |
  207. | `get_tapetide_score` | 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. |
  208. | `screen_tapetide_scores` | Rank and filter the scored universe by band, size bucket, sector, score window, and confidence, with cursor pagination. |
  209. | `get_earnings_call_summary` | Structured digest of recent earnings-call transcripts and investor presentations — highlights, risks, guidance, headline metrics. |
  210. ### 📄 Filing Text (3 tools)
  211. Parsed filings as text — read the annual report or transcript itself, not just a digest.
  212. | Tool | Description |
  213. |------|-------------|
  214. | `list_company_documents` | Index of a company's parsed filings — concall transcripts, annual reports, investor presentations, IPO documents — with `doc_id`, period, page count, what is available for each, and links to the PDF and full Markdown. Call this first. |
  215. | `get_document_summary` | Investor digest of one filing by `doc_id` (or the newest of a `doc_type`): summary, highlights, risks, management guidance, key metrics. Capped at 6k chars; `truncated: true` marks an abridged digest. |
  216. | `read_document` | The Markdown text of a filing by `doc_id` and page range, with `<!-- page N -->` markers to cite from. At most 12 pages / 24k chars per call; the result names the pages returned and the `next_pages` to fetch. |
  217. ### ⏳ Point-in-Time & Backtest Safety (5 tools)
  218. | Tool | Description |
  219. |------|-------------|
  220. | `get_adjustment_factors` | Split and bonus adjustment timeline for reconstructing raw prices — plus the rights and demerger events that carry no reliable factor at all. |
  221. | `get_observation_status` | 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. |
  222. | `get_index_membership_asof` | Was a stock in an index on a given date? Answers `present`, `uncertain`, `absent`, or `out_of_coverage` — survivorship-bias-aware universe construction. |
  223. | `resolve_identifier_asof` | Map a historical symbol or ISIN to the company that held it on a date, for old holdings files and recycled tickers. |
  224. | `get_identifiers_asof` | The reverse lookup — which symbol and ISIN a company traded under at a point in time. |
  225. ### 💼 Portfolio (4 tools)
  226. Requires a connected Tapetide account.
  227. | Tool | Description |
  228. |------|-------------|
  229. | `get_user_portfolio` | Holdings with live prices, absolute and % P&L, invested value, weight, sector, market-cap class. |
  230. | `add_portfolio_stocks` | Add holdings singly or in bulk, including rows parsed from a broker CSV or screenshot. Duplicates merge on a weighted-average price. |
  231. | `update_portfolio_stock` | Update quantity and average price after a top-up or partial sell. |
  232. | `remove_portfolio_stocks` | Remove holdings from the portfolio. |
  233. ### 👁️ Watchlist (3 tools)
  234. Requires a connected Tapetide account.
  235. | Tool | Description |
  236. |------|-------------|
  237. | `get_watchlist` | Every followed stock with sector and industry. |
  238. | `add_to_watchlist` | Follow one or many stocks. Idempotent. |
  239. | `remove_from_watchlist` | Unfollow one or many stocks. |
  240. ### 📖 Guide & Aliases (6 tools)
  241. | Tool | Description |
  242. |------|-------------|
  243. | `read_me` | The full in-session guide — every tool by category, the SEBI disclaimer rule, portfolio-first behaviour, parallel-call patterns. Assistants should call it first. |
  244. | `scan_movers` | Alias of `get_trending_stocks`. |
  245. | `get_live_quote` | Alias of `get_stock_quote`. |
  246. | `get_stock_news` | Alias of `get_stock_events` with `type: "news"`. |
  247. | `get_corporate_actions` | Alias of `get_stock_events` with `type: "corporate_actions"`. |
  248. | `run_preset_screen` | Redirect that points a preset-screen request at the screener tool that can actually answer it. |
  249. <!-- tools:end -->
  250. ### Retired tool names
  251. These names were removed. Calling one returns a message naming its replacement, so a client can
  252. recover in the same turn — but new integrations should use the replacement directly.
  253. | Retired | Replacement |
  254. |---------|-------------|
  255. | `market_deals` | `get_market_data` with `dataset: "deals"` |
  256. | `market_fno_ban` | `get_market_data` with `dataset: "fno_ban"` |
  257. | `market_deliveries` | `get_market_data` with `dataset: "deliveries"` |
  258. | `market_ipo` | `get_market_data` with `dataset: "ipo"` |
  259. | `market_mtf` | `get_market_data` with `dataset: "mtf"` |
  260. | `market_slbm` | `get_market_data` with `dataset: "slbm"` |
  261. | `market_signals` | `get_market_data` with `dataset: "signals"` |
  262. | `get_quant_signal` | `get_tapetide_score` (a different measurement, not a rename) |
  263. | `screen_by_quant_signal` | `screen_tapetide_scores` (a different measurement, not a rename) |
  264. ## Example Prompts
  265. ### Stock Research
  266. ```
  267. "Give me a complete analysis of Reliance Industries — financials, debt trend,
  268. analyst target price, and what mutual funds are holding it"
  269. "Compare HDFC Bank and ICICI Bank — quarterly profit growth, ROE, shareholding
  270. changes, and analyst consensus"
  271. "Pull the last 4 quarters of TCS financials — revenue growth, margin trend,
  272. and cash flow. How does it compare to Infosys?"
  273. ```
  274. ### Stock Screening
  275. ```
  276. "Find mid-cap stocks where FII holding increased last quarter, ROE > 15%,
  277. and RSI below 40 — accumulation candidates"
  278. "Screen for stocks with MACD bullish crossover, volume 2x average, and
  279. within 10% of 52-week high"
  280. "Which small-caps have debt-to-equity below 0.5, operating margin above 20%,
  281. and PE below 15?"
  282. ```
  283. ### Institutional Flows
  284. ```
  285. "FIIs have been selling for 5 days — show me daily numbers and which sectors
  286. they're pulling out of"
  287. "Compare FII vs DII flows for the last month with Nifty 50 PE — are we near
  288. a historical bottom?"
  289. "Show F&O participant-wise open interest — are FIIs net long or short in
  290. index futures?"
  291. ```
  292. ### Portfolio & Watchlist
  293. ```
  294. "Add these to my portfolio: 10 RELIANCE at ₹1350, 50 TCS at ₹3800,
  295. 25 HDFCBANK at ₹1650"
  296. "I bought 10 more RELIANCE at ₹1400 — update my portfolio and show
  297. my new average cost"
  298. "Which of my holdings are technically weak? Show RSI and MACD for each"
  299. "Watch TATAMOTORS, MARUTI, M&M — compare their PE ratios and quarterly
  300. sales growth"
  301. ```
  302. ### Derivatives & Volatility
  303. ```
  304. "Is RELIANCE implied volatility high right now? Show IV rank and percentile
  305. versus realised vol over the last year"
  306. "Show the NIFTY option chain around ATM — open interest by strike, max pain,
  307. and the put-call ratio"
  308. "Which sectors led the last 3 completed weeks? Rank the sectoral indices"
  309. ```
  310. ### Scoring & Risk Screens
  311. ```
  312. "What's the Tapetide Score for TATASTEEL and why — break down the pillars"
  313. "Show me Strong-band pharma stocks among large and mid caps"
  314. "Any governance red flags on this stock? Check promoter pledge trend and
  315. recent credit rating actions"
  316. ```
  317. ### Backtest Safety
  318. ```
  319. "Was IDEA in the Nifty 500 on 2019-03-31? I need point-in-time membership,
  320. not today's list"
  321. "This stock shows a 60% single-day move in 2022 — was that a split or a real
  322. return? Check the adjustment factors"
  323. ```
  324. ### Daily Market Briefing
  325. ```
  326. "Full market briefing — FII/DII flows, F&O ban stocks, bulk deals above
  327. 50 crores, top delivery stocks, and breakout signals"
  328. "Is the market overvalued? Show Nifty 50 PE vs 5-year and 10-year averages"
  329. "Show the Nifty 50 heatmap — which sectors dragged the index today?"
  330. ```
  331. ## Data Coverage
  332. | Category | What's included |
  333. |----------|----------------|
  334. | **Stocks** | About 8,000 NSE and BSE listed companies, including SME |
  335. | **Price data** | Daily OHLCV up to 2,000 days + weekly aggregation + delivery % |
  336. | **Financials** | Quarterly + annual P&L, balance sheet, cash flow, 50+ ratios |
  337. | **Screener** | 326 fundamental ratios + real-time technical indicators + cross-field comparisons |
  338. | **Technicals** | RSI, SMA, EMA, MACD, Bollinger Bands, ADX, ATR, Supertrend, Stochastic, CCI, pivot points, 8 candlestick patterns |
  339. | **Institutional** | FII/DII daily cash flows, F&O participant OI, FPI sector-wise allocation, buy/sell streaks |
  340. | **Market data** | Bulk/block deals, F&O ban, IPOs, delivery %, MTF, SLBM, heatmaps, signals |
  341. | **Indices** | ~140 NSE indices — level history with PE/PB/DY, plus weekly/monthly return rankings by sector, broad, thematic, and strategy family |
  342. | **Derivatives** | Index option chains with IV and full Greeks, OI, max pain, PCR; IV rank/percentile and realised-vol history for ~556 underlyings including single stocks; India VIX |
  343. | **Analyst** | Buy/hold/sell consensus + EPS/revenue/EBITDA/ROE forecasts with actuals vs estimates |
  344. | **Ownership** | Shareholding patterns (quarterly), dividend history, mutual fund scheme-level holdings |
  345. | **Large trades** | Bulk, block, insider (designated-person), and SAST disclosures with counterparty and value |
  346. | **Governance & risk** | Promoter share-pledge history and events, credit-rating actions by agency with outlook |
  347. | **Scoring** | Tapetide Score — deterministic 0-100 rating with six pillar sub-scores, band, percentile, data confidence, governance caps |
  348. | **Point-in-time** | Split/bonus adjustment factors, per-day observation status, as-of index membership, historical symbol/ISIN resolution — for survivorship-bias-aware backtests |
  349. | **News & Events** | Sentiment-tagged news, corporate actions, filings (annual reports, concall transcripts), AI digests of earnings calls and investor presentations |
  350. | **Filing text** | Concall transcripts, annual reports, investor presentations and IPO documents parsed to page-addressed Markdown, with per-document summaries and PDF/Markdown download links |
  351. | **Portfolio** | Live P&L tracking, sector breakdown, broker CSV import (10+ Indian brokers) |
  352. ## Environment Variables
  353. | Variable | Required | Default | Description |
  354. |----------|----------|---------|-------------|
  355. | `TAPETIDE_TOKEN` | Yes (local) | — | Personal API token from [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens) |
  356. | `TAPETIDE_MCP_URL` | No | `https://mcp.tapetide.com` | Override remote server URL |
  357. | `TAPETIDE_DEBUG` | No | `0` | Set to `1` for debug logging to stderr |
  358. ## Rate Limits
  359. Limits are per Tapetide account and identical across all three access methods (OAuth, remote token,
  360. and this npm bridge) — they follow your plan, not your transport.
  361. | Scope | Free plan | Paid plans |
  362. |-------|-----------|------------|
  363. | Per day | 100 tool calls, for the first 7 days after signup | Per your plan, see [tapetide.com/pricing](https://tapetide.com/pricing) |
  364. | After the first 7 days | Tool calls need a paid plan | No time limit |
  365. | Per calendar month | No monthly cap | Per your plan (unlimited on enterprise) |
  366. | Burst | 60 tool calls per minute | 60 tool calls per minute |
  367. Only **successful tool calls** consume quota. Protocol traffic (`initialize`, `tools/list`) and
  368. burst-denied calls are free. Daily and monthly windows reset on IST boundaries.
  369. When a limit is hit, the server replies with a normal JSON-RPC result carrying `isError: true` and a
  370. message naming the binding cap and its reset time, so your assistant relays it instead of retrying.
  371. Responses carry `X-RateLimit-Reset`, and denials add `Retry-After`. The numeric quota itself is not
  372. exposed as a header — check current usage at
  373. [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens).
  374. ## Troubleshooting
  375. | Problem | Solution |
  376. |---------|----------|
  377. | `TAPETIDE_TOKEN is not set` on a tool call | The bridge starts without a token so tools can be listed, but calls need one. Add it to the `env` section of your MCP config |
  378. | `Token refresh failed (401)` | Token expired. Generate a new one at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens) |
  379. | `Rate limit exceeded` | Wait for reset (shown in error) or check usage at [tapetide.com/settings/tokens](https://tapetide.com/settings/tokens) |
  380. | Server not responding | Ensure Node.js 18+ is installed (`node --version`) |
  381. | Slow first request | Normal — pre-authenticates on startup. Subsequent requests are fast |
  382. | Network errors | Check internet. The bridge needs to reach `mcp.tapetide.com` |
  383. Set `TAPETIDE_DEBUG=1` for detailed logging to stderr.
  384. ## Links
  385. - **[tapetide.com](https://tapetide.com)** — Web platform
  386. - **[tapetide.com/mcp](https://tapetide.com/mcp)** — MCP documentation & setup guide
  387. - **[mcp.tapetide.com](https://mcp.tapetide.com)** — Remote MCP endpoint
  388. - **[npm: tapetide-mcp](https://www.npmjs.com/package/tapetide-mcp)** — npm package
  389. - **[PyPI: tapetide-mcp](https://pypi.org/project/tapetide-mcp/)** — Python package ([source](https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp-python))
  390. - **[@tapetide_hq](https://x.com/tapetide_hq)** — X (Twitter)
  391. - **[GitHub](https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp)** — Source code
  392. - **[Glama](https://glama.ai/mcp/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp)** — MCP directory listing
  393. <a href="https://glama.ai/mcp/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp"><img width="380" src="https://glama.ai/mcp/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp/badges/card.svg" alt="nse-bse-indian-stock-market-data-mcp MCP server" /></a>
  394. ## Support
  395. - Email: [support@tapetide.com](mailto:support@tapetide.com)
  396. - Bugs and feature requests: [GitHub issues](https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp/issues)
  397. ## Privacy
  398. Use of the Tapetide MCP server is covered by the [Privacy Policy](https://tapetide.com/privacy) and the [Terms of Service](https://tapetide.com/terms).
  399. ## Contributing
  400. Issues and pull requests are welcome. For bugs, include the error message and your MCP client name/version.
  401. ## License
  402. [MIT](./LICENSE) — free to use, modify, and distribute.
  403. ---
  404. <p align="center">
  405. <sub>Built by <a href="https://tapetide.com">Tapetide</a> — India's AI-first stock research platform</sub>
  406. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.