# Яндекс Директ: Баланс аккаунта — 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, AmountAvailableForTransfer, Currency, Discount, AccountID) через устаревший сервис AccountManagement Live v4 — единственный API Яндекс Директа, который отдаёт баланс (в v5 финансового метода нет).

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

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

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

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

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

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

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

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

- [Данные аккаунта](./get-account-info.md) — `get_account_info`
- [Квота API](./get-quota.md) — `get_quota`

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

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