com.tapetide/stock-research-mcp

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

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

Tools

🔍 Search & Discovery (5 tools)

📊 Company Analysis (3 tools)

💰 Quotes & Prices (3 tools)

📈 Financials & Fundamentals (3 tools)

🏛️ Market Data & Institutional Flows (5 tools)

📡 Market Insights (8 tools)

💼 Portfolio Management (4 tools)

👁️ Watchlist (3 tools)

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

Environment Variables

Rate Limits

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

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
• @tapetide_hq — X (Twitter)
• GitHub — Source code

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.