Octagon

Octagon: MCP для анализа публичных и прогнозных рынков

Сервер Octagon MCP предоставляет специализированные исследования и анализ финансовых данных на базе ИИ, интегрируясь с API Octagon Market Intelligence. Это позволяет пользователям анализировать и извлекать инсайты из публичных отчетов, звонков о доходах, финансовых показателей, данных по акциям и криптовалютам, новостей по акциям, а также новостей и исследований прогнозных рынков прямо в Claude Desktop и других популярных MCP-клиентах.

Инструменты

✅ octagon-agent организует комплексный анализ рыночной информации

• Инсайты публичных рынков: отчеты SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), транскрипты звонков о доходах
• Данные рынков акций и криптовалют: торговля акциями, данные о торговле криптовалютами, новости, пресс-релизы, структура собственности и пакеты акций

✅ octagon-deep-research-agent для всестороннего глубокого исследования

• Мульти-источниковый синтез для ответов на инвестиционные исследовательские вопросы
• Лучше всего подходит для актуального, кросс-источникового тематического анализа

✅ Инструментарий для исследования прогнозных рынков

• octagon-prediction-markets-agent для получения обновленных исследовательских отчетов по каждому прогнозному рынку
• prediction_markets_history для структурированного извлечения исторических рыночных данных

✅ Доступ к живой документации Octagon

• octagon-docs-search, octagon-docs-read, octagon-docs-list и octagon-docs-refresh
• MCP-ресурсы для octagon-docs://catalog, octagon-docs://status и octagon-docs://page/{target}

Получите ваш API-ключ Octagon

Чтобы использовать Octagon MCP, вам необходимо:

1. Зарегистрировать бесплатную учетную запись на Octagon
2. После входа в систему в левом меню перейти в раздел API Keys
3. Сгенерировать новый API-ключ
4. Использовать этот API-ключ в вашей конфигурации в качестве значения OCTAGON_API_KEY

Предварительные требования

Перед установкой или запуском Octagon MCP убедитесь, что в вашей системе установлен npx (который поставляется вместе с Node.js и npm).

Mac (macOS)

1. Установите Homebrew (если он еще не установлен):

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

2. Установите Node.js (включает npm и npx):

   brew install node
   

   Это установит последнюю версию Node.js, npm и npx.

3. Проверьте установку:

   node -v
   npm -v
   npx -v
   

Windows

1. Скачайте установщик Node.js:
   • Перейдите на https://nodejs.org/ и скачайте LTS-версию для Windows.
2. Запустите установщик и следуйте инструкциям. Это установит Node.js, npm и npx.
3. Проверьте установку: Откройте командную строку и выполните:

   node -v
   npm -v
   npx -v
   

Если вы увидите номера версий для всех трех компонентов, можно переходить к следующим шагам установки.

Установка

Запуск в Claude Desktop

Чтобы настроить Octagon MCP для Claude Desktop:

1. Откройте Claude Desktop
2. Перейдите в Settings > Developer > Edit Config
3. Добавьте следующее в ваш claude_desktop_config.json (замените your-octagon-api-key на ваш API-ключ Octagon):

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

4. Перезапустите Claude, чтобы изменения вступили в силу

Запуск в Cursor

Настройка Cursor Desktop 🖥️ Примечание: Требуется Cursor версии 0.45.6+

Чтобы настроить Octagon MCP в Cursor:

1. Откройте настройки Cursor
2. Перейдите в Features > MCP Servers
3. Нажмите "+ Add New MCP Server"
4. Введите следующее:
   • Name: "octagon-mcp" (или любое другое имя)
   • Type: "command"
   • Command: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Если вы используете Windows и сталкиваетесь с проблемами, попробуйте cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Замените your-octagon-api-key на ваш API-ключ Octagon.

После добавления обновите список MCP-серверов, чтобы увидеть новые инструменты. Composer Agent будет автоматически использовать Octagon MCP, когда это уместно, но вы можете явно запросить его, описав ваши потребности в инвестиционном исследовании. Доступ к Composer осуществляется через Command+L (Mac), выберите "Agent" рядом с кнопкой отправки и введите ваш запрос.

Запуск через npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Ручная установка

npm install -g octagon-mcp

Документация

Для получения полной документации по использованию агентов Octagon посетите нашу официальную документацию по адресу: https://octagonai.co/docs/

Документация включает:

• Подробные справочники API
• Рекомендации по запросам для конкретных агентов
• Примеры и сценарии использования
• Лучшие практики для инвестиционных исследований

