Model Context Protocol · Live

Stock market MCP server for Indian equities

Tapetide MCP gives any AI assistant 52 tools over roughly 8,200 companies listed on NSE and BSE — quotes, financials, shareholding, technicals, a 326-ratio screener, institutional flows, options volatility, and your own portfolio. Add one URL and ask questions in plain language.

https://mcp.tapetide.com/mcp

Sign in with Google, or send a personal token as a bearer header. Free tier, no card.

Setup

Connect in about a minute

Pick the row that matches your client. Registration is automatic — there is no client ID to create and no key to paste on the OAuth paths.

Web assistantsSign in with Google

Claude.ai · ChatGPT · Grok

Nothing to install. Each of these has a connector screen that takes a server URL directly.

  1. Claude.ai — Customize → Connectors → Add custom connector, paste https://mcp.tapetide.com/mcp. Works on Free (one connector), Pro, Max, Team and Enterprise.
  2. ChatGPT — Settings → Connectors → Create, paste the same URL. Plus, Pro, Team, Enterprise and Edu.
  3. Grok — grok.com/connectors → New Connector → Custom, paste the URL.
  4. Sign in with Google when the browser opens. The grant is cached, so it is a one-time step.

CLI agentsSign in with Google

Claude Code · Codex · OpenCode · Command Code

One command, then a browser sign-in. Type /mcp afterwards to confirm.

  1. Run the command for your CLI below.
  2. A browser opens for Google sign-in and redirects back on its own.
  3. OpenCode users can also run opencode mcp add and choose Remote.

Claude Code

claude mcp add --transport http tapetide https://mcp.tapetide.com/mcp

Codex

codex mcp add tapetide --url https://mcp.tapetide.com/mcp
codex mcp login tapetide

Command Code

cmd mcp add --transport http tapetide https://mcp.tapetide.com/mcp

OpenCode — opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tapetide": {
      "type": "remote",
      "url": "https://mcp.tapetide.com/mcp",
      "enabled": true
    }
  }
}

Code editorsSign in with Google

Cursor · VS Code · Kiro · Zed · Antigravity

Add the server to your editor's MCP config. Registration happens automatically — there is no client ID to create.

  1. Paste the config for your editor, keeping the file's existing entries.
  2. Cursor: Settings → MCP → Connect. VS Code and Kiro start it on first use. Antigravity: hit Refresh in the MCP panel.
  3. Sign in with Google in the browser window that opens.

Cursor / Kiro — .cursor/mcp.json or .kiro/settings/mcp.json

{
  "mcpServers": {
    "tapetide": {
      "url": "https://mcp.tapetide.com/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "tapetide": {
      "type": "http",
      "url": "https://mcp.tapetide.com/mcp"
    }
  }
}

Zed — settings.json

{
  "context_servers": {
    "tapetide": {
      "url": "https://mcp.tapetide.com/mcp"
    }
  }
}

Antigravity — mcp_config.json

{
  "mcpServers": {
    "tapetide": {
      "serverUrl": "https://mcp.tapetide.com/mcp"
    }
  }
}

Token headerAPI token

Windsurf · CI · any client with custom headers

No browser step. Use a personal token as a bearer header — the free-tier limits are identical to OAuth.

  1. Create a token at tapetide.com/settings/tokens.
  2. Add the config below and replace the placeholder.
  3. Connects immediately, which is what makes this the right path for headless and CI use.

mcp.json

