InvestSights Indian Stock Research MCP

Research-grade Indian stock data (NSE/BSE) — fundamentals, forensic accounting scores, DCF valuation, screening, prices & news for 6000+ stocks.

GitHub

Documentation

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:

Get a free key at investsights.in/account/connected-apps
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:

Get a free key at investsights.in/account/connected-apps
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

Method	How it works	Best for
OAuth (Google sign-in)	Browser sign-in + consent screen, revocable anytime	AI chat apps (claude.ai, ChatGPT, Perplexity, Grok)
Personal key (remote)	`Authorization: Bearer usk_...` header, or key-in-URL	Code editors with URL-based MCP (VS Code, Kiro, Zed)
Personal key (local)	`INVESTSIGHTS_TOKEN` env var via npx	stdio MCP clients (Cursor, Windsurf, Claude Desktop)

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

Tool	Description
`get_stock_financials`	Fundamentals and key ratios — P/E, P/B, ROE, ROCE, D/E, margins, growth.
`get_shareholding`	Promoter, FII, DII and public shareholding patterns over time.
`get_stock_comparison`	Side-by-side comparison of fundamentals, valuations and technicals.

🔬 Quality & Valuation

Tool	Description
`get_forensic_score`	Forensic accounting checks — Piotroski F-Score, Beneish M-Score, Altman Z-Score. Bank-aware: financials are assessed on CAMELS instead of manufacturing models.
`get_valuation`	Multi-stage DCF with bull/base/bear scenarios and sensitivity, plus peer-relative valuation — computed server-side, never hallucinated.
`get_analyst_consensus`	Analyst estimates, grades and consensus.

📊 Screening

Tool	Description
`screen_stocks`	Multi-factor stock screener across fundamentals, quality and momentum.

📈 Prices & Technicals

Tool	Description
`get_price_history`	Daily OHLCV history with technical context.
`get_technical_indicators`	RSI, moving averages (5/20/50/200) and more.

📰 Market & News

Tool	Description
`get_market_overview`	Indices, breadth and sector snapshot for the Indian market.
`get_stock_news`	Curated, AI-summarised stock news.
`get_earnings_calendar`	Results dates and economic events.

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

Category	What's included
Stocks	6,000+ NSE & BSE listed companies
Fundamentals	Key ratios, growth metrics, quarterly + annual context
Forensic	Piotroski F, Beneish M, Altman Z — bank-aware (CAMELS)
Valuation	Multi-stage FCFF DCF (scenarios + sensitivity), peer-relative valuation
Screener	163 fundamental + quality + momentum filters
Prices & technicals	EOD OHLCV, RSI, MA-5/20/50/200
Ownership	Promoter / FII / DII / public shareholding over time
News & events	AI-summarised stock news, earnings calendar, economic events

Environment Variables

Variable	Required	Default	Description
`INVESTSIGHTS_TOKEN`	Yes (local)	—	Personal key from investsights.in/account/connected-apps
`INVESTSIGHTS_MCP_URL`	No	`https://investsights.in/api/v2/mcp-public/mcp`	Override remote server URL
`INVESTSIGHTS_DEBUG`	No	`0`	Set to `1` for debug logging to stderr

Rate Limits

Plan	Per minute	Per day
Free (every registered account)	10 requests	100 requests
Pro	30 requests	1,000 requests

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

Troubleshooting

Problem	Solution
`INVESTSIGHTS_TOKEN environment variable is required`	Add your key to the `env` section of your MCP config
`Authentication failed (401)`	Key revoked or mistyped — create a new one at investsights.in/account/connected-apps
`Rate limit exceeded`	Wait for the window to reset, or upgrade for higher limits
Server not responding	Ensure Node.js 18+ is installed (`node --version`)
Network errors	The bridge needs to reach `investsights.in`

Set INVESTSIGHTS_DEBUG=1 for detailed logging to stderr.

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