Octagon

Octagon: MCP para Inteligência de Mercados Públicos e de Previsão

O servidor MCP Octagon fornece pesquisa e análise financeira especializada com tecnologia de IA, integrando-se à API de Inteligência de Mercado Octagon, permitindo que os usuários analisem e extraiam insights de registros públicos, teleconferências de resultados, métricas financeiras, dados de ações e criptomoedas, notícias de ações e notícias e pesquisas de mercados de previsão dentro do Claude Desktop e outros clientes MCP populares.

Ferramentas

✅ octagon-agent orquestra análises amplas de inteligência de mercado

• Insights de mercado público: registros na SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), transcrições de teleconferências de resultados
• Dados de mercado de ações e criptomoedas: dados de negociação de ações e criptomoedas, notícias, comunicados à imprensa, participações e posições

✅ octagon-deep-research-agent para pesquisa aprofundada abrangente

• Síntese de múltiplas fontes para questões de pesquisa de investimento
• Ideal para análises temáticas atualizadas e entre fontes diversas

✅ Ferramentas de pesquisa de mercado de previsão

• octagon-prediction-markets-agent para relatórios de pesquisa atualizados sobre cada mercado de previsão
• prediction_markets_history para recuperação estruturada de dados históricos de mercado

✅ Acesso à documentação ao vivo do Octagon

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

Obtenha Sua Chave de API Octagon

Para usar o Octagon MCP, você precisa:

1. Criar uma conta gratuita em Octagon
2. Após fazer login, no menu à esquerda, navegue até API Keys
3. Gere uma nova chave de API
4. Use esta chave de API na sua configuração como o valor de OCTAGON_API_KEY

Pré-requisitos

Antes de instalar ou executar o Octagon MCP, você precisa ter o npx (que vem com Node.js e npm) instalado no seu sistema.

Mac (macOS)

1. Instale o Homebrew (se não o tiver):

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

2. Instale o Node.js (inclui npm e npx):

   brew install node
   

   Isso instalará a versão mais recente do Node.js, npm e npx.

3. Verifique a instalação:

   node -v
   npm -v
   npx -v
   

Windows

1. Baixe o instalador do Node.js:
   • Acesse https://nodejs.org/ e baixe a versão LTS para Windows.
2. Execute o instalador e siga as instruções. Isso instalará o Node.js, npm e npx.
3. Verifique a instalação: Abra o Prompt de Comando e execute:

   node -v
   npm -v
   npx -v
   

Se você vir os números de versão para todos os três, está pronto para prosseguir com as etapas de instalação abaixo.

Instalação

Executando no Claude Desktop

Para configurar o Octagon MCP para o Claude Desktop:

1. Abra o Claude Desktop
2. Vá para Configurações > Desenvolvedor > Editar Configuração
3. Adicione o seguinte ao seu claude_desktop_config.json (Substitua your-octagon-api-key pela sua chave de API Octagon):

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

4. Reinicie o Claude para que as alterações tenham efeito

Executando no Cursor

Configurando o Cursor Desktop 🖥️ Nota: Requer Cursor versão 0.45.6+

Para configurar o Octagon MCP no Cursor:

1. Abra as Configurações do Cursor
2. Vá para Funcionalidades > Servidores MCP
3. Clique em "+ Adicionar Novo Servidor MCP"
4. Insira o seguinte:
   • Nome: "octagon-mcp" (ou seu nome preferido)
   • Tipo: "command"
   • Comando: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Se você estiver usando Windows e encontrar problemas, tente cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Substitua your-octagon-api-key pela sua chave de API Octagon.

Após adicionar, atualize a lista de servidores MCP para ver as novas ferramentas. O Agente Composer usará automaticamente o Octagon MCP quando apropriado, mas você pode solicitá-lo explicitamente descrevendo suas necessidades de pesquisa de investimento. Acesse o Composer via Command+L (Mac), selecione "Agent" ao lado do botão enviar e insira sua consulta.

Executando com npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Instalação Manual

npm install -g octagon-mcp

Documentação

Para documentação abrangente sobre o uso dos agentes Octagon, visite nossa documentação oficial em: https://octagonai.co/docs/

A documentação inclui:

• Referências detalhadas da API
• Diretrizes de consulta específicas do agente
• Exemplos e casos de uso
• Melhores práticas para pesquisa de investimento

Para o guia de configuração mais recente do cliente MCP hospedado, consulte:

• Guia do Servidor MCP Octagon
• Guia do Plugin Claude Octagon
• Guia dos Agentes Octagon

