BeliefState

Добавьте в свой ИИ инвестиционные тезисы, риски, катализаторы и изменения в исследованиях с указанием источников — через размещённый MCP-сервер.

Исследования с подтверждениями: изучайте инвестиционные кейсы с указанием авторов, ссылками на источники, датами и явными пробелами в покрытии.
Сравнение взглядов: сопоставляйте различные тезисы, риски, условия и результаты, основанные на публикациях.
Отслеживание изменений: получайте датированные версии кейсов, оценки движка и журналы исследований, в которых используются отдельные временные шкалы.

Подключение, аутентификация и оплата

Обе конечные точки для исследований используют Streamable HTTP. Локальный сервер или SDK BeliefState не требуются.

Подключение	Удалённая конечная точка	Аутентификация и оплата
MCP для аккаунта	`https://beliefstate.ai/mcp`	OAuth для допущенных клиентов или `Authorization: Bearer` с вашим API-ключом BeliefState. Исследования оплачиваются из доступного лимита аккаунта или предоплаченных кредитов.
MCP для кошелька	`https://beliefstate.ai/v1/research/mcp`	Клиент с поддержкой x402 оплачивает запросы в USDC в сети Base (`eip155:8453`). Аккаунт BeliefState, API-ключ или подписка не требуются.

Доступ к аккаунту с оплатой по факту использования стоит $20 за 500 бессрочных кредитов ($0.04 за успешно выполненный исследовательский запрос). Один вопрос ИИ может потребовать нескольких запросов. Условия для лимитов подписки и уже предоставленных кредитов отличаются; проверьте текущие цены для аккаунтов. Подключение клиента или создание ключа не добавляет исследовательские кредиты.

Оплата через кошелёк рассчитывается отдельно: четырнадцать инструментов для работы с данными стоят по 0.02 USDC, вызов compare_beliefs стоит 0.50 USDC, а вызов search_beliefs — 1.50 USDC. Перед подтверждением оплаты проверьте актуальный каталог и точные расценки. Для конечной точки кошелька необходима поддержка оплаты: обычный OAuth-клиент не может оплачивать выставленные счета.

Инструменты get_tickers и search_companies бесплатны для обеих конечных точек. Инструмент get_tracked_tickers, доступный только для аккаунта, также бесплатен. Доступность OAuth в браузере зависит от того, допущен ли клиент; прежде чем оплачивать запросы, проверьте страницу Подключение ИИ. Приведённая ниже настройка API-ключа позволяет подключить новый клиент без предположения, что ему доступен OAuth.

VS Code / GitHub Copilot · Инструменты · Рабочий процесс исследований · Другие интеграции · Поддержка · Лицензия

VS Code / GitHub Copilot

Используйте актуальную версию VS Code с включёнными функциями ИИ и сессию агента Copilot. В этом варианте применяется текущий переносимый формат конфигурации Copilot и API-ключ BeliefState; локальная среда выполнения MCP не нужна.

Войдите в настройки аккаунта BeliefState и получите ключ API разработчика для нужного аккаунта.
С помощью закрытого менеджера секретов задайте BELIEFSTATE_API_KEY в окружении хоста, на котором запущен агент. Для удалённого рабочего пространства или контейнера задайте переменную в соответствующей среде. Запустите VS Code из этого окружения: если задать переменную в другой терминальной сессии после запуска VS Code, этого будет недостаточно.
Объедините эту конфигурацию с личным файлом ~/.copilot/mcp-config.json (или с файлом mcp-config.json в COPILOT_HOME, если эта переменная задана). Сохраните существующие записи серверов.

{
  "mcpServers": {
    "beliefstate": {
      "type": "http",
      "url": "https://beliefstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${BELIEFSTATE_API_KEY}"
      }
    }
  }
}

Запустите новую сессию агента Copilot. Откройте Chat: Open Customizations > MCP Servers, чтобы проверить beliefstate, и подтвердите доверие к серверу, если появится соответствующий запрос. При необходимости включите его инструменты в разделе Chat: Open Customizations > Tools.
Спросите: «Какие компании охватывает BeliefState?» Разверните результат работы инструмента и убедитесь, что бесплатный вызов get_tickers вернул данные о покрытии. Затем задайте обычный исследовательский вопрос, например: «Каков инвестиционный кейс Nebius?», если хотите использовать исследовательские кредиты.

Бесплатный запрос о покрытии позволяет проверить обнаружение сервера и аутентификацию. Ответ на исследовательский вопрос с цитатами дополнительно подтверждает доступ к исследованиям и наличие доступного лимита. Сохранённая конфигурация или правдоподобный ответ сами по себе не доказывают, что инструмент был запущен.

