# Авито Реклама: Перевести бонусные рубли на другой аккаунт — 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.md) — `create_child_account`
- [Дочерние аккаунты](./list-child-accounts.md) — `list_child_accounts`
- [Дочерние аккаунты с балансами](./list-child-accounts-with-balances.md) — `list_child_accounts_with_balances`
- [Перевести деньги на другой аккаунт](./transfer-funds.md) — `transfer_funds`

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

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