Este servidor MCP também expõe o corpus de documentação ao vivo diretamente para clientes MCP. O acesso à documentação é obtido do ponto de entrada LLM público da documentação Octagon em https://octagonai.co/docs/llms.txt; ele não usa ou transmite OCTAGON_API_KEY.

Ferramentas Disponíveis

O servidor MCP atualmente expõe as seguintes ferramentas:

Ferramentas de Documentação

Essas ferramentas expõem a documentação ao vivo do Octagon dentro da sessão MCP. Elas funcionam mesmo antes de OCTAGON_API_KEY ser configurado, o que as torna úteis para configuração, solução de problemas e descoberta do agente ou fluxo de trabalho da API Octagon correto.

octagon-docs-list

Lista seções e páginas da documentação ao vivo do corpus de documentação Octagon.

Parâmetros

• section (string, opcional): filtrar por seção da documentação.
• source (docs, site ou all, opcional): o padrão é o corpus de documentação.
• limit (número, opcional): máximo de entradas a retornar.

octagon-docs-search

Pesquisa a documentação da API, agente, MCP e plugin do Octagon com URLs de origem e trechos opcionais.

Parâmetros

• query (string, obrigatório): consulta de pesquisa.
• section (string, opcional): filtrar por seção da documentação.
• source (docs, site ou all, opcional): o padrão é o corpus de documentação.
• limit (número, opcional): máximo de resultados a retornar.
• includeSnippets (booleano, opcional): incluir trechos correspondentes nos resultados.

Exemplo:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Lê uma página ou seção da documentação como Markdown por título, URL, caminho ou ID de catálogo.

Parâmetros

• target (string, obrigatório): título, URL, caminho ou ID de catálogo da documentação.
• source (docs, site ou all, opcional): o padrão é o corpus de documentação.
• maxChars (número, opcional): máximo de caracteres Markdown a retornar.
• preferCachedContent (booleano, opcional): usar o corpus de documentação indexado quando disponível.

Exemplo:

Read the Octagon MCP server guide.

octagon-docs-refresh

Atualiza o catálogo de documentação em memória a partir dos endpoints de documentação ao vivo amigáveis para LLM.

Parâmetros

• includeSite (booleano, opcional): atualizar também o índice mais amplo do site https://octagonai.co/llms.txt.

Recursos de Documentação

Clientes que suportam recursos MCP também podem navegar:

• octagon-docs://catalog: catálogo de documentação ao vivo normalizado.
• octagon-docs://status: estado do cache, endpoints de origem e metadados de atualização.
• octagon-docs://page/{target}: uma página ou seção da documentação como Markdown.

octagon-agent

Orquestra análises de inteligência de mercado público e privado.

Parâmetros

• prompt (string, obrigatório): solicitação de pesquisa em linguagem natural.
• conversation (string, opcional): ID de conversa Octagon existente para continuar um thread octagon-agent anterior. Omita isso no primeiro turno.
• newConversation (booleano, opcional): se true, inicia um novo thread Octagon para a âncora de sessão/thread ativa. Recomendado para o primeiro turno de um novo chat visível em hosts de camada superior, como o Claude Desktop.

Uso encadeado

octagon-agent é a única ferramenta MCP que encaminha o encadeamento de conversa Octagon. É uma ferramenta com estado e espera continuidade de sessão. O MCP resolve o estado de sessão/thread nesta ordem:

1. conversa armazenada para a identidade da sessão de transporte MCP, quando o transporte realmente a fornece
2. conversa armazenada para a sessão padrão stdio gerenciada pelo servidor
3. conversation explícito ainda pode substituir a conversa da sessão ativa para essa chamada

Este pacote atualmente é executado como um servidor MCP stdio. No modo stdio, o servidor estabelece automaticamente uma sessão local ao processo para continuidade entre chamadas. A maioria dos hosts locais, como Claude Desktop ou Cursor, pode, portanto, usar octagon-agent sem fornecer campos de encadeamento extras para comportamento básico de acompanhamento.

Quando um host de camada superior sabe que uma chamada é o primeiro turno de um novo chat visível, ele deve passar newConversation: true. Isso limpa explicitamente qualquer thread Octagon armazenado para a âncora de sessão MCP ativa antes da chamada, o que evita continuidade obsoleta quando um host stdio reutiliza o mesmo processo MCP de longa duração em vários chats visíveis.

Isso significa que você pode usar qualquer um destes padrões:

