InvestSights Indian Stock Research MCP

Dados de ações indianas de nível de pesquisa (NSE/BSE) — fundamentos, pontuações de contabilidade forense, valuation por DCF, triagem, preços e notícias para mais de 6.000 ações.

GitHub

Experimente este MCPPatrocinado

Documentação

InvestSights — Indian Stock Research MCP Server

O servidor Model Context Protocol para pesquisa profunda de ações indianas — fundamentos, pontuações de contabilidade forense, avaliação DCF, triagem, preços, indicadores técnicos e notícias para mais de 6.000 ações da NSE e BSE, a partir do Claude, ChatGPT, Perplexity, Cursor e qualquer assistente de IA.

Documentação • Início Rápido • Ferramentas • Exemplos de Prompts • npm

O que é isso?

O InvestSights MCP é um servidor Model Context Protocol que conecta assistentes de IA a dados de mercado de ações indianas de nível de pesquisa — o mesmo motor que alimenta investsights.in.

Enquanto a maioria dos servidores de mercado para em cotações e telas de triagem, o InvestSights adiciona uma camada de pesquisa: pontuações de contabilidade forense (Piotroski F, Beneish M, Altman Z — com tratamento bancário via CAMELS), avaliação DCF multi-estágio + avaliação relativa, consenso de analistas, padrões de participação acionária e notícias curadas — para mais de 6.000 empresas da NSE/BSE.

Compatível com: Claude.ai, Claude Desktop, Claude Code, ChatGPT, Perplexity, Cursor, Windsurf, VS Code (Copilot), Kiro, Zed, Codex, Gemini, Grok, OpenCode e qualquer cliente compatível com MCP.

Início Rápido

Opção 1: MCP Remoto com OAuth (claude.ai, ChatGPT, Perplexity, Grok)

Adicione esta URL como conector personalizado no seu aplicativo de chat com IA:

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

O primeiro uso abre um navegador — faça login com sua conta InvestSights (login do Google) e aprove o acesso na tela de consentimento. Nenhum token é necessário.

Opção 2: MCP Remoto com Token (Claude Code, VS Code, Kiro, Zed)

Para editores de código que oferecem suporte a servidores MCP baseados em URL com cabeçalhos personalizados:

Obtenha uma chave gratuita em investsights.in/account/connected-apps
Adicione à sua configuração MCP:

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

Cliente apenas de URL (sem suporte a cabeçalho)? Use o formulário com chave na URL: https://investsights.in/api/v2/mcp-public/usk_YOUR_KEY_HERE/mcp

Opção 3: MCP Local via npm (Cursor, Windsurf, Claude Desktop, Codex, Gemini CLI)

Para clientes MCP baseados em stdio. Sem clonagem ou build — executa via npx:

Obtenha uma chave gratuita em investsights.in/account/connected-apps
Adicione à sua configuração MCP:

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

Node.js 18+ é necessário para a opção local. Execute node --version para verificar.

Como Funciona

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

O pacote npm é uma ponte stdio leve (~250 linhas, zero dependências de runtime). Ele:

Lê JSON-RPC da entrada padrão, encaminha para o servidor MCP remoto do InvestSights e escreve as respostas na saída padrão
Detecta automaticamente o enquadramento: Content-Length (VS Code, Claude Desktop) ou JSON delimitado por nova linha (Claude Code, Kiro)
Autentica cada solicitação com sua chave pessoal como token Bearer
Lida com respostas SSE do servidor remoto

Todas as ferramentas e sua lógica são executadas no servidor remoto — o pacote npm é apenas a camada de transporte.

Autenticação

Método	Como funciona	Melhor para
OAuth (login do Google)	Login no navegador + tela de consentimento, revogável a qualquer momento	Aplicativos de chat com IA (claude.ai, ChatGPT, Perplexity, Grok)
Chave pessoal (remoto)	Cabeçalho `Authorization: Bearer usk_...`, ou chave na URL	Editores de código com MCP baseado em URL (VS Code, Kiro, Zed)
Chave pessoal (local)	Variável de ambiente `INVESTSIGHTS_TOKEN` via npx	Clientes MCP stdio (Cursor, Windsurf, Claude Desktop)

Crie e revogue chaves a qualquer momento em investsights.in/account/connected-apps. Mesmos limites gratuitos em todos os métodos.

Ferramentas

Um conjunto selecionado de ferramentas de pesquisa rápidas e somente leitura — sua IA escolhe automaticamente a correta.

🏢 Pesquisa de Empresas

Ferramenta	Descrição
`get_stock_financials`	Fundamentos e indicadores-chave — P/L, P/VP, ROE, ROCE, D/E, margens, crescimento.
`get_shareholding`	Padrões de participação acionária de promovedores, FII, DII e público ao longo do tempo.
`get_stock_comparison`	Comparação lado a lado de fundamentos, avaliações e indicadores técnicos.

