Octagon MCP Server

oficial

Ofrece investigación de inversiones en tiempo real con amplios datos de mercados privados y públicos.

Documentación

Octagon: MCP para Inteligencia de Mercados Públicos y de Predicción

El servidor MCP Octagon proporciona investigación y análisis financiero especializado impulsado por IA al integrarse con la API de Inteligencia de Mercado de Octagon, lo que permite a los usuarios analizar y extraer información de presentaciones públicas, llamadas de resultados, métricas financieras, datos de acciones y criptomonedas, noticias bursátiles y noticias e investigación de mercados de predicción dentro de Claude Desktop y otros clientes MCP populares.

Herramientas

✅ octagon-agent orquesta análisis amplio de inteligencia de mercado

Información del mercado público: presentaciones ante la SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), transcripciones de llamadas de resultados
Datos del mercado de acciones y criptomonedas: datos de negociación de acciones y criptomonedas, noticias, comunicados de prensa, propiedad y participaciones

✅ octagon-deep-research-agent para investigación profunda integral

Síntesis de múltiples fuentes para preguntas de investigación de inversiones
Ideal para análisis temáticos actualizados y de fuentes cruzadas

✅ Herramientas de investigación de mercados de predicción

octagon-prediction-markets-agent para informes de investigación actualizados sobre cada mercado de predicción
prediction_markets_history para recuperación estructurada de datos históricos del mercado

✅ Acceso a documentación en vivo de Octagon

octagon-docs-search, octagon-docs-read, octagon-docs-list y octagon-docs-refresh
Recursos MCP para octagon-docs://catalog, octagon-docs://status y octagon-docs://page/{target}

Obtenga su Clave API de Octagon

Para usar Octagon MCP, necesita:

Registrarse para obtener una cuenta gratuita en Octagon
Después de iniciar sesión, desde el menú izquierdo, navegue a API Keys
Genere una nueva clave API
Use esta clave API en su configuración como el valor de OCTAGON_API_KEY

Requisitos Previos

Antes de instalar o ejecutar Octagon MCP, necesita tener npx (que viene con Node.js y npm) instalado en su sistema.

Mac (macOS)

Instalar Homebrew (si no lo tiene):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Instalar Node.js (incluye npm y npx):
```
brew install node
```
Esto instalará la última versión de Node.js, npm y npx.
Verificar la instalación:
```
node -v
npm -v
npx -v
```

Windows

Descargar el instalador de Node.js:
- Vaya a https://nodejs.org/ y descargue la versión LTS para Windows.
Ejecute el instalador y siga las instrucciones. Esto instalará Node.js, npm y npx.
Verificar la instalación: Abra el Símbolo del sistema y ejecute:
```
node -v
npm -v
npx -v
```

Si ve números de versión para los tres, está listo para continuar con los pasos de instalación a continuación.

Instalación

Ejecución en Claude Desktop

Para configurar Octagon MCP para Claude Desktop:

Abra Claude Desktop
Vaya a Configuración > Desarrollador > Editar Configuración
Agregue lo siguiente a su claude_desktop_config.json (Reemplace your-octagon-api-key con su clave API de Octagon):

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Reinicie Claude para que los cambios surtan efecto

Ejecución en Cursor

Configuración de Cursor Desktop 🖥️ Nota: Requiere Cursor versión 0.45.6+

Para configurar Octagon MCP en Cursor:

Abra la Configuración de Cursor
Vaya a Funciones > Servidores MCP
Haga clic en "+ Agregar Nuevo Servidor MCP"
Ingrese lo siguiente:
- Nombre: "octagon-mcp" (o su nombre preferido)
- Tipo: "command"
- Comando: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Si está usando Windows y tiene problemas, intente cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Reemplace your-octagon-api-key con su clave API de Octagon.

Después de agregarlo, actualice la lista de servidores MCP para ver las nuevas herramientas. El Agente Compositor usará automáticamente Octagon MCP cuando sea apropiado, pero puede solicitarlo explícitamente describiendo sus necesidades de investigación de inversiones. Acceda al Compositor mediante Comando+L (Mac), seleccione "Agent" junto al botón de enviar e ingrese su consulta.

Ejecución con npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Instalación Manual

npm install -g octagon-mcp

Documentación

Para obtener documentación completa sobre el uso de los agentes de Octagon, visite nuestra documentación oficial en: https://octagonai.co/docs/

La documentación incluye:

Referencias detalladas de la API
Guías de consulta específicas para agentes
Ejemplos y casos de uso
Mejores prácticas para la investigación de inversiones

