Справочник инструментов MCP-сервера
Инструменты — это операции: AI-агент выбирает подходящий инструмент, а AI-платформа или AI-приложение выполняет его через MCP-сервер. В этом справочнике описаны инструменты MCP-сервера ЮKassa, их параметры запроса и ответа.
AI-платформа получает актуальный набор инструментов и параметров по протоколу MCP с помощью
tools/list, а для выполнения операции вызывает tools/call с именем нужного инструмента. Если инструмента нет в ответе на tools/list, операция недоступна через MCP-сервер. Подробнее о протоколе MCPДля операций через MCP-сервер набор параметров запроса и ответа ограничен и отличается от соответствующей операции по API ЮKassa.
Инструменты для работы с платежами
Для работы с платежами доступны следующие инструменты:
- create_payment — создание платежа
- get_payment — получение информации о платеже
- get_payments_list — получение списка платежей
create_payment — создание платежа
Создает одностадийный платеж по сценарию интеграции Умный платеж и возвращает данные для перехода пользователя на страницу оплаты.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| amount | object | Обязательный | Сумма платежа. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. Например 1000.00. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217, например RUB. |
| description | string | Необязательный | Описание транзакции, которое отображается в личном кабинете и на странице оплаты. Не более 128 символов. |
| gateway_id | string | Условно обязательный | Идентификатор субаккаунта для разделения потоков платежей. Нужен, если магазин разделяет поток платежей по нескольким субаккаунтам. Можно передать в запросе или в заголовке Mcp-Param-Gateway-Id. Рекомендуется использовать заголовок. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор платежа. |
| status | string | Обязательный | Статус платежа. |
| amount | object | Обязательный | Сумма платежа. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| confirmation_url | string | Необязательный | Ссылка для подтверждения платежа. Возвращается, если платеж ожидает подтверждения пользователем. |
| description | string | Необязательный | Описание транзакции, указанное при создании платежа. Возвращается, если описание было указано при создании платежа. |
| payment_method | string | Необязательный | Код способа оплаты. Перечень возможных значений. |
| created_at | string | Необязательный | Время создания платежа. |
get_payment — получение информации о платеже
Получает информацию о платеже по его идентификатору.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор платежа. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор платежа. |
| status | string | Обязательный | Статус платежа. |
| amount | object | Обязательный | Сумма платежа. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| confirmation_url | string | Необязательный | Ссылка для подтверждения платежа. Возвращается, если платеж ожидает подтверждения пользователем. |
| description | string | Необязательный | Описание транзакции, указанное при создании платежа. Возвращается, если описание было указано при создании платежа. |
| payment_method | string | Необязательный | Код способа оплаты. Перечень возможных значений. |
| created_at | string | Необязательный | Время создания платежа. |
get_payments_list — получение списка платежей
Получает список платежей с учетом заданных фильтров.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| created_at_gte | string | Необязательный | Фильтр по времени создания платежей: начало периода. Дата и время в формате ISO 8601, например 2026-09-01T00:00:00.000Z. |
| created_at_lte | string | Необязательный | Фильтр по времени создания платежей: конец периода. Дата и время в формате ISO 8601, например 2026-09-01T23:59:59.000Z. |
| payment_method | string | Необязательный | Фильтр по коду способа оплаты. Перечень возможных значений. |
| status | string | Необязательный | Статус платежа. |
| limit | integer | Необязательный | Размер выдачи: от 1 до 100 объектов. По умолчанию — 10. |
| next_cursor | string | Условно обязательный | Указатель на следующий фрагмент списка. Передается, если в предыдущем ответе вернулся next_cursor и нужно получить следующий фрагмент списка. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| items | array | Обязательный | Список платежей. |
| items.id | string | Обязательный | Идентификатор платежа для каждого платежа в списке. |
| items.status | string | Обязательный | Статус платежа для каждого платежа в списке. |
| items.amount | object | Обязательный | Сумма платежа для каждого платежа в списке. |
| items.amount.value | string | Обязательный | Сумма в выбранной валюте для каждого платежа в списке. |
| items.amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217 для каждого платежа в списке. |
| items.confirmation_url | string | Необязательный | Ссылка для подтверждения платежа. Возвращается, если платеж ожидает подтверждения пользователем. |
| items.description | string | Необязательный | Описание транзакции. Возвращается, если описание было указано при создании платежа. |
| items.payment_method | string | Необязательный | Код способа оплаты. Перечень возможных значений. |
| items.created_at | string | Необязательный | Время создания платежа. |
| next_cursor | string | Необязательный | Указатель на следующий фрагмент списка. Возвращается, если в списке есть следующий фрагмент. |
Инструменты для работы с возвратами
Через MCP-сервер ЮKassa можно получать информацию о возвратах, но нельзя создавать возвраты. Сделать возврат можно только в личном кабинете ЮKassa или по API.
Для работы с возвратами доступны следующие инструменты:
get_refund — получение информации о возврате
Получает информацию о возврате по его идентификатору.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор возврата. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор возврата. |
| payment_id | string | Обязательный | Идентификатор платежа, для которого создан возврат. |
| status | string | Обязательный | Статус возврата. |
| amount | object | Обязательный | Сумма, возвращенная пользователю. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| created_at | string | Обязательный | Время создания возврата. |
| description | string | Необязательный | Основание для возврата денег пользователю. |
get_refunds_list — получение списка возвратов
Получает список возвратов с учетом заданных фильтров.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| created_at_gte | string | Необязательный | Фильтр по времени создания возвратов: начало периода. Дата и время в формате ISO 8601, например 2026-09-01T00:00:00.000Z. |
| created_at_lte | string | Необязательный | Фильтр по времени создания возвратов: конец периода. Дата и время в формате ISO 8601, например 2026-09-01T23:59:59.000Z. |
| payment_id | string | Необязательный | Идентификатор платежа, для которого нужно получить возвраты. |
| status | string | Необязательный | Статус возврата. |
| limit | integer | Необязательный | Размер выдачи: от 1 до 100 объектов. По умолчанию — 10. |
| next_cursor | string | Условно обязательный | Указатель на следующий фрагмент списка. Передается, если в предыдущем ответе вернулся next_cursor и нужно получить следующий фрагмент списка. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| items | array | Обязательный | Список возвратов. |
| items.id | string | Обязательный | Идентификатор возврата для каждого возврата в списке. |
| items.payment_id | string | Обязательный | Идентификатор платежа для каждого возврата в списке. |
| items.status | string | Обязательный | Статус возврата для каждого возврата в списке. |
| items.amount | object | Обязательный | Сумма, возвращенная пользователю, для каждого возврата в списке. |
| items.amount.value | string | Обязательный | Сумма в выбранной валюте для каждого возврата в списке. |
| items.amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217 для каждого возврата в списке. |
| items.created_at | string | Обязательный | Время создания возврата для каждого возврата в списке. |
| items.description | string | Необязательный | Основание для возврата денег пользователю. |
| next_cursor | string | Необязательный | Указатель на следующий фрагмент списка. Возвращается, если в списке есть следующий фрагмент. |
Инструменты для работы со счетами
Для работы со счетами доступны следующие инструменты:
create_invoice — создание счета
Создает счет и возвращает данные для перехода пользователя на страницу счета.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| amount | object | Обязательный | Сумма платежа по счету. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| expires_at | string | Обязательный | Срок действия счета: дата и время, до которых можно оплатить счет. Дата и время в формате ISO 8601 по UTC, например 2026-09-30T10:00:00.000Z. Счет может действовать максимум 30 дней. |
| cart | array | Обязательный | Состав корзины: товары или услуги, за которые выставляется счет. |
| cart.description | string | Обязательный | Название товара или услуги. От 1 до 128 символов. |
| cart.price | object | Обязательный | Полная цена товара или услуги. |
| cart.price.value | string | Обязательный | Сумма в выбранной валюте. |
| cart.price.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| cart.discount_price | object | Необязательный | Итоговая цена товара с учетом скидки. Нужно передавать, если необходимо показать цену с учетом скидки. |
| cart.discount_price.value | string | Условно обязательный | Сумма в выбранной валюте. Нужна, если передан cart.discount_price. |
| cart.discount_price.currency | string | Условно обязательный | Трехбуквенный код валюты в формате ISO-4217. Нужен, если передан cart.discount_price. |
| cart.quantity | number | Обязательный | Количество товара. |
| description | string | Необязательный | Описание счета, которое отображается в личном кабинете и на странице счета. Не более 128 символов. |
| gateway_id | string | Условно обязательный | Идентификатор субаккаунта для разделения потоков платежей. Нужен, если магазин разделяет поток платежей по нескольким субаккаунтам. Можно передать в запросе или в заголовке Mcp-Param-Gateway-Id. Рекомендуется использовать заголовок. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор счета. |
| status | string | Обязательный | Статус счета. |
| amount | object | Обязательный | Сумма счета. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| url | string | Необязательный | Ссылка на страницу счета. |
| payment_details | object | Необязательный | Данные связанного платежа. Возвращается, если платеж по счету успешен. |
| payment_details.id | string | Условно обязательный | Идентификатор связанного платежа. Возвращается в объекте payment_details. |
| payment_details.status | string | Условно обязательный | Статус связанного платежа. Возвращается в объекте payment_details. |
| description | string | Необязательный | Описание счета, указанное при создании. Возвращается, если описание было указано при создании счета. |
| expires_at | string | Необязательный | Срок действия счета. Возвращается только для счетов в статусе pending. |
get_invoice — получение информации о счете
Получает информацию о счете по его идентификатору.
Параметры запроса
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор счета. |
Параметры ответа
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
| id | string | Обязательный | Идентификатор счета. |
| status | string | Обязательный | Статус счета. |
| amount | object | Обязательный | Сумма счета. |
| amount.value | string | Обязательный | Сумма в выбранной валюте. |
| amount.currency | string | Обязательный | Трехбуквенный код валюты в формате ISO-4217. |
| url | string | Необязательный | Ссылка на страницу счета. |
| payment_details | object | Необязательный | Данные связанного платежа. Возвращается, если платеж по счету успешен. |
| payment_details.id | string | Условно обязательный | Идентификатор связанного платежа. Возвращается в объекте payment_details. |
| payment_details.status | string | Условно обязательный | Статус связанного платежа. Возвращается в объекте payment_details. |
| description | string | Необязательный | Описание счета, указанное при создании счета. Возвращается, если описание было указано при создании счета. |
| expires_at | string | Необязательный | Срок действия счета. Возвращается только для счетов в статусе pending. |
Что почитать еще