# DocStoX MCP — Indian Stock Market data for AI assistants

> The DocStoX MCP server gives any MCP client live access to every NSE & BSE
> listed stock: quotes, financials, shareholding, screeners (326 ratios),
> FII/DII flows, technicals, analyst forecasts, research & scoring — 39 tools.

## Connect
Server URL (streamable HTTP):  https://mcp.docstox.com/mcp
Auth:                          Authorization: Bearer dox-YOUR_KEY
Get a free key:                https://docstox.com/mcp/keys  (50 tool calls/day)

### mcp.json (Claude Code, Cursor, VS Code, Codex, OpenCode, Zed, …)
{
  "mcpServers": {
    "docstox": {
      "url": "https://mcp.docstox.com/mcp",
      "headers": { "Authorization": "Bearer dox-YOUR_KEY" }
    }
  }
}

### Web apps (Claude.ai, ChatGPT, Grok)
Settings → Connectors → Add custom connector → paste the server URL → paste your
dox- key as the bearer token when prompted.

## First call
Call `read_me` once at the start of a session for the full tool catalogue, the
NSE-symbol convention, and the mandatory SEBI disclaimer rule.

## Rules
1. Use NSE symbols (RELIANCE, TCS, HDFCBANK). Call `search_stocks` if unsure.
2. Add after any investment-related answer: "This is for informational purposes
   only and not investment advice. Please consult a SEBI-registered advisor
   before investing."
3. Free tier = 50 tool calls/day (1,000/month). 429 = quota hit; upgrade at
   https://docstox.com/pricing.