InvestSights — Indian Stock Research MCP Server

The Model Context Protocol server for deep Indian stock research — fundamentals, forensic accounting scores, DCF valuation, screening, prices, technicals and news for 6,000+ NSE & BSE stocks, from Claude, ChatGPT, Perplexity, Cursor & any AI assistant.

Documentation • Quick Start • Tools • Example Prompts • npm

What is this?

InvestSights MCP is a Model Context Protocol server that connects AI assistants to research-grade Indian stock market data — the same engine that powers investsights.in.

Where most market servers stop at quotes and screens, InvestSights adds a research layer: forensic accounting scores (Piotroski F, Beneish M, Altman Z — with bank-aware CAMELS handling), multi-stage DCF + relative valuation, analyst consensus, shareholding patterns and curated news — for 6,000+ NSE/BSE companies.

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

Quick Start

Option 1: Remote MCP with OAuth (claude.ai, ChatGPT, Perplexity, Grok)

Add this URL as a custom connector in your AI chat app:

https://investsights.in/api/v2/mcp-public/mcp

First use opens a browser — sign in with your InvestSights account (Google login) and approve access on the consent screen. 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 key at investsights.in/account/connected-apps

2. Add to your MCP config:

{
  "mcpServers": {
    "investsights": {
      "type": "url",
      "url": "https://investsights.in/api/v2/mcp-public/mcp",
      "headers": {
        "Authorization": "Bearer usk_YOUR_KEY_HERE"
      }
    }
  }
}

URL-only client (no header support)? Use the key-in-URL form: https://investsights.in/api/v2/mcp-public/usk_YOUR_KEY_HERE/mcp

Option 3: Local MCP via npm (Cursor, Windsurf, Claude Desktop, Codex, Gemini CLI)

For stdio-based MCP clients. No cloning or building — runs via npx:

1. Get a free key at investsights.in/account/connected-apps

2. Add to your MCP config:

{
  "mcpServers": {
    "investsights": {
      "command": "npx",
      "args": ["-y", "investsights-mcp"],
      "env": {
        "INVESTSIGHTS_TOKEN": "usk_YOUR_KEY_HERE"
      }
    }
  }
}

Node.js 18+ required for the local option. Run node --version to check.

How It Works

┌─────────────────┐   stdio (JSON-RPC)   ┌───────────────────┐     HTTPS     ┌─────────────────────┐
│  AI Assistant   │ ◄──────────────────► │  investsights-mcp │ ◄───────────► │   investsights.in   │
│  (Claude, etc.) │                      │   (npm package)   │               │  (research backend) │
└─────────────────┘                      └───────────────────┘               └─────────────────────┘

The npm package is a lightweight stdio bridge (~250 lines, zero runtime dependencies). It:

• Reads JSON-RPC from stdin, forwards to the remote InvestSights MCP server, writes responses to stdout

• Auto-detects framing: Content-Length (VS Code, Claude Desktop) or newline-delimited JSON (Claude Code, Kiro)

• Authenticates every request with your personal key as a Bearer token

• Handles SSE responses from the remote server

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

Authentication

Create and revoke keys anytime at investsights.in/account/connected-apps. Same free limits across every method.

Tools

A curated pack of fast, read-only research tools — your AI picks the right one automatically.

🏢 Company Research

🔬 Quality & Valuation

📊 Screening

📈 Prices & Technicals

📰 Market & News

Enterprise: the full 40+ tool catalog — GraphRAG document intelligence, earnings-call analysis, corporate-governance graphs, superstar-investor tracking, portfolio analytics — is available with dedicated keys and custom limits. Contact connect@investsights.in.

Example Prompts

Stock Research

"Compare HDFC Bank vs ICICI Bank — profit growth, ROE, valuation and
 shareholding trends right now"

"Pull TCS fundamentals and shareholding — is FII holding rising or falling?"

Forensic Quality

"Run a forensic accounting check on Suzlon — Piotroski, Beneish, Altman.
 Any red flags?"

"Which looks financially healthier on forensic scores: Zomato or Swiggy?"

Valuation

"What does a DCF say about TCS at today's price? Show bull, base and bear
 scenarios with the key assumptions"

Screening + Technicals

"Find stocks with ROE > 18%, low debt, and RSI under 40 — oversold quality
 names"

"Screen mid-caps with improving margins and P/E below 20 — top 15"

Market Briefing

"Today's Indian market overview — index moves, strongest sector, and this
 week's earnings calendar"

Data Coverage

Environment Variables

Rate Limits

Higher limits and the full tool catalog are available for teams and platforms — connect@investsights.in.

Troubleshooting

Set INVESTSIGHTS_DEBUG=1 for detailed logging to stderr.

Links

• investsights.in — Web platform

• investsights.in/mcp — MCP documentation & setup guide

• investsights.in/docs — Full developer & tool reference

• npm: investsights-mcp — npm package

Compliance

InvestSights is an analytics platform and is not SEBI-registered as a Research Analyst or Investment Adviser. Every tool is read-only and returns data, ratios and scores — never buy/sell recommendations, target prices or personalised advice. All output is educational; consult a SEBI-registered adviser before investing. Investments in securities markets are subject to market risks.

Contributing

Issues and pull requests are welcome for the bridge itself. For bugs, include the error message and your MCP client name/version.

License

MIT — the bridge is free to use, modify and distribute. The InvestSights platform and its data services are proprietary.

Built by InvestSights — a product of SocialCoffee DigiTech Pvt Ltd