Эти шаги основаны на актуальном руководстве по настройке VS Code и справочнике по конфигурации MCP. Старый формат VS Code с servers и ${input:...} отличается: интерактивные значения не передаются сессиям Copilot harness. Никогда не указывайте настоящий ключ в общей конфигурации, системе контроля версий или чате. 29 октября 2026 года стандартный клиент MCP прошёл аутентификацию на конечной точке аккаунта с помощью Bearer-ключа, получил список всех 19 инструментов и выполнил бесплатный вызов get_tickers. Инструкции для VS Code соответствуют актуальному справочнику по конфигурации; штатный жизненный цикл редактора отдельно не проверялся.

Инструменты MCP

Конечная точка аккаунта предоставляет 19 инструментов. Конечная точка кошелька предоставляет тот же набор, кроме get_tracked_tickers: 16 платных инструментов для исследований и два бесплатных инструмента для поиска данных. В актуальных карточках серверов указаны действующие названия и описания инструментов.

Инструмент	Назначение
`get_brief`	Получить обзор компании или ETF либо ограниченное описание текущего тезиса с цитатами и указанием пробелов в данных.
`get_beliefs`	Получить список датированных инвестиционных кейсов с фильтрацией по компании, теме, инвестору, направлению или периоду.
`get_belief`	Прочитать полный инвестиционный кейс и разрешённые подтверждающие материалы.
`search_beliefs`	Найти инвестиционные идеи по тезису, теме или торговому сценарию с цитатами из соответствующих фрагментов.
`compare_beliefs`	Сопоставить два кейса с цитатами, выявить подтверждения, противоречия или зависимости.
`get_belief_risks`	Получить структурированные риски со ссылками на источники и указанием того, оценены они или их статус неизвестен.
`get_belief_catalysts`	Получить катализаторы со ссылками на источники и оговорками относительно статуса условий.
`get_author_track_record`	Получить сохранённые результаты, основанные на публикациях, в том числе убытки, ожидающие исхода кейсы и пробелы в покрытии.
`search_entities`	Найти опубликованные данные о компаниях, отраслях, темах и других предметах исследований.
`get_belief_changes`	Получить упорядоченный журнал изменений, распределения и рассчитанных результатов с сохранением домена и дат каждого события.
`get_context_assessment`	Получить датированную оценку движка и подтверждающие её данные отдельно от заявленной позиции инвестора.
`list_research_visuals`	Получить список графиков и таблиц с цитатами для кейса или оценки.
`get_research_visual`	Прочитать график или таблицу, включая точные строки или значения данных.
`get_belief_relationships`	Изучить пути взаимосвязей с цитатами в рамках инвестиционного кейса.
`evaluate_belief_scenario`	Применить гипотетические условия к сохранённой модели кейса, не изменяя подтверждающие её данные.
`refresh_market_data`	Явно обновить отсутствующий или устаревший рыночный контекст, а затем получить краткий обзор; эта исследовательская операция платная.
`get_tickers`	Получить список компаний, по которым доступны исследования, и количество материалов. Бесплатно.
`search_companies`	Выполнить поиск в справочнике компаний SEC и проверить доступность исследований. Бесплатно.
`get_tracked_tickers`	Получить список отслеживаемых компаний подключённого аккаунта. Бесплатно; доступно только для конечной точки аккаунта.

Учитывайте даты источников, цитаты и предупреждения о пробелах в покрытии, указанные в полученных данных. Результаты, основанные на публикациях, не подтверждают исполнение сделок через брокера; отсутствие данных о покрытии означает, что информация неизвестна.

Выполните обновление исследования компании

Требуется Node.js версии 22 или выше. Устанавливать зависимости не нужно.

Получите примеры и перейдите в каталог проекта:

git clone https://github.com/Antcolombo/beliefstate-agent-integrations.git
cd beliefstate-agent-integrations

Изучите датированный пример общедоступного исследования — для этого не нужны учетные данные и сетевые запросы:

npm run demo

В датированном примере приведены результаты проверенного запуска NBIS от 27 октября 2026 года: один актуальный кейс со ссылкой на источник, семь событий журнала и намеренная остановка после двух чтений. Ожидающее продолжение хранится отдельно от завершенной контрольной точки опроса. Охват, пропущенные кейсы, неоцененные поля и области событий указаны явно. В примере не приводятся идентификатор аккаунта, учетные данные и непрозрачные токены. Это краткая сводка результатов, а не полный ответ API и не актуальная рекомендация.

Спланируйте рабочий процесс с актуальными данными, не выполняя запросов:

node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z

Используйте компанию и дату отсечения из своего исследовательского вопроса. Рабочий процесс сначала проверяет доступное покрытие, затем получает компактный актуальный снимок максимум с тремя кейсами и запрашивает упорядоченный журнал изменений в исследовании, замеченных с указанной даты отсечения.

В результат включены атрибутированные свидетельства, ссылки на источники, области событий, временные метки, пробелы в данных, охват истории, пропуски и предупреждения. Событие журнала может отражать оценку движка, изменение распределения или рассчитанный исход. Прежде чем описывать его как пересмотр авторской позиции, проверьте область события.