{
  "mcpServers": {
    "tapetide": {
      "type": "http",
      "url": "https://mcp.tapetide.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Local stdio bridgeAPI token

Claude Desktop · Cline · Gemini CLI

For clients that can only spawn a local process. Needs Node.js 18+; the bridge speaks to this same server.

  1. Create a token at tapetide.com/settings/tokens.
  2. Claude Desktop: Settings → Developer → Edit Config. Cline: cline_mcp_settings.json. Gemini CLI: ~/.gemini/settings.json.
  3. Paste the config, replace the token, restart the client.

npx bridge

{
  "mcpServers": {
    "tapetide": {
      "command": "npx",
      "args": ["-y", "tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Prefer to let the agent do it? Tell it: fetch https://tapetide.com/mcp/llms.txt and connect me to the Tapetide MCP

Catalog

All 52 tools

45 market-data tools plus 7 that read and write your own watchlist and portfolio. The full catalog is listed to every client, signed in or not; the account tools ask you to connect when called anonymously.

Discovery & screening 5 tools

Find a symbol, then narrow ~8,200 listed companies down to a shortlist.

search_stocksResolve a company to its symbol by name, symbol, BSE code or ISIN — including brand names and post-rename aliases. Filterable by sector and industry.
screen_stocksFundamental screener over 326 ratios — valuation, profitability, growth, balance sheet, cash flow, shareholding, with 3Y/5Y/10Y history, AND/OR logic and cross-field comparisons.
screen_stocks_technicalTechnical screener on real-time indicators — RSI, MACD, SMA/EMA crossovers, Bollinger Bands, ADX, volume and momentum, including crosses-above and crosses-below.
get_screener_ratiosSearch or list the full 326-ratio catalog so a query can use exact ratio names instead of guesses.
get_trending_stocksToday's top gainers, losers and most-active stocks from the Nifty 500.

Company analysis 9 tools

Everything about a single company, from the live quote down to the cash flow statement.

get_company_profileSector, business summary, pros and cons, fundamentals (PE, PB, ROE, ROCE, debt/equity), growth metrics and the current quote. Optionally add technicals, analyst ratings, and a comparable-company table with cohort medians, in the same call.
get_stock_quoteLatest price, day change, volume, market cap, PE, PB and the 52-week range.
get_batch_quotesUp to 20 quotes in a single call.
get_financialsProfit & loss, balance sheet, cash flow and ratios — quarterly and annual, each period stamped with when it was actually published so backtests avoid look-ahead bias.
get_shareholdingPromoter, FII, DII and public holdings quarter by quarter, to track institutional accumulation or exit.
get_forecastsAnalyst EPS, revenue, EBITDA, net income, ROA and ROE estimates against actuals, quarterly and annual.
get_stock_eventsSentiment-tagged news, corporate actions (dividends, splits, bonuses, AGMs) and company filings including results, presentations and concall transcripts.
get_stock_ownershipDividend history with yields, plus which mutual fund schemes hold the stock and at what share of AUM.
get_price_historyDaily or weekly OHLCV with delivery percentage, up to 2,000 sessions per call and pageable further back.

Market-wide data 11 tools

The whole tape: institutional flows, index levels, valuations and the daily feeds.

get_market_pulseThe at-a-glance daily snapshot — FII/DII net flows, Nifty 50 valuations and the India VIX in one call.
get_fii_dii_detail30 days of daily cash-market flows, F&O participant long/short OI, weekly, monthly and yearly aggregates, buy/sell streaks and cumulative net flows.
get_fii_dii_flowsAlias of get_fii_dii_detail.
get_fpi_sectorsForeign portfolio investment by sector — AUM share, fortnightly change and one-year cumulative flow.
get_market_newsMarket-wide news across categories with sentiment and related symbols.
get_market_dataOne dispatcher for seven daily feeds: bulk and block deals, F&O ban list, highest delivery percentages, IPOs with subscription data, margin trading facility, stock lending and borrowing, and today's technical signals.
market_heatmapEvery constituent of an index with market cap, PE, PB, returns across 1d to 5y, volume and sector — 16 indices.
market_valuationsIndex PE, PB and dividend yield over time, up to 20 years of history.
get_india_vixThe India VIX fear gauge — latest level, daily change and recent history.
get_index_performanceRank ~140 NSE indices by return over completed weeks or months, filterable 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 price history.

Derivatives & risk 5 tools

Options positioning, volatility regime, and the governance signals that precede trouble.

get_option_chainPer-strike index option chain with implied volatility, full Greeks, bid/ask, open interest, max pain and put-call ratio. NIFTY, BANKNIFTY, FINNIFTY and MIDCPNIFTY, as a stamped end-of-day snapshot.
get_option_iv_historySession-by-session ATM IV, IV rank, IV percentile, realised volatility, PCR, max pain and 25-delta skew for ~556 underlyings, individual stocks included.
get_options_analyticsLatest per-expiry aggregates — ATM IV, IV rank and percentile, realised vol, PCR by OI and volume, max pain, skew and call/put OI.
get_promoter_pledgePromoter share-pledge percentage by quarter plus recent pledge and release events — a standard governance red-flag check.
get_credit_ratingsCredit-rating actions by agency with rating, action and outlook over time.

Research & scoring 4 tools

Who has been trading a stock, what management said, and how it scores.

get_stock_dealsBulk, block, insider and substantial-acquisition disclosures per stock, with counterparty, side, quantity and 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 and headline metrics.

Point-in-time & backtest safety 5 tools

Historical questions answered with explicit uncertainty, so a backtest is not quietly wrong.

get_adjustment_factorsSplit and bonus adjustment timeline for reconstructing raw prices, and the rights or 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.

Portfolio 4 tools · account required

Your own holdings, with live prices and P&L. Needs a connected account.

get_user_portfolioHoldings with live prices, absolute and percentage P&L, invested value, weight, sector and market-cap class.
add_portfolio_stocksAdd holdings one at a time or in bulk, including rows parsed out of a broker CSV or screenshot. Duplicates merge on a weighted-average price.
update_portfolio_stockUpdate quantity and average price for an existing holding after a top-up or partial sell.
remove_portfolio_stocksRemove holdings from the portfolio.

Watchlist 3 tools · account required

Track names you are following. Needs a connected account.

get_watchlistEvery followed stock with sector and industry.
add_to_watchlistFollow one or many stocks. Idempotent.
remove_from_watchlistUnfollow one or many stocks.

Guide & aliases 6 tools

The in-session guide, plus thin redirects for the tool names models reach for most often.

read_meThe full in-session guide: every tool by category, the SEBI disclaimer rule, portfolio-first behaviour and 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 news.
get_corporate_actionsAlias of get_stock_events with corporate actions.
run_preset_screenRedirect that points a preset-screen request at the screener tool that can actually answer it.

Coverage

What the data includes

Aggregated from multiple licensed and public sources, cleaned and structured by us. Regulator and exchange filings sit behind the fundamentals; every response carries its own observation time.

Prices & trading

  • Near-real-time quotes for ~8,200 NSE and BSE listed companies
  • Daily and weekly OHLCV with delivery percentage, 2,000 sessions per call, pageable further back
  • Index level history plus PE/PB/dividend yield for ~140 NSE indices
  • Bulk deals, block deals, insider trades and substantial-acquisition disclosures
  • Margin trading facility, stock lending and borrowing, F&O ban list and delivery leaders

Fundamentals

  • Quarterly and annual profit & loss, balance sheet, cash flow and ratios
  • Point-in-time publication dates per period, so backtests avoid look-ahead bias
  • Shareholding by promoter, FII, DII and public, quarter over quarter
  • Promoter pledge history, credit-rating actions, dividend history
  • Mutual fund schemes holding a stock and their share of AUM

Analysis & signals

  • Fundamental screener across 326 ratios plus a live technical screener
  • 20+ technical indicators — RSI, SMA, EMA, MACD, Bollinger Bands, ADX, ATR, Stochastic, CCI, Supertrend, pivots
  • Analyst consensus ratings, target prices and EPS/revenue/EBITDA forecasts against actuals
  • The Tapetide Score — a deterministic 0-100 composite with six pillar sub-scores
  • Options: per-strike index chains with Greeks, and IV rank, IV percentile, PCR and max-pain history for ~556 underlyings

Flows & context

  • FII and DII daily cash flows with F&O participant positioning and cumulative aggregates
  • FPI investment by sector — AUM share, fortnightly change, one-year flow
  • Index valuations up to 20 years, heatmaps for 16 indices, India VIX
  • IPOs with subscription by category, corporate actions, AGMs
  • Sentiment-tagged company and market news, filings, presentations and concall digests

In practice

Things people actually ask

The assistant picks the tools, runs the independent ones in parallel, and joins the results.

Research a company

  • “Compare HDFC Bank and ICICI Bank on profit growth, ROE and analyst ratings, and tell me which has the stronger balance sheet”
  • “Has promoter holding in Adani Enterprises been falling? Show the quarterly trend alongside FII and DII changes”
  • “Summarise Infosys's last earnings call and flag anything management hedged on”

Screen the market

  • “Mid-caps where FII holding rose last quarter, ROE is above 12% and debt to equity is under 1”
  • “Stocks with RSI below 30 but ROCE above 20% — oversold names that are actually profitable”
  • “Which sectoral index led the last three completed weeks, and what are its strongest constituents”

Follow the money

  • “Are FIIs still net sellers this month? Show the daily flows and the cumulative figure”
  • “Who has been buying Zomato in bulk and block deals over the last six months”
  • “Show me stocks in F&O ban plus the ones above 80% MWPL, with their delivery percentages”

Manage positions

  • “Here is my Zerodha holdings CSV — add it to my portfolio and tell me where I am over-concentrated”
  • “Review my portfolio: which holdings are technically weak and which have a promoter pledge above 20%”
  • “Add Reliance, TCS and Titan to my watchlist and give me a Monday-morning briefing on them”

Limits

Free tier and plans

PlanDailyMonthly
Free50 calls/day1,000/monthSign in with Google or use a personal token
Starter400 calls/dayHigher monthly capFor daily research workflows
Pro1,200 calls/dayHigher monthly capFor agents and automated pipelines

One tool call is one request, and a 20-symbol batch quote still counts as one. Limits are identical across OAuth, personal token and the local bridge. Full pricing at tapetide.com/pricing.

For developers

Protocol details

Streamable HTTP transport. Negotiated protocol revisions: 2024-11-05, 2025-03-26, 2025-11-25. OAuth 2.1 authorization code with PKCE and dynamic client registration, so a compliant client needs nothing but the URL.

PathPurpose
/mcpStreamable HTTP MCP endpoint. POST for calls, GET for SSE, DELETE to close.
/This page for browsers; the MCP endpoint for clients that accept JSON or SSE.
/healthLiveness probe.
/.well-known/oauth-authorization-serverAuthorization-server metadata (RFC 8414).
/.well-known/oauth-protected-resourceProtected-resource metadata (RFC 9728).
/.well-known/openid-configurationOpenID discovery, for clients that look there first.
/registerDynamic client registration (RFC 7591). No manual client setup.
/authorize · /callback · /tokenAuthorization-code flow with PKCE.

A GET to / from a browser returns this page; a client that sends Accept: application/json, text/event-stream gets the MCP endpoint instead, so either URL works in a config. Personal tokens: tapetide.com/settings/tokens.

FAQ

Questions

What is the Tapetide MCP server?

It is a remote Model Context Protocol server for Indian equities. Point an AI assistant at https://mcp.tapetide.com/mcp and it gains 52 tools — 45 covering market data and 7 covering your own watchlist and portfolio — over roughly 8,200 companies listed on NSE and BSE.

What is MCP?

Model Context Protocol is an open standard for connecting AI assistants to external data and tools. One protocol instead of a bespoke integration per assistant, which is why the same server works in Claude, ChatGPT, Cursor, VS Code and the rest.

Is it free?

Yes. The free tier is 50 tool calls per day and up to 1,000 a month, and the limits are the same whichever way you connect — Google sign-in, personal token, or the local npm bridge. Starter and Pro raise the daily ceiling; see tapetide.com/pricing.

How does authentication work?

Three routes, same limits. Sign in with Google over standard OAuth with PKCE and dynamic client registration, so there is nothing to configure. Or send a personal token as an Authorization: Bearer header, which suits editors and CI because there is no browser step. Or run the local stdio bridge with TAPETIDE_TOKEN. Tokens live at tapetide.com/settings/tokens.

Which clients work?

Claude.ai, Claude Desktop, ChatGPT, Grok, Claude Code, Codex, OpenCode, Command Code, Cursor, VS Code, Kiro, Zed, Antigravity, Windsurf, Cline, Gemini CLI, and any other client that speaks MCP. Web assistants paste the URL into their connector screen; editors and CLIs add it to a config file.

Do I need Node.js?

Only for the local stdio bridge, which exists for clients that cannot open a remote URL — Claude Desktop being the common one. Everything else connects to the URL directly with nothing installed.

How current is the data?

Quotes are near real-time, delayed by minutes during market hours. Fundamentals, shareholding and ratios refresh daily after the close. Exchange feeds — flows, deals, bans, deliveries — land as soon as they are published. Option chains are stamped end-of-day snapshots, and every response carries its own observation time so an assistant can state how fresh a number is.

What are the rate limits?

One tool call is one request, and a batch call for 20 quotes still counts as one. A light per-minute cap smooths bursts; a normal conversation never reaches it. Responses carry reset headers so a client knows when the window reopens, and the message on a limit tells you exactly when your quota returns in IST.

How is this different from a stock market REST API?

A REST API hands you endpoints and leaves the orchestration to you. Here the assistant picks the tools, runs the independent ones in parallel, and joins the results — a comparison across two companies can pull profiles, financials, technicals and ratings in a single turn without any code.

Can I use it for backtesting and quantitative research?

Yes, and the point-in-time tools are the reason. Financial periods carry the date they were actually published, index membership answers as-of a date with explicit uncertainty rather than a false yes, adjustment factors let you rebuild raw prices, and missing sessions are labelled by cause so a no-print day is never mistaken for a flat return.

Can it read my portfolio?

Once you connect your account, yes. Portfolio and watchlist tools appear in the catalog for every client but only answer for a signed-in caller. You can paste a broker CSV or a screenshot and the assistant will parse it, confirm the rows with you, and write them in with weighted-average pricing.

Is this investment advice?

No. It is data and analysis. Tapetide is not a SEBI-registered research analyst or investment adviser, and the server instructs connected assistants to say so on any response that carries an investment opinion.