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.
claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp
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.
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:
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):
claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp
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 version
Warns on stderr when the server rate-limits a call, naming the retry delay
Replays the Mcp-Session-Id the server mints at initialize on every later request, so the remote can tie a session's calls together
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
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)
Authorization: Bearer tpt_rt_... header
Code editors with URL-based MCP (VS Code, Kiro, Zed)
Personal Token (local)
TAPETIDE_TOKEN env var via npx
stdio MCP clients (Cursor, Windsurf, Claude Desktop, Codex)
Tip: ask your assistant to call read_me first. 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_history renders the price and volume chart,
market_heatmap the index treemap, and screen_stocks the sortable results table. Text-only hosts
get the same JSON result with nothing missing.
🔍 Discovery & Screening (5 tools)
Tool
Description
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.
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.
Search or browse the full 326-ratio catalog to get exact ratio names for a query.
get_trending_stocks
Today's top gainers, losers, and most-active stocks from the Nifty 500.
📊 Company Analysis (9 tools)
Tool
Description
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.
Daily or weekly OHLCV with delivery %. Up to 2,000 sessions per call, pageable further back.
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.
get_shareholding
Promoter, FII, DII, and public holdings quarter by quarter.
get_forecasts
Analyst EPS, revenue, EBITDA, net income, ROA, and ROE estimates against actuals — for spotting earnings surprises.
Market-wide news across categories with sentiment and related symbols.
get_market_data
One dispatcher for seven daily feeds via dataset: deals, fno_ban, deliveries, ipo, mtf, slbm, signals.
market_heatmap
Every constituent of an index with market cap, PE, PB, returns from 1d to 5y, volume, sector — 16 indices.
market_valuations
Index PE, PB, and dividend yield over time. Up to 20 years.
get_india_vix
The India VIX fear gauge — latest level, daily change, recent history.
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".
get_index_history
OHLC level series plus PE/PB/dividend yield for a single index. The index counterpart of get_price_history.
🎲 Derivatives & Risk (5 tools)
Tool
Description
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.
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.
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.
get_promoter_pledge
Promoter share-pledge percentage by quarter plus pledge/release events — a standard governance red-flag check.
get_credit_ratings
Credit-rating actions by agency with rating, action, and outlook over time.
🔬 Research & Scoring (4 tools)
Tool
Description
get_stock_deals
Bulk, block, insider, and substantial-acquisition (SAST) disclosures per stock, with counterparty, side, quantity, value.
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.
screen_tapetide_scores
Rank and filter the scored universe by band, size bucket, sector, score window, and confidence, with cursor pagination.
get_earnings_call_summary
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
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.
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.
read_document
The 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.
⏳ Point-in-Time & Backtest Safety (5 tools)
Tool
Description
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.
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.
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.
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.
get_identifiers_asof
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
get_user_portfolio
Holdings with live prices, absolute and % P&L, invested value, weight, sector, market-cap class.
add_portfolio_stocks
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_portfolio_stock
Update quantity and average price after a top-up or partial sell.
remove_portfolio_stocks
Remove holdings from the portfolio.
👁️ Watchlist (3 tools)
Requires a connected Tapetide account.
Tool
Description
get_watchlist
Every followed stock with sector and industry.
add_to_watchlist
Follow one or many stocks. Idempotent.
remove_from_watchlist
Unfollow one or many stocks.
📖 Guide & Aliases (6 tools)
Tool
Description
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.
scan_movers
Alias of get_trending_stocks.
get_live_quote
Alias of get_stock_quote.
get_stock_news
Alias of get_stock_events with type: "news".
get_corporate_actions
Alias of get_stock_events with type: "corporate_actions".
run_preset_screen
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
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)
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 candidates"
"Screen for stocks with MACD bullish crossover, volume 2x average, and
within 10% of 52-week high"
"Which small-caps have debt-to-equity below 0.5, operating margin above 20%,
and PE below 15?"
Institutional Flows
"FIIs have been selling for 5 days — show me daily numbers and which sectors
they're pulling out of"
"Compare FII vs DII flows for the last month with Nifty 50 PE — are we near
a historical bottom?"
"Show F&O participant-wise open interest — are FIIs net long or short in
index futures?"
Portfolio & Watchlist
"Add these to my portfolio: 10 RELIANCE at ₹1350, 50 TCS at ₹3800,
25 HDFCBANK at ₹1650"
"I bought 10 more RELIANCE at ₹1400 — update my portfolio and show
my new average cost"
"Which of my holdings are technically weak? Show RSI and MACD for each"
"Watch TATAMOTORS, MARUTI, M&M — compare their PE ratios and quarterly
sales growth"
Derivatives & Volatility
"Is RELIANCE implied volatility high right now? Show IV rank and percentile
versus realised vol over the last year"
"Show the NIFTY option chain around ATM — open interest by strike, max pain,
and the put-call ratio"
"Which sectors led the last 3 completed weeks? Rank the sectoral indices"
Scoring & Risk Screens
"What's the Tapetide Score for TATASTEEL and why — break down the pillars"
"Show me Strong-band pharma stocks among large and mid caps"
"Any governance red flags on this stock? Check promoter pledge trend and
recent credit rating actions"
Backtest Safety
"Was IDEA in the Nifty 500 on 2019-03-31? I need point-in-time membership,
not today's list"
"This stock shows a 60% single-day move in 2022 — was that a split or a real
return? Check the adjustment factors"
Daily Market Briefing
"Full market briefing — FII/DII flows, F&O ban stocks, bulk deals above
50 crores, top delivery stocks, and breakout signals"
"Is the market overvalued? Show Nifty 50 PE vs 5-year and 10-year averages"
"Show the Nifty 50 heatmap — which sectors dragged the index today?"
Data Coverage
Category
What's included
Stocks
All NSE + BSE listed companies (~8,200 including SME)
Price data
Daily OHLCV up to 2,000 days + weekly aggregation + delivery %
~140 NSE indices — level history with PE/PB/DY, plus weekly/monthly return rankings by sector, broad, thematic, and strategy family
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
Analyst
Buy/hold/sell consensus + EPS/revenue/EBITDA/ROE forecasts with actuals vs estimates
Ownership
Shareholding patterns (quarterly), dividend history, mutual fund scheme-level holdings
Large trades
Bulk, block, insider (designated-person), and SAST disclosures with counterparty and value
Governance & risk
Promoter share-pledge history and events, credit-rating actions by agency with outlook
Scoring
Tapetide Score — deterministic 0-100 rating with six pillar sub-scores, band, percentile, data confidence, governance caps
Point-in-time
Split/bonus adjustment factors, per-day observation status, as-of index membership, historical symbol/ISIN resolution — for survivorship-bias-aware backtests
News & Events
Sentiment-tagged news, corporate actions, filings (annual reports, concall transcripts), AI digests of earnings calls and investor presentations
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
Portfolio
Live P&L tracking, sector breakdown, broker CSV import (10+ Indian brokers)
Limits are per Tapetide account and identical across all three access methods (OAuth, remote token,
and this npm bridge) — they follow your plan, not your transport.
Only successful tool calls consume quota. Protocol traffic (initialize, tools/list) and
burst-denied calls are free. Daily and monthly windows reset on IST boundaries.
When a limit is hit, the server replies with a normal JSON-RPC result carrying isError: true and a
message naming the binding cap and its reset time, so your assistant relays it instead of retrying.
Responses carry X-RateLimit-Reset, and denials add Retry-After. The numeric quota itself is not
exposed as a header — check current usage at
tapetide.com/settings/tokens.
Troubleshooting
Problem
Solution
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
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Tapetide Indian Stock Market MCP?
Copie nesta página a configuração http para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Tapetide Indian Stock Market MCP precisa de uma chave de API?
O publicador lista estas variáveis de ambiente: TAPETIDE_TOKEN.
Qual transporte Tapetide Indian Stock Market MCP usa?
Tapetide Indian Stock Market MCP é acessado por HTTP.
Quando Tapetide Indian Stock Market MCP foi verificado pela última vez?