Актуальное руководство по настройке размещенных MCP-клиентов смотрите здесь:

• Руководство по серверу Octagon MCP
• Руководство по плагину Octagon для Claude
• Руководство по агентам Octagon

Этот MCP-сервер также предоставляет живой корпус документации непосредственно MCP-клиентам. Доступ к документации осуществляется через публичную точку входа LLM-документации Octagon по адресу https://octagonai.co/docs/llms.txt; он не использует и не передает OCTAGON_API_KEY.

Доступные инструменты

В настоящее время MCP-сервер предоставляет следующие инструменты:

Инструменты документации

Эти инструменты предоставляют живую документацию Octagon внутри MCP-сессии. Они работают даже до настройки OCTAGON_API_KEY, что делает их полезными для настройки, устранения неполадок и поиска подходящего агента или рабочего процесса API Octagon.

octagon-docs-list

Выводит список разделов и страниц живой документации из корпуса документации Octagon.

Параметры

• section (строка, необязательно): фильтр по разделу документации.
• source (docs, site или all, необязательно): по умолчанию используется корпус документации.
• limit (число, необязательно): максимальное количество возвращаемых записей.

octagon-docs-search

Выполняет поиск по документации API, агентов, MCP и плагинов Octagon с URL-адресами источников и опциональными фрагментами.

Параметры

• query (строка, обязательно): поисковый запрос.
• section (строка, необязательно): фильтр по разделу документации.
• source (docs, site или all, необязательно): по умолчанию используется корпус документации.
• limit (число, необязательно): максимальное количество возвращаемых результатов.
• includeSnippets (логическое, необязательно): включать соответствующие фрагменты в результаты.

Пример:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Читает одну страницу или раздел документации в формате Markdown по заголовку, URL, пути или идентификатору каталога.

Параметры

• target (строка, обязательно): заголовок, URL, путь или идентификатор каталога документации.
• source (docs, site или all, необязательно): по умолчанию используется корпус документации.
• maxChars (число, необязательно): максимальное количество возвращаемых символов Markdown.
• preferCachedContent (логическое, необязательно): использовать индексированный корпус документации, если он доступен.

Пример:

Read the Octagon MCP server guide.

octagon-docs-refresh

Обновляет каталог документации в памяти из актуальных конечных точек документации, оптимизированных для LLM.

Параметры

• includeSite (логическое, необязательно): также обновить более широкий индекс сайта https://octagonai.co/llms.txt.

Ресурсы документации

Клиенты, поддерживающие ресурсы MCP, также могут просматривать:

• octagon-docs://catalog: нормализованный каталог живой документации.
• octagon-docs://status: состояние кэша, исходные конечные точки и метаданные обновления.
• octagon-docs://page/{target}: одна страница или раздел документации в формате Markdown.

octagon-agent

Организует анализ публичной и частной рыночной информации.

Параметры

• prompt (строка, обязательно): исследовательский запрос на естественном языке.
• conversation (строка, необязательно): идентификатор существующей беседы Octagon для продолжения предыдущего потока octagon-agent. Не указывайте его при первом обращении.
• newConversation (логическое, необязательно): если true, запускает новый поток Octagon для активной привязки сессии/потока. Рекомендуется для первого обращения в совершенно новом видимом чате в хост-приложениях верхнего уровня, таких как Claude Desktop.

Использование с потоками

octagon-agent — это единственный инструмент MCP, который передает информацию о потоках бесед Octagon. Это инструмент с состоянием, и он ожидает непрерывности сессии. MCP определяет состояние сессии/потока в следующем порядке:

1. сохраненная беседа для идентификатора транспортной сессии MCP, если транспорт действительно предоставляет его
2. сохраненная беседа для управляемой сервером сессии по умолчанию stdio
3. явный conversation все еще может переопределить активную беседу сессии для этого вызова

В настоящее время этот пакет работает как MCP-сервер stdio. В режиме stdio сервер автоматически устанавливает локальную для процесса сессию для обеспечения непрерывности между вызовами. Поэтому большинство локальных хостов, таких как Claude Desktop или Cursor, могут использовать octagon-agent без предоставления каких-либо дополнительных полей потоков для базового поведения последующих запросов.

Когда хост верхнего уровня знает, что вызов является первым обращением в новом видимом чате, он должен передать newConversation: true. Это явно очищает любой сохраненный поток Octagon для активной привязки MCP-сессии перед вызовом, что предотвращает нежелательную непрерывность, когда хост stdio повторно использует один и тот же долгоживущий MCP-процесс в нескольких видимых чатах.

