# Tapetide MCP Server — Full Reference

> Remote Model Context Protocol (MCP) server giving AI assistants structured access to Indian stock market data for ~8,200 NSE & BSE listed stocks: real-time quotes, quarterly/annual financials, shareholding, historical OHLCV, 20+ technical indicators, analyst ratings and forecasts, a fundamental + technical stock screener, FII/DII institutional flows, and market insights. Data is aggregated from multiple licensed and public sources, cleaned and structured by Tapetide.

## Endpoint

- Server URL (Streamable HTTP): https://mcp.tapetide.com/mcp
- npm package (local stdio bridge): tapetide-mcp — run `npx -y tapetide-mcp`. Use only for clients that cannot connect to a remote MCP URL; everything else should use the remote URL (OAuth or API token).
- Free tier: 50 tool calls/day, up to 1,000/month. Same limits across every connection method.

## Authentication

Three ways to authenticate. Use OAuth where the client supports it; otherwise use an API token.

1. OAuth (recommended) — add the server URL to your client; on first use a browser opens to sign in with Google. Nothing to copy or manage.
2. API token (Bearer header) — get a free token at https://tapetide.com/settings/tokens and send it as `Authorization: Bearer <token>`. No browser sign-in; good for editors and CI.
3. Local stdio bridge (npm package `tapetide-mcp`) — only for clients that cannot connect to a remote MCP URL (e.g. Claude Desktop, Cline, Gemini CLI). Runs `npx -y tapetide-mcp` with `TAPETIDE_TOKEN=<token>`. Requires Node.js 18+. Every client that supports a remote URL should use OAuth or the API token instead.

### Config: OAuth (URL only)

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

### Config: API token (Bearer header)

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

### Config: Local stdio bridge

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

## Per-client setup

- Claude.ai (web): Customize → Connectors → + Add custom connector → paste URL → sign in with Google.
- ChatGPT (web): Settings → Connectors → Create → paste URL → sign in with Google.
- Grok (web): grok.com/connectors → New Connector → Custom → paste URL → sign in with Google.
- Claude Code (CLI): `claude mcp add --transport http tapetide https://mcp.tapetide.com/mcp` (browser sign-in).
- Codex (CLI): `codex mcp add tapetide --url https://mcp.tapetide.com/mcp` then `codex mcp login tapetide`.
- OpenCode (CLI): `opencode mcp add` (choose Remote, paste URL) or add a remote entry to opencode.json.
- Command Code (CLI): `cmd mcp add --transport http tapetide https://mcp.tapetide.com/mcp`.
- Cursor: add the OAuth URL config to `.cursor/mcp.json`; sign in via Settings → MCP.
- Antigravity: Settings → Customizations → Open MCP Config → add to `mcp_config.json` using `serverUrl` (not `url`).
- VS Code: add the OAuth config to `.vscode/mcp.json` (uses `servers`, type `http`).
- Kiro: add the OAuth config to `.kiro/settings/mcp.json`.
- Zed: add to `settings.json` under `context_servers`.
- Claude Desktop, Cline, Gemini CLI: use the local stdio bridge config with an API token.

After connecting, verify with a prompt like: "Check the current price and key ratios for Reliance using Tapetide."

## Tools

Market-data tools (no account needed):

Search & Discovery
- search_stocks — find stocks by name, symbol, BSE code, or ISIN; filter by sector/industry.
- get_trending_stocks — top gainers, losers, and high-volume stocks from Nifty 500.

Company Data
- get_company_profile — sector, about, pros/cons, fundamentals, growth, quote; optional technicals, ratings, peers.
- get_stock_events — news (sentiment-tagged), corporate actions (dividends, splits, bonuses), and filings.
- get_stock_ownership — dividend history and mutual fund holdings for a stock.

Quotes & Prices
- get_stock_quote — current price, change, volume, market cap, PE, PB, 52-week range.
- get_batch_quotes — quotes for up to 20 stocks in one call.
- get_price_history — daily/weekly OHLCV with delivery %, up to 2,000 days.

Financials & Analysis
- get_financials — P&L, balance sheet, cash flow, ratios (quarterly and annual).
- get_shareholding — promoter, FII, DII, and public holdings over time.
- get_forecasts — analyst EPS/revenue/EBITDA estimates vs actuals.

Stock Screener
- screen_stocks — fundamental screener across 326 ratios with AND/OR logic and cross-field filters.
- screen_stocks_technical — real-time technical screener (RSI, MACD, moving-average crossovers, Bollinger Bands, volume, momentum).
- get_screener_ratios — search/list the 326 financial ratios available to the screener.

Market Insights
- get_market_pulse — today's FII/DII flows, market valuations, and top technical signals.
- get_fii_dii_detail — institutional flows (daily/weekly/monthly/yearly) with F&O participant positioning.
- get_fpi_sectors — FPI sector-wise AUM, fortnight change, and 1-year cumulative flows.
- get_market_news — latest market-wide news across categories, sentiment-tagged.
- market_valuations — index PE/PB/DY over time (Nifty 50, Bank Nifty, Nifty IT, and more).
- market_signals — technical signals: breakouts, crossovers, volume spikes, RSI extremes.
- market_heatmap — constituent stocks with price changes and metrics for 16 indices.

Market Data
- market_deals — bulk and block deals with client name, quantity, and price.
- market_fno_ban — F&O ban list and stocks approaching ban (MWPL >= 80%).
- market_deliveries — stocks with highest delivery percentage (>= 50%).
- market_ipo — current and upcoming IPOs with subscription data.
- market_mtf — Margin Trading Facility funded positions and trends.
- market_slbm — Stock Lending & Borrowing with yield calculations.

Account tools (available once you connect your account): watchlist (add, update, remove) and portfolio (add, update, remove, read).

## Links

- Setup guide: https://tapetide.com/mcp
- Free API token: https://tapetide.com/settings/tokens
- Pricing: https://tapetide.com/pricing