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.
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:
- Obtén una clave gratuita en investsights.in/account/connected-apps
- 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:
- Obtén una clave gratuita en investsights.in/account/connected-apps
- 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 --versionpara 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étodo | Cómo funciona | Mejor para |
|---|---|---|
| OAuth (inicio de sesión de Google) | Inicio de sesión en navegador + pantalla de consentimiento, revocable en cualquier momento | Aplicaciones de chat de IA (claude.ai, ChatGPT, Perplexity, Grok) |
| Clave personal (remoto) | Cabecera Authorization: Bearer usk_..., o clave en URL | Editores de código con MCP basado en URL (VS Code, Kiro, Zed) |
| Clave personal (local) | Variable de entorno INVESTSIGHTS_TOKEN vía npx | Clientes 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
| Herramienta | Descripción |
|---|---|
get_stock_financials | Fundamentos y ratios clave — P/E, P/B, ROE, ROCE, D/E, márgenes, crecimiento. |
get_shareholding | Patrones de tenencia accionaria de promotores, FII, DII y público a lo largo del tiempo. |
get_stock_comparison | Comparación lado a lado de fundamentos, valoraciones y técnicos. |
🔬 Calidad y Valoración
| Herramienta | Descripción |
|---|---|
get_forensic_score | Comprobaciones 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_valuation | DCF 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_consensus | Estimaciones, calificaciones y consenso de analistas. |
📊 Cribado
| Herramienta | Descripción |
|---|---|
screen_stocks | Cribador de acciones multifactorial en fundamentos, calidad y momentum. |
📈 Precios y Técnicos
| Herramienta | Descripción |
|---|---|
get_price_history | Historial diario OHLCV con contexto técnico. |
get_technical_indicators | RSI, medias móviles (5/20/50/200) y más. |
📰 Mercado y Noticias
| Herramienta | Descripción |
|---|---|
get_market_overview | Índices, amplitud y instantánea sectorial para el mercado indio. |
get_stock_news | Noticias de acciones seleccionadas y resumidas por IA. |
get_earnings_calendar | Fechas 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ía | Qué incluye |
|---|---|
| Acciones | Más de 6,000 empresas listadas en NSE y BSE |
| Fundamentos | Ratios clave, métricas de crecimiento, contexto trimestral y anual |
| Forense | Piotroski F, Beneish M, Altman Z — consciente de bancos (CAMELS) |
| Valoración | DCF FCFF multi-etapa (escenarios + sensibilidad), valoración relativa entre pares |
| Cribador | 163 filtros de fundamentos, calidad y momentum |
| Precios y técnicos | OHLCV de fin de día, RSI, MA-5/20/50/200 |
| Propiedad | Tenencia accionaria de promotores / FII / DII / público a lo largo del tiempo |
| Noticias y eventos | Noticias de acciones resumidas por IA, calendario de resultados, eventos económicos |
Variables de Entorno
| Variable | Requerida | Por defecto | Descripción |
|---|---|---|---|
INVESTSIGHTS_TOKEN | Sí (local) | — | Clave personal de investsights.in/account/connected-apps |
INVESTSIGHTS_MCP_URL | No | https://investsights.in/api/v2/mcp-public/mcp | Sobrescribir URL del servidor remoto |
INVESTSIGHTS_DEBUG | No | 0 | Establecer a 1 para registro de depuración en stderr |
Límites de Tasa
| Plan | Por minuto | Por día |
|---|---|---|
| Gratis (cada cuenta registrada) | 10 solicitudes | 100 solicitudes |
| Pro | 30 solicitudes | 1,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
| Problema | Solución |
|---|---|
INVESTSIGHTS_TOKEN environment variable is required | Añ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 exceeded | Espera a que se restablezca la ventana, o mejora para obtener límites más altos |
| Servidor no responde | Asegúrate de que Node.js 18+ esté instalado (node --version) |
| Errores de red | El puente necesita alcanzar investsights.in |
Establece INVESTSIGHTS_DEBUG=1 para registro detallado en stderr.
Enlaces
- investsights.in — Plataforma web
- investsights.in/mcp — Documentación de MCP y guía de configuración
- investsights.in/docs — Referencia completa para desarrolladores y herramientas
- npm: investsights-mcp — Paquete npm
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