@pipeworx/bis

BIS (Bank for International Settlements) MCP — статистика по центральным банкам и глобальным финансам через API BIS SDMX v2. Без аутентификации.

Часть Pipeworx — MCP-шлюз, соединяющий ИИ-агентов с 1476+ активными источниками данных.

Инструменты

• bis_credit_gap(country, start_period?, end_period?, limit?) — отношение кредита к ВВП, его долгосрочный тренд по HP-фильтру и разрыв между ними, по кварталам, для одной страны. Разрыв является эталонным индикатором Basel III для контрциклического буфера капитала. Принимает название страны или код ISO alpha-2; 44 экономики плюс агрегат по еврозоне (XM).

• list_curated_flows(topic?) — предварительно проверенные ссылки на потоки данных по темам (ставки, fx, банковское дело, долг, кредит, недвижимость, деривативы, цены).

• search_dataflows(query, limit?) — поиск по ключевым словам по всему реестру потоков данных BIS; возвращает ссылки flow_ref, готовые для fetch_dataset.

• fetch_dataset(flow_ref, key?, start_period?, end_period?, limit?) — строки в tidy-формате из любого потока данных BIS.

Related MCP server: mcp-ecb

Аутентификация

Не требуется. BIS публикует эту статистику в открытом доступе и не требует ни ключа, ни квоты.

Примечания об API источника

• flow_ref содержит версию, и эта версия не всегда 1.0. BIS меняет версии потоков данных на месте (WS_TC — 2.0), и устаревшая версия возвращает пустой результат, а не ошибку. Берите ссылки из list_curated_flows или search_dataflows, а не предполагайте её.

• Ключи позиционны относительно собственных измерений потока и разделяются точками — например, Q.US... для WS_CREDIT_GAP, чей ключ — FREQ.BORROWERS_CTY.TC_BORROWERS.TC_LENDERS.CG_DTYPE. Оставьте позицию пустой, чтобы не фильтровать по ней. Если ключ не соответствует ничему, fetch_dataset сообщает вам фактические измерения потока.

• Строки содержат и код, и его значение. Каждая закодированная колонка сопровождается колонкой <COLUMN>_label (CG_DTYPE: "C" / CG_DTYPE_label: "Credit-to-GDP gaps (actual-trend)"), потому что закодированные значения BIS сами по себе непрозрачны.

• Потоки данных по банкам и долговым ценным бумагам имеют размер в несколько мегабайт и не ограничены — передавайте start_period / end_period.

Источники данных

• API: https://stats.bis.org/api/v2/

• Документация API: https://stats.bis.org/api-doc/v2/

• Обзор: https://stats.bis.org

• Разрывы «кредит к ВВП»: https://www.bis.org/statistics/c_gaps.htm

Быстрый старт

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т. д.):

{
  "mcpServers": {
    "bis": {
      "url": "https://gateway.pipeworx.io/bis/mcp"
    }
  }
}

Что на самом деле предоставляет этот эндпоинт

tools/list по адресу https://gateway.pipeworx.io/bis/mcp возвращает инструменты из списка выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор, общий для всего шлюза. Поэтому количество инструментов, которое вы видите, больше, чем в этом списке: эндпоинт одного пакета в настоящее время перечисляет около 30 общих инструментов наряду с инструментами самого пакета. Ответ initialize соединения указывает его точную область действия и является авторитетным ответом на конкретный день.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты позволяют ограниченному соединению отвечать на вопросы, которые этот пакет не покрывает, — через ask_pipeworx, который маршрутизирует запрос по всему каталогу, — без добавления второго MCP-сервера. Сейчас невозможно подключить эндпоинт пакета без них; если дополнительные схемы отнимают больше контекста, чем стоит маршрутизация, лучше один раз подключиться к полному шлюзу, а не к нескольким эндпоинтам пакетов.

Или подключитесь к полному шлюзу Pipeworx, чтобы инструменты всех пакетов были перечислены напрямую, а не только этого одного:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Оба URL-адреса ведут к одному и тому же шлюзу и к тем же 1476+ источникам данных. Единственная разница в том, инструменты какого пакета перечислены напрямую; ask_pipeworx из любого из них достигает всех.

Использование с ask_pipeworx

Вместо прямых вызовов инструментов вы можете задавать вопросы на простом английском — это работает как на эндпоинте пакета выше, так и на полном шлюзе:

ask_pipeworx({ question: "your question about Bis data" })

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

Подробнее

• Документация и руководства

• pipeworx.io

Лицензия

MIT