Это означает, что вы можете использовать любой из этих шаблонов:

1. Первый вызов: отправьте только prompt
2. Позвольте хосту MCP сохранить непрерывность транспортной сессии или положитесь на сессию stdio по умолчанию
3. Второй вызов: либо
   • отправьте новый prompt в той же MCP-сессии, либо
   • продолжайте использовать тот же процесс MCP stdio, либо
   • явно передайте предыдущий conversation

Идентификатор транспортной сессии является каноническим примитивом непрерывности для совместимых со стандартами MCP-транспортов с состоянием. Для локального использования stdio управляемая сервером сессия процесса обеспечивает непрерывность по умолчанию.

Идентификатор сессии и идентификатор беседы Octagon — это разные понятия:

• Идентификатор MCP-сессии управляет непрерывностью на стороне сервера между вызовами инструментов
• conversation Octagon управляет активным потоком Octagon внутри этой сессии

Результат MCP сохраняет ответ в content, а также возвращает структурированные метаданные для оркестраторов в 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."
  }
}

Пример явной передачи:

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

Пример нового видимого чата:

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

Пример явного обновления:

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

Политика для инструментов с состоянием

• octagon-agent: с состоянием, использует пригодную привязку непрерывности. В хостах stdio по умолчанию используется управляемая сервером сессия процесса, если вы не предоставите явный conversation
• другие инструменты MCP: без состояния и могут работать без непрерывности сессии

Пример:

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

Другие примеры:

• "Каковы были показатели выручки и чистой прибыли Amazon в 4 квартале 2023 года?"
• "Проанализируйте тенденции расходов Tesla на НИОКР за последние 3 года."
• "Какие прогнозы дал генеральный директор NVIDIA относительно спроса на чипы для ИИ во время последнего звонка о доходах?"
• "Сравните коэффициенты цена/прибыль, цена/продажи и EV/EBITDA для 5 крупнейших полупроводниковых компаний."
• "Каков был размер последнего раунда финансирования Anthropic, оценка и ключевые инвесторы?"
• "Сколько инвестиций сделала Andreessen Horowitz в ИИ-стартапы за последние 12 месяцев?"
• "Каковы последние новостные статьи по акциям NVIDIA за прошедшую неделю?"

octagon-deep-research-agent

Выполняет всестороннее глубокое исследование и синтез из множества источников.

Параметры

• prompt (строка, обязательно): исследовательский запрос на естественном языке.

Пример:

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

Другие примеры:

• "Извлеките все поля данных с zillow.com/san-francisco-ca/"
• "Исследуйте финансовое влияние изменений конфиденциальности Apple на доходы и маржу компаний цифровой рекламы"
• "Получите исторические данные о цене Bitcoin за 2023 год и проанализируйте тенденции волатильности цен"
• "Проанализируйте конкурентную динамику на рынке инфраструктуры зарядки электромобилей"

octagon-prediction-markets-agent

Генерирует исследовательские отчеты для событий прогнозного рынка Kalshi.

Параметры

• prompt (строка, обязательно): исследовательский запрос на естественном языке.
• cache (логическое, необязательно): управляет маршрутизацией вариантов агента.
  • не указано: prediction-markets-agent
  • false: prediction-markets-agent:refresh
  • true: prediction-markets-agent:cache

Пример:

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

prediction_markets_history

Извлекает исторические данные для тикера события прогнозного рынка с опциональной пагинацией и временными фильтрами.

Параметры

• event_ticker (строка, обязательно)
• limit (число, необязательно)
• cursor (строка, необязательно)
• captured_from (строка, необязательно)
• captured_to (строка, необязательно)
• include_analysis (логическое, необязательно; если true, запрашивает столбцы анализа)

Пример:

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

Устранение неполадок

1. Проблемы с API-ключом: Убедитесь, что ваш API-ключ Octagon правильно задан в переменных окружения или конфигурационном файле.
2. Проблемы с подключением: Убедитесь, что соединение с API Octagon работает корректно.
3. Ограничение частоты запросов: Если вы столкнулись с ошибками ограничения частоты, уменьшите частоту запросов.

Лицензия

MIT

Отдельные специализированные MCP-серверы

Хотя этот сервер предоставляет комплексную рыночную аналитику, объединяя всех наших специализированных агентов, вы также можете использовать отдельные MCP-серверы для конкретных задач:

Инструменты для исследований

• Octagon Deep Research MCP — Возможности комплексного исследования и веб-скрапинга

---

⭐ Поставьте звёздочку этому репозиторию, если он оказался полезным!