Яндекс Директ: Баланс аккаунта — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Директа: Возвращает баланс общего счёта и финансовые поля (Amount, AmountAvailableForTransfer, Currency, Discount, AccountID) через устаревший сервис AccountManagement Live v4 — единственный API Яндекс Директа, который отдаёт баланс (в v5 финансового метода нет).

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

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

Я хочу проверить баланс аккаунта.

Возвращает баланс общего счёта и финансовые поля (Amount, AmountAvailableForTransfer, Currency, Discount, AccountID) через устаревший сервис AccountManagement Live v4 — единственный API Яндекс Директа, который отдаёт баланс (в v5 финансового метода нет).

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

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

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

logins — необязательно. Логины аккаунтов, по которым нужны данные. По умолчанию — собственный аккаунт токена.

Что вернёт

Что изменится в Яндекс Директе

Инструмент только читает данные или состояние подключения и не изменяет их.

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

Проверить баланс аккаунта в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их.

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

Amount — строка в ВАЛЮТЕ АККАУНТА (не в микроединицах); отрицательный Amount означает задолженность. По умолчанию — собственный аккаунт токена; чтобы получить конкретные общие счета, передать logins.

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

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

Данные аккаунта — get_account_info
Квота API — get_quota

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

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