GetOutPost MCP Server

Servidor MCP de GetOutpost

Un servidor de Protocolo de Contexto de Modelo (MCP) que lleva datos del mercado de opciones indio en tiempo real y análisis de volatilidad desde GetOutpost.in a tus chats de IA.

¿Qué es esto?

Este servidor MCP permite a Claude analizar datos del mercado de opciones, incluyendo:

• Volatilidad Implícita (IV) - Precios de opciones y expectativas del mercado
• Volatilidad Realizada (RV) - Métricas históricas de movimiento de precios (Close-to-Close, Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang)
• Prima de Riesgo de Volatilidad (VRP) - IV dividido por RV
• Análisis de Sesgo (Skew) - Patrones de sonrisa/gesto de volatilidad entre precios de ejercicio

Perfecto para análisis cuantitativo, investigación de trading de opciones e información de trading basada en datos en mercados indios (NSE, BSE).

Instalación

Opción 1: Mercado de Extensiones de Claude Desktop (Próximamente)

Estado: Enviado y bajo revisión por Anthropic

Una vez aprobado, podrás instalar directamente desde el mercado:

1. Abre Claude Desktop
2. Ve a Configuración → Extensiones
3. Busca "GetOutpost Financial Data"
4. Haz clic en Instalar
5. Configura la ruta de tu archivo de credenciales cuando se te solicite

Opción 2: Descarga Directa (archivo .mcpb)

¡Disponible ahora! Descarga e instala el paquete de extensión directamente:

1. Descarga la última versión: getoutpost-mcp-server-v2.0.0.mcpb
2. Haz doble clic en el archivo .mcpb descargado, o
3. Arrastra y suelta en Claude Desktop, o
4. En Claude Desktop, ve a Configuración → Extensiones → Instalar Extensión y selecciona el archivo
5. Configura la ruta de tu archivo de credenciales cuando se te solicite

Opción 3: Instalación Global con NPM

Instala globalmente vía npm:

npm install -g getoutpost-mcp-server

Luego configura:

{
  "mcpServers": {
    "getoutpost": {
      "command": "getoutpost-mcp-stdio",
      "env": {
        "CREDENTIALS_FILE_PATH": "/absolute/path/to/.getoutpost_credentials.json"
      }
    }
  }
}

Obtención de Credenciales de GetOutpost

1. Regístrate en GetOutpost.in
2. Inicia sesión y obtén tu token de acceso y token de actualización desde las herramientas de desarrollo.
3. Crea un archivo de credenciales en ~/.getoutpost_credentials.json:

{
  "ACCESS_TOKEN": "your_access_token_here",
  "REFRESH_TOKEN": "your_refresh_token_here",
  "EMAIL": "your_email@example.com"
}

Nota: El servidor MCP actualiza automáticamente tus tokens y actualiza este archivo cuando los tokens expiran.

Herramientas Disponibles

El servidor proporciona 11 herramientas que Claude puede usar:

Herramientas de Recuperación de Datos

Herramienta	Descripción
get_iv	Obtén datos de volatilidad implícita para símbolos específicos
get_vol	Obtén datos de volatilidad realizada usando varios métodos de cálculo
get_vrp	Obtén la prima de riesgo de volatilidad (IV menos RV)
get_skew	Obtén patrones de sesgo de volatilidad entre precios de ejercicio

Herramientas de Descubrimiento/Filtrado

Herramienta	Descripción
filter_quick_rules_iv_percentile	Encuentra símbolos por rango de percentil de IV
filter_quick_rules_rv_percentile	Encuentra símbolos por rango de percentil de RV
filter_quick_rules_vrp_percentile	Encuentra símbolos por rango de percentil de VRP
filter_quick_rules_skew_percentile	Encuentra símbolos por rango de percentil de sesgo

Herramientas de Escáner de Oportunidades

Herramienta	Descripción
scan_short_vol_atm_straddles	Escanea oportunidades de volatilidad corta usando straddles ATM (IV elevado vs histórico/competidores)
scan_cheap_tail_risk_hedges	Escanea coberturas baratas de riesgo de cola - puts OTM lejanos para protección de cartera
scan_directional_trades_naked_options	Escanea oportunidades de trading direccional usando calls o puts desnudos

Prompts Disponibles

Plantillas de prompts preconstruidas para ayudarte a comenzar:

