Авито Реклама: Перевести бонусные рубли на другой аккаунт — MCP-инструмент (tool)

MCP-инструмент (tool) для Авито Рекламы: Переводит бонусные рубли (bonusBalance — промо-средства, которыми можно оплачивать рекламу, но нельзя вывести деньгами) с настроенного аккаунта на другой: amount бонусных рублей, минимум 1.

Техническое имя: transfer_bonus

Какую задачу решает

Я хочу перевести бонусные рубли на другой аккаунт.

Переводит бонусные рубли (bonusBalance — промо-средства, которыми можно оплачивать рекламу, но нельзя вывести деньгами) с настроенного аккаунта на другой: amount бонусных рублей, минимум 1.

Когда использовать

Используйте эту возможность, когда нужен результат «Перевести бонусные рубли на другой аккаунт» без ручной работы в интерфейсе Авито Рекламы. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

• accountIdTo — обязательно. Id аккаунта назначения — того, кто ПОЛУЧАЕТ бонусы. Отправитель — всегда настроенный аккаунт.
• amount — обязательно. Сумма в бонусных рублях. Минимум 1; меньшее значение отклоняется.

Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

Что изменится в Авито Рекламе

Исходный код помечает весь вызов «Перевести бонусные рубли на другой аккаунт» как опасный. Конкретное воздействие зависит от переданного действия и описано ниже; перед вызовом проверьте параметры и обратимость результата.

Пример запроса

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

Возможные ошибки и ограничения

Правила те же, что у transfer_funds: через этот API перевод необратим, пустой объект data означает, что он прошёл, а после сетевой или серверной ошибки следует проверить list_child_accounts_with_balances, а не повторять вызов. Переводит только бонусы — реальные деньги идут через transfer_funds.

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

• Создать дочерний аккаунт без права оплаты — create_child_account
• Дочерние аккаунты — list_child_accounts
• Дочерние аккаунты с балансами — list_child_accounts_with_balances
• Перевести деньги на другой аккаунт — transfer_funds

Технические сведения

• Воздействие: опасная операция
• Группа: Дочерние аккаунты и деньги
• Источник описания: регистрация transfer_bonus в src/tools/child-accounts.ts
• Полный технический справочник
• Все MCP-возможности