🔬 Qualidade e Avaliação

Ferramenta	Descrição
`get_forensic_score`	Verificações de contabilidade forense — Piotroski F-Score, Beneish M-Score, Altman Z-Score. Consciente de bancos: as finanças são avaliadas com CAMELS em vez de modelos de manufatura.
`get_valuation`	DCF multi-estágio com cenários otimista/base/pessimista e sensibilidade, além de avaliação relativa a pares — computada no servidor, nunca alucinada.
`get_analyst_consensus`	Estimativas de analistas, classificações e consenso.

📊 Triagem

Ferramenta	Descrição
`screen_stocks`	Triagem de ações multifatorial em fundamentos, qualidade e momentum.

📈 Preços e Indicadores Técnicos

Ferramenta	Descrição
`get_price_history`	Histórico diário OHLCV com contexto técnico.
`get_technical_indicators`	RSI, médias móveis (5/20/50/200) e mais.

📰 Mercado e Notícias

Ferramenta	Descrição
`get_market_overview`	Índices, amplitude e visão geral do setor para o mercado indiano.
`get_stock_news`	Notícias de ações curadas e resumidas por IA.
`get_earnings_calendar`	Datas de resultados e eventos econômicos.

Enterprise: o catálogo completo de 40+ ferramentas — inteligência documental GraphRAG, análise de chamadas de resultados, gráficos de governança corporativa, rastreamento de investidores superstar, análises de portfólio — está disponível com chaves dedicadas e limites personalizados. Contato: connect@investsights.in.

Exemplos de Prompts

Pesquisa de Ações

"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?"

Qualidade Forense

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

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

Avaliação

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

Triagem + Indicadores Técnicos

"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"

Briefing de Mercado

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

Cobertura de Dados

Categoria	O que está incluído
Ações	Mais de 6.000 empresas listadas na NSE e BSE
Fundamentos	Indicadores-chave, métricas de crescimento, contexto trimestral e anual
Forense	Piotroski F, Beneish M, Altman Z — consciente de bancos (CAMELS)
Avaliação	DCF FCFF multi-estágio (cenários + sensibilidade), avaliação relativa a pares
Triagem	163 filtros de fundamentos + qualidade + momentum
Preços e indicadores	OHLCV de fim do dia, RSI, MA-5/20/50/200
Participação acionária	Promovedores / FII / DII / participação pública ao longo do tempo
Notícias e eventos	Notícias de ações resumidas por IA, calendário de resultados, eventos econômicos

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
`INVESTSIGHTS_TOKEN`	Sim (local)	—	Chave pessoal de investsights.in/account/connected-apps
`INVESTSIGHTS_MCP_URL`	Não	`https://investsights.in/api/v2/mcp-public/mcp`	Substituir URL do servidor remoto
`INVESTSIGHTS_DEBUG`	Não	`0`	Defina como `1` para log de depuração em stderr

Limites de Taxa

Plano	Por minuto	Por dia
Grátis (toda conta registrada)	10 solicitações	100 solicitações
Pro	30 solicitações	1.000 solicitações

Limites maiores e o catálogo completo de ferramentas estão disponíveis para equipes e plataformas — connect@investsights.in.

Solução de Problemas

Problema	Solução
`INVESTSIGHTS_TOKEN environment variable is required`	Adicione sua chave na seção `env` da sua configuração MCP
`Authentication failed (401)`	Chave revogada ou digitada incorretamente — crie uma nova em investsights.in/account/connected-apps
`Rate limit exceeded`	Aguarde a janela redefinir ou faça upgrade para limites maiores
Servidor não respondendo	Verifique se o Node.js 18+ está instalado (`node --version`)
Erros de rede	A ponte precisa alcançar `investsights.in`

Defina INVESTSIGHTS_DEBUG=1 para logging detalhado em stderr.

Conformidade

O InvestSights é uma plataforma de análise e não é registrado na SEBI como Analista de Pesquisa ou Consultor de Investimentos. Cada ferramenta é somente leitura e retorna dados, índices e pontuações — nunca recomendações de compra/venda, preços-alvo ou aconselhamento personalizado. Todo o resultado é educacional; consulte um consultor registrado na SEBI antes de investir. Investimentos em mercados de valores mobiliários estão sujeitos a riscos de mercado.

Contribuindo

Issues e pull requests são bem-vindos para a ponte em si. Para bugs, inclua a mensagem de erro e o nome/versão do seu cliente MCP.

Licença

MIT — a ponte é livre para usar, modificar e distribuir. A plataforma InvestSights e seus serviços de dados são proprietários.

Construído por InvestSights — um produto da SocialCoffee DigiTech Pvt Ltd