InvestSights Indian Stock Research MCP

Datos de acciones indias de nivel de investigación (NSE/BSE): fundamentos, puntuaciones de contabilidad forense, valoración DCF, selección, precios y noticias para más de 6000 acciones.

Documentación

InvestSights — Servidor MCP de Investigación de Acciones Indias

El servidor de Model Context Protocol para investigación profunda de acciones indias — fundamentos, puntuaciones de contabilidad forense, valoración DCF, cribado, precios, técnicos y noticias para más de 6,000 acciones de NSE y BSE, desde Claude, ChatGPT, Perplexity, Cursor y cualquier asistente de IA.

npm version npm downloads MIT License MCP compatible

Documentación • Inicio Rápido • Herramientas • Ejemplos de Prompts • npm


¿Qué es esto?

InvestSights MCP es un servidor de Model Context Protocol que conecta asistentes de IA a datos de mercado de acciones indias de grado de investigación — el mismo motor que impulsa investsights.in.

Mientras que la mayoría de los servidores de mercado se detienen en cotizaciones y pantallas, InvestSights añade una capa de investigación: puntuaciones de contabilidad forense (Piotroski F, Beneish M, Altman Z — con manejo CAMELS consciente de bancos), DCF multi-etapa + valoración relativa, consenso de analistas, patrones de tenencia accionaria y noticias seleccionadas — para más de 6,000 empresas NSE/BSE.

Compatible con: Claude.ai, Claude Desktop, Claude Code, ChatGPT, Perplexity, Cursor, Windsurf, VS Code (Copilot), Kiro, Zed, Codex, Gemini, Grok, OpenCode, y cualquier cliente compatible con MCP.

Inicio Rápido

Opción 1: MCP remoto con OAuth (claude.ai, ChatGPT, Perplexity, Grok)

Añade esta URL como conector personalizado en tu aplicación de chat de IA:

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

El primer uso abre un navegador — inicia sesión con tu cuenta de InvestSights (inicio de sesión de Google) y aprueba el acceso en la pantalla de consentimiento. No se necesita token.

Opción 2: MCP remoto con Token (Claude Code, VS Code, Kiro, Zed)

Para editores de código que soporten servidores MCP basados en URL con cabeceras personalizadas:

  1. Obtén una clave gratuita en investsights.in/account/connected-apps
  2. Añade a tu configuración de MCP:
{
  "mcpServers": {
    "investsights": {
      "type": "url",
      "url": "https://investsights.in/api/v2/mcp-public/mcp",
      "headers": {
        "Authorization": "Bearer usk_YOUR_KEY_HERE"
      }
    }
  }
}

¿Cliente solo URL (sin soporte de cabeceras)? Usa la forma de clave en URL: https://investsights.in/api/v2/mcp-public/usk_YOUR_KEY_HERE/mcp

Opción 3: MCP local vía npm (Cursor, Windsurf, Claude Desktop, Codex, Gemini CLI)

Para clientes MCP basados en stdio. Sin clonar ni compilar — se ejecuta vía npx:

  1. Obtén una clave gratuita en investsights.in/account/connected-apps
  2. Añade a tu configuración de MCP:
{
  "mcpServers": {
    "investsights": {
      "command": "npx",
      "args": ["-y", "investsights-mcp"],
      "env": {
        "INVESTSIGHTS_TOKEN": "usk_YOUR_KEY_HERE"
      }
    }
  }
}

Node.js 18+ requerido para la opción local. Ejecuta node --version para comprobarlo.

Cómo Funciona

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

El paquete npm es un puente stdio ligero (~250 líneas, cero dependencias en tiempo de ejecución). Hace lo siguiente:

  • Lee JSON-RPC desde stdin, lo reenvía al servidor MCP remoto de InvestSights, escribe respuestas a stdout
  • Detecta automáticamente el encuadre: Content-Length (VS Code, Claude Desktop) o JSON delimitado por líneas nuevas (Claude Code, Kiro)
  • Autentica cada solicitud con tu clave personal como token Bearer
  • Maneja respuestas SSE del servidor remoto

Todas las herramientas y su lógica se ejecutan en el servidor remoto — el paquete npm es solo la capa de transporte.

Autenticación

MétodoCómo funcionaMejor para
OAuth (inicio de sesión de Google)Inicio de sesión en navegador + pantalla de consentimiento, revocable en cualquier momentoAplicaciones de chat de IA (claude.ai, ChatGPT, Perplexity, Grok)
Clave personal (remoto)Cabecera Authorization: Bearer usk_..., o clave en URLEditores de código con MCP basado en URL (VS Code, Kiro, Zed)
Clave personal (local)Variable de entorno INVESTSIGHTS_TOKEN vía npxClientes MCP stdio (Cursor, Windsurf, Claude Desktop)

Crea y revoca claves en cualquier momento en investsights.in/account/connected-apps. Los mismos límites gratuitos en todos los métodos.

Herramientas

