Tapetide

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-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.

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:

Any other client that speaks the Model Context Protocol works too, over remote HTTP or local stdio.

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/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
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
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):

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 (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 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 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

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_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)

📊 Company Analysis (9 tools)

🏛️ Market-Wide Data (11 tools)

🎲 Derivatives & Risk (5 tools)

🔬 Research & Scoring (4 tools)

📄 Filing Text (3 tools)

Parsed filings as text — read the annual report or transcript itself, not just a digest.

⏳ Point-in-Time & Backtest Safety (5 tools)

💼 Portfolio (4 tools)

Requires a connected Tapetide account.

👁️ Watchlist (3 tools)

Requires a connected Tapetide account.

📖 Guide & Aliases (6 tools)

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.

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

Environment Variables

Rate Limits

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

Set TAPETIDE_DEBUG=1 for detailed logging to stderr.

Links

• tapetide.com — Web platform
• tapetide.com/mcp — MCP documentation & setup guide
• mcp.tapetide.com — Remote MCP endpoint
• npm: tapetide-mcp — npm package
• PyPI: tapetide-mcp — Python package (source)
• @tapetide_hq — X (Twitter)
• GitHub — Source code
• Glama — MCP directory listing

Contributing

Issues and pull requests are welcome. For bugs, include the error message and your MCP client name/version.

License

MIT — free to use, modify, and distribute.