1. Primeira chamada: envie apenas prompt
2. Deixe o host MCP preservar a continuidade da sessão de transporte ou confie na sessão stdio padrão
3. Segunda chamada: ou
   • envie o novo prompt na mesma sessão MCP, ou
   • continue usando o mesmo processo MCP stdio, ou
   • passe explicitamente o conversation anterior

A identidade da sessão de transporte é a primitiva de continuidade canônica para transportes MCP com estado compatíveis com os padrões. Para uso local stdio, a sessão de processo gerenciada pelo servidor fornece continuidade padrão.

Identidade de sessão e identidade de conversa Octagon são conceitos diferentes:

• A identidade da sessão MCP controla a continuidade do lado do servidor entre chamadas de ferramentas
• O conversation Octagon controla o thread Octagon ativo dentro dessa sessão

O resultado MCP mantém a resposta em content e também retorna metadados estruturados para orquestradores em 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."
  }
}

Exemplo explícito de transporte:

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

Exemplo de novo chat visível:

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

Exemplo de atualização explícita:

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

Política de ferramenta com estado

• octagon-agent: com estado, usa uma âncora de continuidade utilizável. Em hosts stdio, o padrão é a sessão de processo gerenciada pelo servidor, a menos que você forneça conversation explícito
• outras ferramentas MCP: sem estado e podem ser executadas sem continuidade de sessão

Exemplo:

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

Mais exemplos:

• "Quais foram os números de receita e lucro líquido da Amazon no quarto trimestre de 2023?"
• "Analise as tendências de gastos com P&D da Tesla nos últimos 3 anos."
• "Que orientação o CEO da NVIDIA forneceu sobre a demanda por chips de IA em sua última teleconferência de resultados?"
• "Compare os índices preço/lucro, preço/vendas e EV/EBITDA para as 5 principais empresas de semicondutores."
• "Qual foi o tamanho, avaliação e principais investidores da última rodada de financiamento da Anthropic?"
• "Quantos investimentos a Andreessen Horowitz fez em startups de IA nos últimos 12 meses?"
• "Quais são os últimos artigos de notícias para as ações da NVIDIA na última semana?"

octagon-deep-research-agent

Realiza pesquisa aprofundada abrangente e síntese de múltiplas fontes.

Parâmetros

• prompt (string, obrigatório): solicitação de pesquisa em linguagem natural.

Exemplo:

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

Mais exemplos:

• "Extraia todos os campos de dados de zillow.com/san-francisco-ca/"
• "Pesquise o impacto financeiro das mudanças de privacidade da Apple na receita e margens das empresas de publicidade digital"
• "Recupere dados históricos de preços do Bitcoin de 2023 e analise as tendências de volatilidade de preços"
• "Analise a dinâmica competitiva no mercado de infraestrutura de carregamento de VE"

octagon-prediction-markets-agent

Gera relatórios de pesquisa para eventos do mercado de previsão Kalshi.

Parâmetros

• prompt (string, obrigatório): solicitação de pesquisa em linguagem natural.
• cache (booleano, opcional): controla o roteamento da variante do agente.
  • omitido: prediction-markets-agent
  • false: prediction-markets-agent:refresh
  • true: prediction-markets-agent:cache

Exemplo:

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

prediction_markets_history

Busca dados históricos para um ticker de evento de mercado de previsão com paginação opcional e filtros de tempo.

Parâmetros

• event_ticker (string, obrigatório)
• limit (número, opcional)
• cursor (string, opcional)
• captured_from (string, opcional)
• captured_to (string, opcional)
• include_analysis (booleano, opcional; quando verdadeiro, solicita colunas de análise)

Exemplo:

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

Solução de Problemas

1. Problemas com a Chave da API: Certifique-se de que sua chave da API Octagon esteja configurada corretamente no ambiente ou no arquivo de configuração.
2. Problemas de Conexão: Verifique se a conectividade com a API Octagon está funcionando corretamente.
3. Limitação de Taxa: Se você encontrar erros de limitação de taxa, reduza a frequência de suas requisições.

Licença

MIT

Servidores MCP Individuais Especializados

Embora este servidor forneça inteligência de mercado abrangente combinando todos os nossos agentes especializados, você também pode usar nossos servidores MCP individuais para casos de uso específicos:

Ferramentas de Pesquisa

• Octagon Deep Research MCP - Capacidades abrangentes de pesquisa e raspagem web

---

⭐ Dê uma estrela neste repositório se achá-lo útil!