Un paquete seleccionado de herramientas de investigación rápidas y de solo lectura — tu IA elige la correcta automáticamente.

🏢 Investigación de Empresas

HerramientaDescripción
get_stock_financialsFundamentos y ratios clave — P/E, P/B, ROE, ROCE, D/E, márgenes, crecimiento.
get_shareholdingPatrones de tenencia accionaria de promotores, FII, DII y público a lo largo del tiempo.
get_stock_comparisonComparación lado a lado de fundamentos, valoraciones y técnicos.

🔬 Calidad y Valoración

HerramientaDescripción
get_forensic_scoreComprobaciones de contabilidad forense — Piotroski F-Score, Beneish M-Score, Altman Z-Score. Consciente de bancos: los estados financieros se evalúan con CAMELS en lugar de modelos de fabricación.
get_valuationDCF multi-etapa con escenarios alcista/base/bajista y sensibilidad, además de valoración relativa entre pares — calculado en el servidor, nunca alucinado.
get_analyst_consensusEstimaciones, calificaciones y consenso de analistas.

📊 Cribado

HerramientaDescripción
screen_stocksCribador de acciones multifactorial en fundamentos, calidad y momentum.

📈 Precios y Técnicos

HerramientaDescripción
get_price_historyHistorial diario OHLCV con contexto técnico.
get_technical_indicatorsRSI, medias móviles (5/20/50/200) y más.

📰 Mercado y Noticias

HerramientaDescripción
get_market_overviewÍndices, amplitud y instantánea sectorial para el mercado indio.
get_stock_newsNoticias de acciones seleccionadas y resumidas por IA.
get_earnings_calendarFechas de resultados y eventos económicos.

Empresas: el catálogo completo de más de 40 herramientas — inteligencia documental GraphRAG, análisis de llamadas de resultados, gráficos de gobierno corporativo, seguimiento de inversores estrella, analítica de carteras — está disponible con claves dedicadas y límites personalizados. Contacta con connect@investsights.in.

Ejemplos de Prompts

Investigación de Acciones

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

Calidad Forense

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

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

Valoración

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

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

Informe de Mercado

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

Cobertura de Datos

CategoríaQué incluye
AccionesMás de 6,000 empresas listadas en NSE y BSE
FundamentosRatios clave, métricas de crecimiento, contexto trimestral y anual
ForensePiotroski F, Beneish M, Altman Z — consciente de bancos (CAMELS)
ValoraciónDCF FCFF multi-etapa (escenarios + sensibilidad), valoración relativa entre pares
Cribador163 filtros de fundamentos, calidad y momentum
Precios y técnicosOHLCV de fin de día, RSI, MA-5/20/50/200
PropiedadTenencia accionaria de promotores / FII / DII / público a lo largo del tiempo
Noticias y eventosNoticias de acciones resumidas por IA, calendario de resultados, eventos económicos

Variables de Entorno

VariableRequeridaPor defectoDescripción
INVESTSIGHTS_TOKENSí (local)—Clave personal de investsights.in/account/connected-apps
INVESTSIGHTS_MCP_URLNohttps://investsights.in/api/v2/mcp-public/mcpSobrescribir URL del servidor remoto
INVESTSIGHTS_DEBUGNo0Establecer a 1 para registro de depuración en stderr

Límites de Tasa

PlanPor minutoPor día
Gratis (cada cuenta registrada)10 solicitudes100 solicitudes
Pro30 solicitudes1,000 solicitudes

Límites más altos y el catálogo completo de herramientas están disponibles para equipos y plataformas — connect@investsights.in.

Solución de Problemas

ProblemaSolución
INVESTSIGHTS_TOKEN environment variable is requiredAñade tu clave a la sección env de tu configuración de MCP
Authentication failed (401)Clave revocada o mal escrita — crea una nueva en investsights.in/account/connected-apps
Rate limit exceededEspera a que se restablezca la ventana, o mejora para obtener límites más altos
Servidor no respondeAsegúrate de que Node.js 18+ esté instalado (node --version)
Errores de redEl puente necesita alcanzar investsights.in

Establece INVESTSIGHTS_DEBUG=1 para registro detallado en stderr.

Enlaces

Cumplimiento

InvestSights es una plataforma de análisis y no está registrada en SEBI como Analista de Investigación o Asesor de Inversiones. Cada herramienta es de solo lectura y devuelve datos, ratios y puntuaciones — nunca recomendaciones de compra/venta, precios objetivo o asesoramiento personalizado. Todo el resultado es educativo; consulta a un asesor registrado en SEBI antes de invertir. Las inversiones en mercados de valores están sujetas a riesgos de mercado.

Contribuciones

Se aceptan issues y pull requests para el propio puente. Para errores, incluye el mensaje de error y el nombre/versión de tu cliente MCP.

Licencia

MIT — el puente es libre de usar, modificar y distribuir. La plataforma InvestSights y sus servicios de datos son propietarios.


Construido por InvestSights — un producto de SocialCoffee DigiTech Pvt Ltd