1. Encontrar oportunidades de volatilidad larga - Descubre símbolos donde comprar opciones tiene sentido (predeterminado: 30 DTE)
2. Encontrar puts OTM baratos - Localiza puts profundamente fuera del dinero extremadamente baratos para cobertura de cola (predeterminado: 29 DTE)
3. Encontrar oportunidades de volatilidad corta - Identifica símbolos para estrategias de venta de opciones (predeterminado: 30 DTE)
4. Encontrar condiciones óptimas de vol corta - Filtrado avanzado para IV moderadamente preciada con RV saludable para evitar reversión a la media (predeterminado: 25 DTE, ATM)
5. Encontrar trades direccionales baratos - Escanea oportunidades de trading direccional baratas usando opciones desnudas
6. Encontrar los mejores straddles de vol corta - Identifica las mejores oportunidades de volatilidad corta usando straddles ATM
7. Encontrar coberturas baratas - Descubre coberturas de riesgo de cola baratas actualmente disponibles para protección de cartera

Accede a estos a través del menú Prompts en Claude Desktop.

Ejemplo de Uso

Una vez instalado, puedes hacer preguntas a Claude como:

"Find stocks with high volatility risk premium for potential short vol strategies"

"What's the volatility skew pattern for NIFTY with 30 days to expiry?"

"Show me the top 10 stocks with the cheapest deep OTM puts"

"Analyze the implied vs realized volatility for RELIANCE using yang_zhang method"

"Are there any cheap directional trade opportunities available?"

"Give me the top short volatility opportunities right now"

"What are some cheap hedges that are currently available?"

O usa los prompts preconstruidos para flujos de trabajo guiados.

Configuración Recomendada

Para mejores resultados:

1. Crea un Proyecto llamado "Options Insights"
2. Descripción del Proyecto: "Accede a datos del mercado de opciones en tiempo real y análisis de volatilidad a través de las APIs financieras de GetOutpost. Analiza volatilidad implícita, volatilidad realizada, prima de riesgo de volatilidad y sesgo en múltiples instrumentos para generar información de trading basada en datos."
3. Agrega Instrucciones Personalizadas: Elige el prompt de sistema apropiado para tu asistente de IA:
   • Para Claude: Copia el contenido de system_prompt_claude.md (versión completa)
   • Para Perplexity: Copia el contenido de system_prompt_perplexity.md (condensado, <1500 caracteres)
4. Usa Claude Sonnet 4 (o equivalente) para un análisis óptimo
5. Inicia chats nuevos al cambiar entre diferentes símbolos o tipos de análisis para evitar problemas de longitud de contexto

Comprensión de Parámetros Clave

• Moneyness: log(Forward/Strike) - Valores positivos = puts OTM, 0 = ATM, Negativos = calls OTM
• Días para Vencimiento (DTE): Días calendario hasta el vencimiento de la opción
• Tipos de Volatilidad:
  • c2c - Close-to-Close
  • parkinson - Estimador basado en rango de Parkinson
  • garman_klass - Estimador de Garman-Klass
  • rogers_satchell - Estimador de Rogers-Satchell
  • yang_zhang - Estimador de Yang-Zhang
  • mean - Promedio de todos los métodos
• Período de Retrospectiva: Días de datos históricos (20, 40, 60 u 80)

Gestión de Tokens

El servidor maneja la autenticación automáticamente:

1. Detecta cuando tu token de acceso expira (error 401)
2. Usa tu token de actualización para obtener nuevas credenciales
3. Actualiza tu archivo de credenciales con los nuevos tokens
4. Reintenta la solicitud fallida sin problemas

Nunca necesitas actualizar tokens manualmente.

Desarrollo

Compilación desde el Código Fuente

# Clone the repository
git clone https://github.com/aoutpost2-rgb/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev:stdio

Ejecución de Pruebas

npm test

Estructura del Proyecto

├── api/              # API client implementation
├── auth/             # Authentication and token management
├── dist/             # Compiled JavaScript (generated)
├── extension/        # MCP extension bundle
├── mcp_server.ts     # HTTP server implementation
├── mcp_server_stdio.ts  # Stdio server implementation
├── mcp_spec.ts       # MCP protocol handlers and tool definitions
└── tests/            # Test files

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Soporte

• Problemas: GitHub Issues
• Soporte de GetOutpost: GetOutpost.in
• Documentación de MCP: Model Context Protocol

Agradecimientos

Construido con el Model Context Protocol SDK de Anthropic.

---

Aviso Legal: Esta herramienta es solo para fines informativos y educativos. Siempre realiza tu propia investigación y consulta con asesores financieros antes de tomar decisiones de trading.