Octagon

официальный

Предоставлять инвестиционные исследования в реальном времени с обширными данными частных и публичных рынков.

Что можно делать с Octagon MCP?

  • Аналитика публичных рынков — Спрашивайте octagon-agent о документах SEC, стенограммах звонков с инвесторами, данных об акциях и криптовалютах, новостях и долях владения.
  • Синтез углублённых исследований — Используйте octagon-deep-research-agent для анализа инвестиционных вопросов и тематических трендов по нескольким источникам.
  • Аналитика подкастов — Запрашивайте у octagon-podcasts-agent ответы с цитатами о том, что говорили гости в более чем 70 финансовых и деловых подкастах.
  • Отчёты о рынках прогнозов — Получайте исследовательские отчёты о рынках Kalshi и Polymarket через octagon-prediction-markets-agent или загружайте исторические данные с помощью prediction_markets_history.
  • Поиск в актуальной документации — Ищите и читайте документацию Octagon с помощью octagon-docs-search и octagon-docs-read, даже до настройки OCTAGON_API_KEY.

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

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

smithery badge

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

Demo

Инструменты

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

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

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

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

✅ octagon-podcasts-agent для поиска высказываний инвесторов в подкастах

  • Ответы со ссылками на источники из более чем 70 финансовых и деловых шоу (Bloomberg, All-In, Odd Lots, Invest Like the Best, …)
  • Фильтрация по временному интервалу, шоу, ведущему, гостю, компании или тикеру, указанному в вопросе

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

  • 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"
      }
    }
  }
}
  1. Перезапустите 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-клиентов:

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

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

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

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

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

octagon-docs-list

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

Параметры

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

octagon-docs-search

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

Параметры

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

Пример:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

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

Параметры

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

Пример:

Read the Octagon MCP server guide.

octagon-docs-refresh

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

Параметры

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

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

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

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

octagon-agent

Координирует анализ рыночной информации о публичных и частных рынках.

Параметры

  • prompt (string, обязательный): исследовательский запрос на естественном языке.
  • conversation (string, необязательный): существующий идентификатор беседы Octagon для продолжения предыдущей ветки octagon-agent. Не указывайте его при первом обращении.
  • newConversation (boolean, необязательный): если 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 в четвертом квартале 2023 года?»
  • «Проанализируй тенденции расходов Tesla на исследования и разработки за последние 3 года».
  • «Какие прогнозы относительно спроса на чипы для ИИ дал генеральный директор NVIDIA в последнем звонке с инвесторами?»
  • «Сравни коэффициенты цена/прибыль, цена/продажи и EV/EBITDA для 5 крупнейших полупроводниковых компаний».
  • «Каковы размер последнего раунда финансирования Anthropic, оценка компании и ключевые инвесторы?»
  • «Сколько инвестиций Andreessen Horowitz сделала в стартапы в сфере ИИ за последние 12 месяцев?»
  • «Какие последние новости об акциях NVIDIA вышли за прошедшую неделю?»

octagon-deep-research-agent

Проводит всестороннее углубленное исследование и синтезирует данные из нескольких источников.

Параметры

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

Пример:

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-podcasts-agent

Отвечает на вопросы о том, что говорили инвесторы, стратеги, операторы и гости финансовых и деловых подкастов. Каждое утверждение сопровождается ссылкой на выпуск (шоу, название, дата, ссылка), а ответ завершается списком Sources:. Звонки с инвесторами — это не подкасты: для них используйте octagon-agent.

Параметры

  • prompt (string, обязательный): вопрос на естественном языке. Укажите в вопросе временной интервал, шоу, ведущего, гостя, компанию или тикер; отдельных параметров фильтрации нет.

Пример:

What are podcast guests saying about NVDA since August?

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

  • «Что Chamath недавно говорил о капитальных затратах на ИИ в All-In?»
  • «Кратко перескажи последние 3 выпуска Odd Lots».
  • «Какие компании чаще всего обсуждали в подкастах на прошлой неделе?»
  • «Как изменилось отношение к снижению ставок ФРС в подкастах с сентября?»

octagon-prediction-markets-agent

Исследовательские отчёты о рынках прогнозов Kalshi и Polymarket, а также поиск рынков и отбор перспективных возможностей на обеих площадках.

Параметры

  • prompt (string, обязательный): URL рынка Kalshi или тикер события, URL события Polymarket или его slug либо вопрос на естественном языке (какие рынки существуют или открыты по теме, где модель не согласна с ценой).
  • cache (boolean, необязательный): режим отчёта для одного рынка.
    • не указан: octagon-prediction-markets-agent, кэшированный отчёт, если он есть, иначе создаёт новый.
    • false: octagon-prediction-markets-agent:refresh, принудительно создаёт новый отчёт (3 кредита; тарифные планы Plus, Pro и Enterprise).
    • true: octagon-prediction-markets-agent:cache, только читает кэшированный отчёт; никогда не создаёт новый; бесплатно. Если в вопросе не указан рынок, возвращает структурированный список совпадающих рынков в формате JSON (kind: "discovery").

Ошибки API (отсутствующая или неразрешённая ссылка на рынок, неоднозначный тикер, закрытый рынок, ограничение тарифного плана или кредитов) возвращаются как Error [<code>]: <message>.

Примеры:

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100
Which Kalshi NBA game-winner markets are open tonight?   (cache: true)

prediction_markets_history

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

Параметры

  • event_ticker (string, обязательный)
  • limit (number, необязательный)
  • cursor (string, необязательный)
  • captured_from (string, необязательный)
  • captured_to (string, необязательный)
  • include_analysis (boolean, необязательный; если 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 — комплексные возможности для исследований и веб-скрейпинга

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