Skip to main content
Glama
Tapetide-hq

Tapetide MCP Server

by Tapetide-hq

What is this?

Tapetide MCP Server is a Model Context Protocol server that connects AI assistants to real-time Indian stock market data. It covers all ~8,200 stocks listed on NSE and BSE — from large-cap Nifty 50 to SME stocks.

Ask your AI to look up any stock, run a screener with 326 fundamental filters or real-time technical indicators, pull quarterly financials, check analyst consensus ratings, track your portfolio P&L, monitor FII/DII institutional flows, or get today's bulk deals — all through natural language.

Compatible with: Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, Kiro, VS Code, Codex, Zed, Gemini, Grok, OpenCode, Antigravity, and any MCP-compatible client.

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.

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 (~300 lines, 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

  • Warns on stderr when approaching rate limits

All 34 tools and their logic run on the remote server — the npm package is just the transport layer.

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)

Generate a free personal token at tapetide.com/settings/tokens. Works for both remote and local MCP.

Tools

🔍 Search & Discovery (5 tools)

Tool

Description

search_stocks

Fuzzy search all NSE/BSE stocks by name, symbol, BSE code, or ISIN. Filter by sector/industry.

screen_stocks

Fundamental screener with 326 ratios — PE, ROCE, sales growth, debt/equity, Piotroski score, and more. Plain-English query syntax.

screen_stocks_technical

Real-time technical screener — RSI, MACD, SMA/EMA crossovers, Bollinger Bands, ADX, volume. Supports crosses_above/crosses_below.

get_screener_ratios

Search or browse all 326 available fundamental ratios.

get_trending_stocks

Today's top gainers, losers, and high-volume stocks from Nifty 500.

📊 Company Analysis (3 tools)

Tool

Description

get_company_profile

Full overview — sector, fundamentals, growth metrics, pros/cons. Optionally include technicals (20+ indicators), analyst ratings, and peer comparison in one call.

get_stock_events

News (sentiment-tagged), corporate actions (dividends, splits, bonuses), and filings (annual reports, concall transcripts, investor presentations).

get_stock_ownership

Dividend history with yield calculations + mutual fund scheme-level holdings.

💰 Quotes & Prices (3 tools)

Tool

Description

get_stock_quote

Live price — LTP, change %, volume, market cap, PE, PB, 52-week high/low.

get_batch_quotes

Up to 20 stock quotes in a single call.

get_price_history

Daily or weekly OHLCV with delivery %. Up to 2,000 days of history.

📈 Financials & Fundamentals (3 tools)

Tool

Description

get_financials

Quarterly + annual P&L, balance sheet, cash flow, and ratios. Fetch individual sections or all at once.

get_shareholding

Promoter, FII, DII, and public shareholding patterns over time.

get_forecasts

Analyst forecasts — EPS, revenue, EBITDA, net income, ROA, ROE, and price targets. Actuals vs estimates for spotting earnings surprises.

🏛️ Market Data & Institutional Flows (5 tools)

Tool

Description

get_market_pulse

Quick overview — FII/DII net flows, Nifty 50 PE/PB/DY, top technical signals.

get_fii_dii_detail

30-day daily cash market flows, F&O participant positioning (long/short OI), weekly/monthly/yearly aggregates, buy/sell streaks, cumulative chart data.

get_fpi_sectors

FPI sector-wise investment — AUM share, fortnight change, 1-year cumulative flow.

get_market_news

Sentiment-tagged market news across categories (companies, global, IPO, policy, tech).

market_valuations

Index PE, PB, dividend yield over time — Nifty 50, Bank Nifty, Nifty IT, Midcap 50. Up to 20 years.

📡 Market Insights (8 tools)

Tool

Description

market_deals

Today's bulk and block deals — client name, buy/sell, quantity, price, value.

market_fno_ban

F&O ban list (MWPL ≥ 95%) and stocks approaching ban (80-95%).

market_ipo

Current and upcoming IPOs with subscription data (QIB, retail, NII, total).

market_deliveries

Stocks with highest delivery % today — genuine buying vs speculative trading.

market_mtf

Margin Trading Facility — consolidated figures, per-stock funded positions, trends.

market_slbm

Stock Lending & Borrowing — available stocks, bid prices, yield (short-selling demand).

market_signals

Technical signals — breakouts, MA crossovers, volume spikes, RSI extremes.

market_heatmap

Index heatmap (Nifty 50, Bank Nifty, IT, Pharma, etc.) with multi-timeframe price changes.

💼 Portfolio Management (4 tools)

Tool

Description

get_user_portfolio

Holdings with live prices, P&L (absolute + %), sector breakdown, weight %.

add_portfolio_stocks

Add stocks — supports bulk add and broker CSV import (Zerodha, Groww, Angel One, Dhan, Upstox, 5Paisa, ICICI Direct, Kotak, HDFC Sky, Motilal Oswal).

update_portfolio_stock

Update quantity or average price for additional purchases or partial sells.

remove_portfolio_stocks

Remove stocks from portfolio.

👁️ Watchlist (3 tools)

Tool

Description

get_watchlist

All followed stocks with symbol, name, sector, industry.

add_to_watchlist

Follow one or more stocks (idempotent).

remove_from_watchlist

Unfollow stocks.

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"

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 %

Financials

Quarterly + annual P&L, balance sheet, cash flow, 50+ ratios

Screener

326 fundamental ratios + real-time technical indicators + cross-field comparisons

Technicals

RSI, SMA, EMA, MACD, Bollinger Bands, ADX, ATR, Supertrend, Stochastic, CCI, pivot points, 8 candlestick patterns

Institutional

FII/DII daily cash flows, F&O participant OI, FPI sector-wise allocation, buy/sell streaks

Market data

Bulk/block deals, F&O ban, IPOs, delivery %, MTF, SLBM, heatmaps, signals

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

News & Events

Sentiment-tagged news, corporate actions, filings (annual reports, concall transcripts)

Portfolio

Live P&L tracking, sector breakdown, broker CSV import (10+ Indian brokers)

Environment Variables

Variable

Required

Default

Description

TAPETIDE_TOKEN

Yes (local)

Personal API token from tapetide.com/settings/tokens

TAPETIDE_MCP_URL

No

https://mcp.tapetide.com

Override remote server URL

TAPETIDE_DEBUG

No

0

Set to 1 for debug logging to stderr

Rate Limits

Plan

Hourly

Daily

Remote MCP (OAuth)

100 requests

1,000 requests

Remote MCP (token)

1,000 requests

4,000 requests

Local MCP (npm)

1,000 requests

4,000 requests

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Limit, X-RateLimit-Reset) are included in every response.

Troubleshooting

Problem

Solution

TAPETIDE_TOKEN environment variable is required

Add your token to the env section of your MCP config

Token refresh failed (401)

Token expired. Generate a new one at tapetide.com/settings/tokens

Rate limit exceeded

Wait for reset (shown in error) or check usage at tapetide.com/settings/tokens

Server not responding

Ensure Node.js 18+ is installed (node --version)

Slow first request

Normal — pre-authenticates on startup. Subsequent requests are fast

Network errors

Check internet. The bridge needs to reach mcp.tapetide.com

Set TAPETIDE_DEBUG=1 for detailed logging to stderr.

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.


A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tapetide-hq/nse-bse-indian-stock-market-data-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server