Para la guía de configuración más reciente del cliente MCP alojado, consulte:

Este servidor MCP también expone el corpus de documentación en vivo directamente a los clientes MCP. El acceso a la documentación se obtiene desde el punto de entrada público de documentos LLM de Octagon en https://octagonai.co/docs/llms.txt; no usa ni transmite OCTAGON_API_KEY.

Herramientas Disponibles

El servidor MCP actualmente expone las siguientes herramientas:

Herramientas de Documentación

Estas herramientas exponen la documentación en vivo de Octagon dentro de la sesión MCP. Funcionan incluso antes de que OCTAGON_API_KEY esté configurado, lo que las hace útiles para la configuración, solución de problemas y descubrimiento del agente de Octagon o flujo de trabajo de API correcto.

`octagon-docs-list`

Enumera secciones y páginas de documentación en vivo del corpus de documentos de Octagon.

Parámetros

section (cadena, opcional): filtrar por sección de documentación.
source (docs, site o all, opcional): por defecto es el corpus de documentos.
limit (número, opcional): entradas máximas a devolver.

`octagon-docs-search`

Busca en la documentación de la API, agente, MCP y plugin de Octagon con URLs de origen y fragmentos opcionales.

Parámetros

query (cadena, requerido): consulta de búsqueda.
section (cadena, opcional): filtrar por sección de documentación.
source (docs, site o all, opcional): por defecto es el corpus de documentos.
limit (número, opcional): resultados máximos a devolver.
includeSnippets (booleano, opcional): incluir fragmentos coincidentes en los resultados.

Ejemplo:

Search Octagon docs for Claude plugin connector setup.

`octagon-docs-read`

Lee una página o sección de documentación como Markdown por título, URL, ruta o ID de catálogo.

Parámetros

target (cadena, requerido): título, URL, ruta o ID de catálogo del documento.
source (docs, site o all, opcional): por defecto es el corpus de documentos.
maxChars (número, opcional): caracteres Markdown máximos a devolver.
preferCachedContent (booleano, opcional): usar el corpus de documentos indexado cuando esté disponible.

Ejemplo:

Read the Octagon MCP server guide.

`octagon-docs-refresh`

Actualiza el catálogo de documentos en memoria desde los puntos finales de documentación en vivo amigables para LLM.

Parámetros

includeSite (booleano, opcional): también actualizar el índice más amplio del sitio https://octagonai.co/llms.txt.

Recursos de Documentación

Los clientes que soportan recursos MCP también pueden explorar:

octagon-docs://catalog: catálogo de documentos en vivo normalizado.
octagon-docs://status: estado de caché, puntos finales de origen y metadatos de actualización.
octagon-docs://page/{target}: una página o sección de documentación como Markdown.

`octagon-agent`

Orquesta el análisis de inteligencia de mercados públicos y privados.

Parámetros

prompt (cadena, requerido): solicitud de investigación en lenguaje natural.
conversation (cadena, opcional): ID de conversación de Octagon existente para continuar un hilo previo de octagon-agent. Omita esto en el primer turno.
newConversation (booleano, opcional): si es true, inicia un nuevo hilo de Octagon para el ancla de sesión/hilo activo. Recomendado para el primer turno de un nuevo chat visible en hosts de capa superior como Claude Desktop.

Uso con hilos

octagon-agent es la única herramienta MCP que reenvía el enhebrado de conversación de Octagon. Es una herramienta con estado y espera continuidad de sesión. El MCP resuelve el estado de sesión/hilo en este orden:

conversación almacenada para la identidad de sesión de transporte MCP, cuando el transporte realmente la proporciona
conversación almacenada para la sesión predeterminada stdio gestionada por el servidor
conversation explícito aún puede anular la conversación de sesión activa para esa llamada

Este paquete actualmente se ejecuta como un servidor MCP stdio. En modo stdio, el servidor establece automáticamente una sesión local al proceso para la continuidad entre llamadas. La mayoría de los hosts locales como Claude Desktop o Cursor pueden, por lo tanto, usar octagon-agent sin proporcionar ningún campo de enhebrado adicional para un comportamiento básico de seguimiento.

Cuando un host de capa superior sabe que una llamada es el primer turno de un nuevo chat visible, debe pasar newConversation: true. Eso limpia explícitamente cualquier hilo de Octagon almacenado para el ancla de sesión MCP activa antes de la llamada, lo que previene la continuidad obsoleta cuando un host stdio reutiliza el mismo proceso MCP de larga duración en múltiples chats visibles.

Esto significa que puede usar cualquiera de estos patrones:

