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 для аналитики публичных рынков и рынков прогнозов
Сервер 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-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, необходимо:
- Зарегистрировать бесплатную учетную запись на сайте Octagon
- После входа в систему открыть в меню слева раздел API Keys
- Создать новый ключ API
- Использовать этот ключ API в конфигурации в качестве значения
OCTAGON_API_KEY
Предварительные требования
Перед установкой или запуском Octagon MCP необходимо установить в системе npx (поставляется вместе с Node.js и npm).
Mac (macOS)
-
Установите Homebrew (если он еще не установлен):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
Установите Node.js (включает npm и npx):
brew install nodeБудут установлены последние версии Node.js, npm и npx.
-
Проверьте установку:
node -v npm -v npx -v
Windows
- Скачайте установщик Node.js:
- Перейдите на https://nodejs.org/ и скачайте версию LTS для Windows.
- Запустите установщик и следуйте инструкциям. Будут установлены Node.js, npm и npx.
- Проверьте установку:
Откройте командную строку и выполните:
node -v npm -v npx -v
Если для всех трех компонентов отображаются номера версий, можно переходить к описанным ниже шагам установки.
Установка
Запуск в Claude Desktop
Чтобы настроить Octagon MCP для Claude Desktop:
- Откройте Claude Desktop
- Перейдите в Settings > Developer > Edit Config
- Добавьте следующий фрагмент в файл
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"
}
}
}
}
- Перезапустите Claude, чтобы изменения вступили в силу
Запуск в Cursor
Настройка Cursor Desktop 🖥️
Примечание: требуется Cursor версии 0.45.6 или новее
Чтобы настроить Octagon MCP в Cursor:
- Откройте настройки Cursor
- Перейдите в Features > MCP Servers
- Нажмите «+ Add New MCP Server»
- Введите следующие данные:
- 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 еще не настроен, поэтому полезны для настройки, устранения неполадок и поиска подходящего агента 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 определяет состояние сеанса/ветки в следующем порядке:
- сохраненная беседа для идентификатора сеанса транспорта MCP, если транспорт действительно его предоставляет
- сохраненная беседа для управляемого сервером сеанса
stdioпо умолчанию - явный
conversationпо-прежнему может переопределить активную беседу сеанса для этого вызова
В настоящее время этот пакет работает как MCP-сервер stdio. В режиме stdio сервер автоматически создает локальный для процесса сеанс, обеспечивающий непрерывность между вызовами. Поэтому большинство локальных хостов, таких как Claude Desktop или Cursor, могут использовать octagon-agent без дополнительных полей для работы с ветками при обычном продолжении беседы.
Если хост верхнего уровня знает, что вызов является первым обращением в новом видимом чате, ему следует передать newConversation: true. Это явно очищает сохраненную ветку Octagon для активного якоря сеанса MCP перед вызовом и предотвращает продолжение устаревшей беседы, когда хост stdio повторно использует один и тот же долгоживущий процесс MCP для нескольких видимых чатов.
Это означает, что можно использовать любой из следующих вариантов:
- Первый вызов: передайте только
prompt - Позвольте хосту MCP сохранять непрерывность сеанса транспорта или используйте сеанс stdio по умолчанию
- Второй вызов:
- передайте новый
promptв том же сеансе MCP, или - продолжайте использовать тот же процесс MCP stdio, или
- явно передайте предыдущий
conversation
- передайте новый
Идентификатор сеанса транспорта — основной механизм обеспечения непрерывности для соответствующих стандартам MCP-транспортов с сохранением состояния. При локальном использовании stdio непрерывность по умолчанию обеспечивает управляемый сервером сеанс процесса.
Идентификатор сеанса и идентификатор беседы Octagon — разные понятия:
- Идентификатор сеанса MCP управляет непрерывностью на стороне сервера между вызовами инструментов
conversationOctagon управляет активной веткой 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
Устранение неполадок
- Проблемы с API-ключом: убедитесь, что API-ключ Octagon правильно задан в окружении или файле конфигурации.
- Проблемы с подключением: убедитесь, что подключение к API Octagon работает корректно.
- Ограничение частоты запросов: если возникают ошибки ограничения частоты запросов, уменьшите частоту запросов.
Лицензия
MIT
Специализированные MCP-серверы
Этот сервер предоставляет комплексную аналитику рынков, объединяющую возможности всех наших специализированных агентов. Для отдельных сценариев использования также можно воспользоваться нашими специализированными MCP-серверами:
Инструменты для исследований
- Octagon Deep Research MCP — комплексные возможности для исследований и веб-скрейпинга
⭐ Поставьте звезду этому репозиторию, если он оказался полезен!
