Stock Research MCP

What stock-research-mcp does

stock-research-mcp provides MCP tools for researching Indian equities listed on the NSE and BSE. Its coverage spans approximately 8,000 stocks, from major index constituents to SME companies. The toolset combines live quote data, historical OHLCV series, financial statements, ownership information, corporate filings, market news, index statistics, derivatives data, and institutional-flow reports.

The server is suited to research workflows that need more than a single price lookup. Agents can resolve companies by name, symbol, BSE code, or ISIN, including renamed companies and brand aliases. They can then screen stocks across 326 fundamental ratios or apply technical conditions such as RSI, moving-average crossovers, MACD, Bollinger Bands, ADX, volume, and momentum.

How it works

The hosted endpoint is available at https://mcp.tapetide.com/mcp. Remote clients connect over HTTP and authenticate with Google OAuth or a personal bearer token. Local clients can run a lightweight bridge through npx or uvx; that bridge forwards MCP JSON-RPC requests to the remote service rather than implementing the market-data logic locally.

The npm bridge reads MCP messages from standard input and writes responses to standard output. It supports common Content-Length and newline-delimited JSON framing, handles the remote server's SSE responses, and preserves the MCP session identifier between requests. The Python package provides the same bridge through uvx or pip. Remote tools and updates are therefore available without rebuilding the local bridge.

Setup and configuration

For a local npm setup, use Node.js 18 or newer and configure the server with the TAPETIDE_TOKEN environment variable:

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

A Python setup uses Python 3.10 or newer with uvx tapetide-mcp and the same token variable. URL-capable clients can use the hosted endpoint with an Authorization: Bearer YOUR_TOKEN header. Chat-based remote connections use Google sign-in instead. The repository also provides setup paths for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI, Zed, and Cline, including a Gemini CLI extension and a Claude Code plugin.

Tools and capabilities

• Resolve symbols and company identities with search_stocks.
• Screen on fundamental ratios, technical indicators, sectors, industries, and cross-field conditions.
• Retrieve quotes individually or in batches of up to 20 stocks.
• Read daily or weekly price history for up to 2,000 sessions per request, with publication timestamps on financial periods.
• Inspect quarterly and annual profit and loss, balance sheet, cash flow, ratios, forecasts, shareholding, promoter pledges, credit ratings, dividends, and mutual-fund ownership.
• Analyze FII/DII and FPI flows, market news, India VIX, index performance, valuations, heatmaps, and daily market datasets.
• Examine index option chains, implied-volatility history, expiry aggregates, Greeks, open interest, PCR, max pain, and skew.

Limitations and notes

A free account provides 50 tool calls per day. Authentication is required for local token-based use, while remote chat access uses Google OAuth. Option-chain data is described as a stamped end-of-day snapshot, so it is distinct from the live quote tools. The local npm and Python packages act as transport bridges; tool execution and market-data logic remain on the remote service.