MCP: сценарии, документация и спецификации API Райффайзен Банка

RaifMCP 0.0.3

# Документация API Портала для ИИ-ассистентов Сервис предоставляет ИИ-ассистентам доступ к материалам, опубликованным на [developer.raif.ru](https://developer.raif.ru/): документации на русском и английском языках, каталогу бизнес-сценариев, публичных API, их операциям и актуальным версиям спецификаций. Сервис работает по протоколу MCP (Model Context Protocol). MCP позволяет подключать внешние источники данных к ИИ-ассистентам: ассистент вызывает доступные инструменты, получает нужный документ или спецификацию и использует их для ответа на вопрос, анализа API или подготовки интеграции. Обычно работа строится так: 1. Получить список бизнес-сценариев, документов или публичных API. 2. Выбрать сценарий, документ, API либо его вариант по содержимому или идентификатору. 3. Получить компактный список операций API и при необходимости отфильтровать его по варианту. 4. Загрузить полное содержимое документа или спецификации, когда требуется полный контракт. Для этих задач сервер предоставляет семь инструментов. ## Инструменты ### `list_public_scenarios` Возвращает полный актуальный каталог бизнес-сценариев в том же порядке, что и на публичном Портале, со всеми полями публичного представления, включая описание для бизнеса и разработчика. Возвращаются только сценарии на языке, заданном необязательным параметром `language` (`ru` по умолчанию или `en`), в том числе помеченные `isDraft`. Если получить весь каталог не удалось, инструмент возвращает ошибку вместо неполного списка. **Когда использовать:** - Нужно узнать, какие задачи бизнеса можно решить с помощью API Банка - Нужно выбрать подходящий сценарий и изучить его шаги и связанные API - Нужно получить актуальный список сценариев на русском или английском языке --- ### `list_public_documentation` Возвращает упорядоченный список доступных документов с метаданными. Необязательный параметр `language` ограничивает результат документами на русском (`ru`) или английском (`en`) языке. **Когда использовать:** - Нужно узнать, какие инструкции и справочные материалы доступны - Нужно получить `documentId` перед вызовом `get_public_documentation` - Нужно отфильтровать документацию по языку --- ### `get_public_documentation` Возвращает метаданные и полное исходное содержимое документа по его `documentId`. **Когда использовать:** - `documentId` уже получен через `list_public_documentation` - Нужен полный текст инструкции, справочного материала или связанного файла --- ### `list_public_apis` Возвращает полный актуальный каталог публичных API со всех страниц API Router. **Когда использовать:** - Нужно узнать, какие публичные API доступны - Нужно получить `apiId` перед поиском вариантов, операций или загрузкой спецификации --- ### `list_public_api_variants` Возвращает актуальные варианты публичного API по его `apiId`. **Когда использовать:** - `apiId` уже получен через `list_public_apis` - Нужно получить `variantCode` перед фильтрацией операций или загрузкой спецификации --- ### `list_public_api_operations` Возвращает полный список операций публичного API по обязательному `apiId`. Необязательный `variantCode` ограничивает результат выбранным вариантом. **Когда использовать:** - `apiId` уже получен через `list_public_apis` - Нужно быстро узнать доступные операции без загрузки полной спецификации - Нужно найти operationId, метод и путь либо отфильтровать операции по `variantCode` --- ### `get_public_api_specification` Возвращает полное актуальное содержимое спецификации выбранного варианта публичного API в исходном формате YAML или JSON. **Когда использовать:** - `apiId` и `variantCode` получены через инструменты каталога - Нужен полный контракт API для анализа, генерации клиента или интеграции

Скачать исходную спецификацию

Варианты

  • Паблик

Исходный контракт