Primera llamada: envíe solo prompt
Deje que el host MCP preserve la continuidad de la sesión de transporte o confíe en la sesión stdio predeterminada
Segunda llamada: ya sea
- envíe el nuevo prompt en la misma sesión MCP, o
- siga usando el mismo proceso MCP stdio, o
- pase explícitamente el conversation anterior

La identidad de sesión de transporte es la primitiva de continuidad canónica para transportes MCP con estado que cumplen con los estándares. Para uso local stdio, la sesión de proceso gestionada por el servidor proporciona continuidad predeterminada.

La identidad de sesión y la identidad de conversación de Octagon son conceptos diferentes:

La identidad de sesión MCP controla la continuidad del lado del servidor a través de las llamadas a herramientas
conversation de Octagon controla el hilo activo de Octagon dentro de esa sesión

El resultado MCP mantiene la respuesta en content, y también devuelve metadatos estructurados para orquestadores en structuredContent:

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

Ejemplo de transferencia explícita:

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

Ejemplo de nuevo chat visible:

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

Ejemplo de actualización explícita:

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

Política de herramientas con estado

octagon-agent: con estado, usa un ancla de continuidad utilizable. En hosts stdio, eso por defecto es la sesión de proceso gestionada por el servidor a menos que proporcione conversation explícito
otras herramientas MCP: sin estado y pueden ejecutarse sin continuidad de sesión

Ejemplo:

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

Más ejemplos:

"¿Cuáles fueron las cifras de ingresos y beneficio neto de Amazon en el cuarto trimestre de 2023?"
"Analice las tendencias de gasto en I+D de Tesla en los últimos 3 años."
"¿Qué orientación proporcionó el CEO de NVIDIA sobre la demanda de chips de IA en su última llamada de resultados?"
"Compare las relaciones precio-beneficio, precio-ventas y EV/EBITDA de las 5 principales empresas de semiconductores."
"¿Cuál fue el tamaño de la última ronda de financiación de Anthropic, su valoración y los inversores clave?"
"¿Cuántas inversiones realizó Andreessen Horowitz en startups de IA en los últimos 12 meses?"
"¿Cuáles son los últimos artículos de noticias sobre las acciones de NVIDIA de la semana pasada?"

`octagon-deep-research-agent`

Realiza investigación profunda integral y síntesis de múltiples fuentes.

Parámetros

prompt (cadena, requerido): solicitud de investigación en lenguaje natural.

Ejemplo:

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

Más ejemplos:

"Extraiga todos los campos de datos de zillow.com/san-francisco-ca/"
"Investigue el impacto financiero de los cambios de privacidad de Apple en los ingresos y márgenes de las empresas de publicidad digital"
"Recupere datos históricos del precio de Bitcoin de 2023 y analice las tendencias de volatilidad del precio"
"Analice la dinámica competitiva en el mercado de infraestructura de carga de vehículos eléctricos"

`octagon-prediction-markets-agent`

Genera informes de investigación para eventos del mercado de predicción de Kalshi.

Parámetros

prompt (cadena, requerido): solicitud de investigación en lenguaje natural.
cache (booleano, opcional): controla el enrutamiento de la variante del agente.
- omitido: prediction-markets-agent
- false: prediction-markets-agent:refresh
- true: prediction-markets-agent:cache

Ejemplo:

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

`prediction_markets_history`

Obtiene datos históricos para un ticker de evento del mercado de predicción con paginación opcional y filtros de tiempo.

Parámetros

event_ticker (cadena, requerido)
limit (número, opcional)
cursor (cadena, opcional)
captured_from (cadena, opcional)
captured_to (cadena, opcional)
include_analysis (booleano, opcional; cuando es verdadero, solicita columnas de análisis)

Ejemplo:

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

Solución de Problemas

Problemas con la Clave API: Asegúrese de que su clave API de Octagon esté correctamente configurada en el entorno o archivo de configuración.
Problemas de Conexión: Asegúrese de que la conectividad con la API de Octagon funcione correctamente.
Limitación de Tasa: Si encuentra errores de limitación de tasa, reduzca la frecuencia de sus solicitudes.

Licencia

MIT

Servidores MCP Especializados Individuales

Si bien este servidor proporciona inteligencia de mercado integral combinando todos nuestros agentes especializados, también puede usar nuestros servidores MCP individuales para casos de uso específicos:

Herramientas de Investigación

Octagon Deep Research MCP - Capacidades integrales de investigación y web scraping

⭐ ¡Marque este repositorio con una estrella si lo encuentra útil!