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

| 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 [email protected].

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 — [email protected].

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.

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