Tapetide - Indian Stock Market MCP
com.tapetide · Updated
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
At a glance
Tapetide - Indian Stock Market MCP is an MCP server in the Finance & Data category. It runs locally over stdio via `npx -y tapetide-mcp`, and needs TAPETIDE_TOKEN. It exposes 64 tools, including search_stocks, screen_stocks and screen_stocks_technical. It scores A (93/100) on the MCP Skills Hub health score as of Oct 27, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install Tapetide - Indian Stock Market MCP in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install Tapetide - Indian Stock Market MCP in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add stock-research-mcp -e 'TAPETIDE_TOKEN=<TAPETIDE_TOKEN>' -- npx -y tapetide-mcpFill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. search_stocks, screen_stocks, screen_stocks_technical). It discovers them automatically.
How to install Tapetide - Indian Stock Market MCP in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "stock-research-mcp": { "command": "npx", "args": [ "-y", "tapetide-mcp" ], "env": { "TAPETIDE_TOKEN": "<TAPETIDE_TOKEN>" } } } }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install Tapetide - Indian Stock Market MCP in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "stock-research-mcp": { "command": "npx", "args": [ "-y", "tapetide-mcp" ], "env": { "TAPETIDE_TOKEN": "<TAPETIDE_TOKEN>" } } } }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install Tapetide - Indian Stock Market MCP in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.stock-research-mcp] command = "npx" args = ["-y", "tapetide-mcp"] env = { TAPETIDE_TOKEN = "<TAPETIDE_TOKEN>" }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install Tapetide - Indian Stock Market MCP in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "stock-research-mcp": { "command": "npx", "args": [ "-y", "tapetide-mcp" ], "env": { "TAPETIDE_TOKEN": "<TAPETIDE_TOKEN>" } } } }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install Tapetide - Indian Stock Market MCP in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "stock-research-mcp": { "command": "npx", "args": [ "-y", "tapetide-mcp" ], "env": { "TAPETIDE_TOKEN": "<TAPETIDE_TOKEN>" } } } }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
How to install Tapetide - Indian Stock Market MCP in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "stock-research-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "tapetide-mcp" ], "env": { "TAPETIDE_TOKEN": "<TAPETIDE_TOKEN>" } } } }Fill in your credentials
Replace <TAPETIDE_TOKEN> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does Tapetide - Indian Stock Market MCP need from you?
API key — API token from https://tapetide.com/settings/tokens (free, starts with tpt_rt_)
TAPETIDE_TOKENrequiredsecretEnvironment variableAPI token from https://tapetide.com/settings/tokens (free, starts with tpt_rt_)
TAPETIDE_TOKENrequiredsecretEnvironment variableAPI token from https://tapetide.com/settings/tokens (free, starts with tpt_rt_)
Pass secrets through your shell environment rather than committing them into a config file.
What tools does Tapetide - Indian Stock Market MCP expose? (64)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
- search_stocksResolve 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.
- screen_stocksFundamental screener over 326 ratios — PE, ROCE, sales growth, debt/equity, Piotroski score. Plain-English query syntax with AND/OR logic and cross-field comparisons.
- screen_stocks_technicalReal-time technical screener — RSI, MACD, SMA/EMA crossovers, Bollinger Bands, ADX, volume, momentum. Supports `crosses_above`/`crosses_below`.
- get_screener_ratiosSearch or browse the full 326-ratio catalog to get exact ratio names for a query.
- get_trending_stocksToday's top gainers, losers, and most-active stocks from the Nifty 500.
- get_company_profileFull overview — sector, business summary, pros/cons, fundamentals, growth metrics, current quote. Optionally add technicals (20+ indicators), analyst ratings, and peers in the same call.
- get_stock_quoteLive price — LTP, change %, volume, market cap, PE, PB, 52-week high/low.
- get_batch_quotesUp to 20 stock quotes in a single call.
- get_price_historyDaily or weekly OHLCV with delivery %. Up to 2,000 sessions per call, pageable further back.
- get_financialsQuarterly + 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.
- get_shareholdingPromoter, FII, DII, and public holdings quarter by quarter.
- get_forecastsAnalyst EPS, revenue, EBITDA, net income, ROA, and ROE estimates against actuals — for spotting earnings surprises.
- get_stock_eventsSentiment-tagged news, corporate actions (dividends, splits, bonuses, AGMs), and filings (results, presentations, concall transcripts, annual reports).
- get_stock_ownershipDividend history with yields + which mutual fund schemes hold the stock and at what share of AUM.
- get_market_pulseThe at-a-glance daily snapshot — FII/DII net flows, Nifty 50 valuations, and India VIX in one call.
- get_fii_dii_detail30 days of daily cash-market flows, F&O participant long/short OI, weekly/monthly/yearly aggregates, buy/sell streaks, cumulative net flows.
- get_fii_dii_flowsAlias of `get_fii_dii_detail`.
- get_fpi_sectorsFPI investment by sector — AUM share, fortnightly change, 1-year cumulative flow.
- get_market_newsMarket-wide news across categories with sentiment and related symbols.
- get_market_dataOne dispatcher for seven daily feeds via `dataset`: `deals`, `fno_ban`, `deliveries`, `ipo`, `mtf`, `slbm`, `signals`.
- market_heatmapEvery constituent of an index with market cap, PE, PB, returns from 1d to 5y, volume, sector — 16 indices.
- market_valuationsIndex PE, PB, and dividend yield over time. Up to 20 years.
- get_india_vixThe India VIX fear gauge — latest level, daily change, recent history.
- get_index_performanceRank ~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".
- get_index_historyOHLC level series plus PE/PB/dividend yield for a single index. The index counterpart of `get_price_history`.
- get_option_chainPer-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.
- get_option_iv_historySession-by-session ATM IV, IV rank, IV percentile, realised vol, PCR, max pain, 25-delta skew for ~556 underlyings, individual stocks included.
- get_options_analyticsLatest per-expiry aggregates — ATM IV, IV rank/percentile, realised vol, PCR by OI and volume, max pain, skew, call/put OI.
- get_promoter_pledgePromoter share-pledge percentage by quarter plus pledge/release events — a standard governance red-flag check.
- get_credit_ratingsCredit-rating actions by agency with rating, action, and outlook over time.
- get_stock_dealsBulk, block, insider, and substantial-acquisition (SAST) disclosures per stock, with counterparty, side, quantity, value.
- get_tapetide_scoreThe 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.
- screen_tapetide_scoresRank and filter the scored universe by band, size bucket, sector, score window, and confidence, with cursor pagination.
- get_earnings_call_summaryStructured digest of recent earnings-call transcripts and investor presentations — highlights, risks, guidance, headline metrics.
- list_company_documentsIndex 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.
- get_document_summaryInvestor 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.
- read_documentThe Markdown text of a filing by `doc_id` and page range, with `` markers to cite from. At most 12 pages / 24k chars per call; the result names the pages returned and the `next_pages` to fetch.
- get_adjustment_factorsSplit and bonus adjustment timeline for reconstructing raw prices — plus the rights and demerger events that carry no reliable factor at all.
- get_observation_statusPer-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.
- get_index_membership_asofWas a stock in an index on a given date? Answers `present`, `uncertain`, `absent`, or `out_of_coverage` — survivorship-bias-aware universe construction.
- resolve_identifier_asofMap a historical symbol or ISIN to the company that held it on a date, for old holdings files and recycled tickers.
- get_identifiers_asofThe reverse lookup — which symbol and ISIN a company traded under at a point in time.
- get_user_portfolioHoldings with live prices, absolute and % P&L, invested value, weight, sector, market-cap class.
- add_portfolio_stocksAdd holdings singly or in bulk, including rows parsed from a broker CSV or screenshot. Duplicates merge on a weighted-average price.
- update_portfolio_stockUpdate quantity and average price after a top-up or partial sell.
- remove_portfolio_stocksRemove holdings from the portfolio.
- get_watchlistEvery followed stock with sector and industry.
- add_to_watchlistFollow one or many stocks. Idempotent.
- remove_from_watchlistUnfollow one or many stocks.
- read_meThe full in-session guide — every tool by category, the SEBI disclaimer rule, portfolio-first behaviour, parallel-call patterns. Assistants should call it first.
- scan_moversAlias of `get_trending_stocks`.
- get_live_quoteAlias of `get_stock_quote`.
- get_stock_newsAlias of `get_stock_events` with `type: "news"`.
- get_corporate_actionsAlias of `get_stock_events` with `type: "corporate_actions"`.
- run_preset_screenRedirect that points a preset-screen request at the screener tool that can actually answer it.
- market_deals`get_market_data` with `dataset: "deals"`
- market_fno_ban`get_market_data` with `dataset: "fno_ban"`
- market_deliveries`get_market_data` with `dataset: "deliveries"`
- market_ipo`get_market_data` with `dataset: "ipo"`
- market_mtf`get_market_data` with `dataset: "mtf"`
- market_slbm`get_market_data` with `dataset: "slbm"`
- market_signals`get_market_data` with `dataset: "signals"`
- get_quant_signal`get_tapetide_score` (a different measurement, not a rename)
- screen_by_quant_signal`screen_tapetide_scores` (a different measurement, not a rename)
What the code can do
Read from the published package source — never executed. Parsed 1 of 1 source file.
This server can make network requests and read your environment variables.
How it was published
- No provenance attestation — there is nothing linking this published artifact to a specific source commit.
- 1 npm maintainer — a single point of compromise · last published by tapetide_hq.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit today — Actively maintained.
- 143 GitHub stars — Community adoption signal.
Client compatibility
Health score
A · 93Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 0 days ago.
- Adoption20%65%
143 stars.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (1.0.9).
Documentation
Full READMEIndian Stock Market MCP Server — NSE & BSE Data for Claude, ChatGPT & Cursor
<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>
Documentation • Quick Start • Client Setup Guides • 48 Tools • Example Prompts • npm • PyPI
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.
48 tools (55 including aliases) · about 8,000 NSE/BSE stocks · Remote (OAuth) or local (npx / uvx) · Free: 50 tool calls a day · Setup guides for 16 clients
Works with
Step-by-step setup guides for every major MCP client:
| Chat apps | Code editors & IDEs | Terminal agents | |---|---|---| | Claude.ai | Cursor | Claude Code | | ChatGPT | VS Code (GitHub Copilot) | Codex CLI | | Claude Desktop | Windsurf | Gemini CLI | | Grok | Kiro | OpenCode | | | Zed | Command Code | | | Cline | | | | Antigravity | |
Any other client that speaks the Model Context Protocol works too, over remote HTTP or local stdio.
Quick Start
Excerpt — the full document is on GitHub.
Alternatives to Tapetide - Indian Stock Market MCP
- HemmaBo Host Booking EngineB · 776 runtime tools: 2 HemmaBo tools, 2 host onboarding tools, and 2 VRP verification tools. Not an OTA.
- Pexafy Stock PhotosB · 73Find free-to-use stock photos by words, by image or by similarity; every result names its licence.
- PreReasonA · 86Financial market context for AI agents, with listed companies' results: www.prereason.com/agents.md
- Odoo MCP connector (Speak To Your Database)B · 69Odoo MCP connector for Claude & ChatGPT: ask sales, invoices, stock in plain words. Read-only.
Maintain Tapetide - Indian Stock Market MCP? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/com-tapetide-stock-research-mcp)Catalog data refreshed . Something wrong? Report it.