---
raifmcp: "1.1.0"
info:
  title: "MCP: сценарии, документация и спецификации API Райффайзен Банка"
  version: "0.0.3"
  summary: "Бизнес-сценарии, документация и спецификации API с developer.raif.ru д\
    ля ИИ-ассистентов"
  description: "# Документация API Портала для ИИ-ассистентов\n\nСервис предоставл\
    яет ИИ-ассистентам доступ к материалам, опубликованным на\n[developer.raif.ru](https://developer.raif.ru/):\
    \ документации на русском и английском\nязыках, каталогу бизнес-сценариев, пуб\
    личных API, их операциям и актуальным\nверсиям спецификаций.\n\nСервис работае\
    т по протоколу MCP (Model Context Protocol). MCP позволяет подключать\nвнешние\
    \ источники данных к ИИ-ассистентам: ассистент вызывает доступные инструменты\
    ,\nполучает нужный документ или спецификацию и использует их для ответа на воп\
    рос,\nанализа API или подготовки интеграции.\n\nОбычно работа строится так:\n\n\
    1. Получить список бизнес-сценариев, документов или публичных API.\n2. Выбрать\
    \ сценарий, документ, API либо его вариант по содержимому или идентификатору.\n\
    3. Получить компактный список операций API и при необходимости отфильтровать е\
    го по варианту.\n4. Загрузить полное содержимое документа или спецификации, ко\
    гда требуется полный контракт.\n\nДля этих задач сервер предоставляет семь инс\
    трументов.\n\n## Инструменты\n\n### `list_public_scenarios`\n\nВозвращает полн\
    ый актуальный каталог бизнес-сценариев в том же порядке, что и на публичном По\
    ртале,\nсо всеми полями публичного представления, включая описание для бизнеса\
    \ и разработчика.\nВозвращаются только сценарии на языке, заданном необязатель\
    ным параметром `language`\n(`ru` по умолчанию или `en`), в том числе помеченны\
    е `isDraft`.\nЕсли получить весь каталог не удалось, инструмент возвращает оши\
    бку вместо неполного списка.\n\n**Когда использовать:**\n- Нужно узнать, какие\
    \ задачи бизнеса можно решить с помощью API Банка\n- Нужно выбрать подходящий\
    \ сценарий и изучить его шаги и связанные API\n- Нужно получить актуальный спи\
    сок сценариев на русском или английском языке\n\n---\n\n### `list_public_documentation`\n\
    \nВозвращает упорядоченный список доступных документов с метаданными. Необязат\
    ельный параметр\n`language` ограничивает результат документами на русском (`ru`)\
    \ или английском (`en`) языке.\n\n**Когда использовать:**\n- Нужно узнать, как\
    ие инструкции и справочные материалы доступны\n- Нужно получить `documentId` п\
    еред вызовом `get_public_documentation`\n- Нужно отфильтровать документацию по\
    \ языку\n\n---\n\n### `get_public_documentation`\n\nВозвращает метаданные и по\
    лное исходное содержимое документа по его `documentId`.\n\n**Когда использоват\
    ь:**\n- `documentId` уже получен через `list_public_documentation`\n- Нужен по\
    лный текст инструкции, справочного материала или связанного файла\n\n---\n\n###\
    \ `list_public_apis`\n\nВозвращает полный актуальный каталог публичных API со\
    \ всех страниц API Router.\n\n**Когда использовать:**\n- Нужно узнать, какие п\
    убличные API доступны\n- Нужно получить `apiId` перед поиском вариантов, опера\
    ций или загрузкой спецификации\n\n---\n\n### `list_public_api_variants`\n\nВоз\
    вращает актуальные варианты публичного API по его `apiId`.\n\n**Когда использо\
    вать:**\n- `apiId` уже получен через `list_public_apis`\n- Нужно получить `variantCode`\
    \ перед фильтрацией операций или загрузкой спецификации\n\n---\n\n### `list_public_api_operations`\n\
    \nВозвращает полный список операций публичного API по обязательному `apiId`. Н\
    еобязательный\n`variantCode` ограничивает результат выбранным вариантом.\n\n**К\
    огда использовать:**\n- `apiId` уже получен через `list_public_apis`\n- Нужно\
    \ быстро узнать доступные операции без загрузки полной спецификации\n- Нужно н\
    айти operationId, метод и путь либо отфильтровать операции по `variantCode`\n\n\
    ---\n\n### `get_public_api_specification`\n\nВозвращает полное актуальное соде\
    ржимое спецификации выбранного варианта публичного API\nв исходном формате YAML\
    \ или JSON.\n\n**Когда использовать:**\n- `apiId` и `variantCode` получены чер\
    ез инструменты каталога\n- Нужен полный контракт API для анализа, генерации кл\
    иента или интеграции\n"
  contact: {}
servers:
- type: "streamable-http"
  url: "https://api.raiffeisen.ru/developer-portal/public/mcp"
  name: "prod"
  description: "Продуктивный MCP-сервер публичной документации и спецификаций API\
    \ Портала"