Для доступа к аккаунту с актуальными данными загрузите существующий ключ BELIEFSTATE_API_KEY из своего хранилища секретов. Создание ключа или подключение OAuth не добавляет кредитов на исследования. Перед выполнением проверьте текущие тарифы аккаунта и доступный лимит:

mkdir -m 700 .private
node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z \
  --execute --max-reads 2 --state .private/nbis-first.json > .private/nbis-first-output.json

Перед перенаправлением вывода в каталог .private создайте его командой mkdir -m 700 .private.

Если вывод не перенаправляется, скрипт также создает каталоги для приватного состояния. Храните полученные исследовательские данные, состояние и контрольные точки в закрытом доступе. Ключ не сохраняется и не выводится на экран. Используйте --test для диагностики владельца; при обычной работе клиента этот параметр указывать не следует.

Параметр --max-reads ограничивает общее число исследовательских запросов к аккаунту в соответствующем файле состояния, включая запрос с неопределенным результатом отправки. По тарифу аккаунта с оплатой по факту использования, действовавшему 27 октября, два чтения расходуют $0.08 кредита. Лимиты тарифных планов и ранее установленные условия могут отличаться. Это ограничение числа чтений, а не разрешение на расходование определенной суммы. Для чтения данных через кошелек x402 действует отдельная цена — 0.02 USDC. Этот скрипт использует REST API аккаунта и не подписывает платежи кошельком; работу с кошельком описывает существующая краткая инструкция по x402.

Если в журнале есть следующая страница, скрипт сохраняет данные для продолжения и останавливается, достигнув лимита чтений. Возобновите работу, повторив ту же команду с тем же файлом состояния и явно указав больший лимит — не более 20. Завершенные результаты повторно используются локально. Для ограниченного актуального снимка автоматическая загрузка дополнительных страниц не выполняется; поля продолжения и пропусков остаются в результате.

После завершения обработки окна журнала начните следующий опрос с новым файлом состояния:

node examples/research-changes.mjs --ticker NBIS --previous-state .private/nbis-first.json \
  --execute --max-reads 2 --state .private/nbis-next.json

Старая контрольная точка останется без изменений, пока новое окно не будет обработано полностью.

Состояния resync_required, projection_catching_up и history_uninitialized требуют внимания: они не означают, что изменений нет. Пример не создает новый запрос для восстановления после неопределенной отправки: идентификаторы запросов аккаунта предотвращают повторное списание, но тела завершенных ответов не сохраняются для повторного воспроизведения. Сохраните файл состояния и попросите службу поддержки сверить его идентификатор запроса, прежде чем повторять попытку. Если после сбоя остался файл .lock, перед удалением убедитесь, что прежний процесс остановлен.

Запустите автономные проверки безопасности командой npm test.

Другие интеграции

Ресурс	Назначение
Документация по настройке и использованию MCP	Инструкции по подключению к аккаунту через OAuth/ключ API и подключению кошелька.
Опубликованный коннектор Claude	Подключение через поддерживаемый каталог Claude.
Навык для исследования	Рекомендации по поиску информации об акциях и инвестиционных темах.
Коллекция Postman	Бесплатный поиск данных и запросы неподписанных котировок x402.
gemini-extension.json	Необязательный пример конфигурации Gemini CLI; штатная аутентификация и получение результатов исследований не проверены.
Спецификация OpenAPI	Актуальные схемы REST API.

Gemini приведен как необязательный пример конфигурации, а не как проверенный способ быстрого запуска. Перед аутентификацией или оплатой проверьте актуальную доступность клиентов. Навык для исследования содержит инструкции; доступ к размещенному сервису необходимо настраивать отдельно. Коллекция Postman не содержит учетных данных или средства подписи платежей.

Изучайте доступное покрытие и схемы без аккаунта или кошелька:

curl --fail-with-body https://beliefstate.ai/v1/research
curl --fail-with-body 'https://beliefstate.ai/v1/tickers?q=NBIS'
curl --fail-with-body https://beliefstate.ai/v1/research/get_belief

Поддержка

Сообщайте о проблемах интеграции в этом репозитории. По вопросам аккаунта, сервиса или конфиденциального сообщения об уязвимости обращайтесь по адресу support@beliefstate.ai. Инструкции по использованию приведены в руководстве по настройке MCP, информация о сервисе — на сайте beliefstate.ai.

Лицензия

Лицензия MIT распространяется на конфигурацию Gemini, контекст и коллекцию Postman.

Лицензия MIT также распространяется на код рабочего процесса. На исследовательские примеры распространяются условия использования данных сервиса, включая указанные сведения об их происхождении и ограничениях.

Для навыка исследования используется лицензия MIT-0, указанная в его frontmatter. На доступ к размещенным исследованиям и данным распространяются условия использования BeliefState.