Возвращает последние увиденные значения X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset, сгруппированные по логическим доменам API (core, messenger, items и т.д.). Полезно для диагностики "почему меня троттлят" — Avito выставляет лимит на минуту.

Универсальный health-check: версия пакета, активные capabilities, состояние rate-limits, idempotency ledger size, pending actions count, dryRun-default. Не дёргает Avito API. Безопасно вызывать сколько угодно.

Сообщает только МЕТАДАННЫЕ токена: present/absent, expiresInSec, последняя ошибка refresh. Сам токен НИКОГДА не отдаётся — для этого используйте auth_* tools под AVITO_MCP_EXPOSE_AUTH_TOOLS=1 (скрыты по default). По умолчанию не вынуждает refresh — если probe=true, попытается getToken() (это может вызвать refresh).

Возвращает машинно-читаемое описание текущей конфигурации: режим, allow/deny lists, confirmation, dry-run, idempotency, доступ к локальным файлам. Полезно агенту чтобы понять, какие операции принципиально доступны до того как пробовать вызывать tools.

⚠️ Выполняет ранее отложенное действие по его confirmation_id. Применять ТОЛЬКО после явного подтверждения человеком — flow задуман как server-side two-step guard от случайного one-shot выполнения, не как криптографическая защита от автономного агента. Confirmation одноразовый: после успешного вызова id удаляется. AVITO_MCP_CONFIRMATION_SECRET не задан — работает soft-confirmation. Установите env-переменную чтобы перейти на hard-confirmation.

Отменяет ранее отложенное действие. После cancel confirmation_id перестаёт быть валидным.

Список текущих pending actions, ожидающих подтверждения. Args не показываются — только tool name, risk, краткое summary, времена создания и истечения. Используйте для диагностики "что я только что попросил подтвердить".

Возвращает идентификатор пользователя и его регистрационные данные (email, имя, телефоны, profile_url).

Возвращает баланс кошелька авторизованного пользователя: сумму реальных денег (real) и сумму бонусных средств (bonus).

Возвращает список операций (списания/пополнение кошелька) за период. Ограничения: dateTimeFrom не далее года в прошлое, диапазон между from/to не более одной недели. Формат дат — ISO 8601 (например, "2026-05-01T00:00:00").

Список объявлений авторизованного пользователя — статус, категория, ссылка на сайте. Лимит: 25 запросов в минуту. Не работает с объявлениями сотрудников (в этом случае вернёт пустой список). Поддерживает пагинацию через page+per_page.

Детальная информация по одному объявлению: заголовок, цена, статус, адрес, фото и др.

Статистика звонков по объявлениям за период (всего/новые/отвеченные/новые отвеченные, в разрезе дней). Период dateFrom..dateTo в формате YYYY-MM-DD. Без itemIds — статистика по всем объявлениям пользователя.

Информация о стоимости услуг продвижения (VAS) и доступных значках для заданных объявлений. Принимает массив ID объявлений. Используйте перед покупкой VAS, чтобы узнать цену.

Поверхностная статистика по объявлениям за период (просмотры, контакты). dateFrom/dateTo — YYYY-MM-DD. periodGrouping: day|week|month. fields — массив метрик (например ["uniqViews","uniqContacts","calls"]).

Расширенная аналитика по объявлениям (views, contacts, presenceSpending и др.) с группировкой и сортировкой. Поддерживает фильтры по категориям и сотрудникам. limit ≤ 1000.

Статистика расходов профиля (по типам услуг — vas/cpa/tariff и т.п.) за период. grouping — строка "day"|"week"|"month" (НЕ объект). filter — по категориям/объявлениям/локациям. Обязательны: dateFrom, dateTo, spendingTypes, grouping.

⚠️ ИЗМЕНЯЕТ ЦЕНУ объявления (целое число в рублях). Подтверждайте у пользователя перед вызовом на боевом аккаунте.

⚠️ ПЛАТНОЕ. Применяет одну дополнительную услугу (VAS) к объявлению — тратит деньги с баланса. vas_id — slug услуги (highlight, xl, premium, vip, ...). Сначала вызовите items_post_vas_prices.

⚠️ ПЛАТНОЕ. Применяет пакет услуг VAS к объявлению — тратит деньги. package_id — идентификатор пакета.

⚠️ ПЛАТНОЕ. Применяет несколько услуг продвижения (slugs) и/или стикеры (stickers) к одному объявлению — тратит деньги.

Список чатов пользователя. Поддерживает фильтры: только непрочитанные, по объявлениям, по типам чатов (u2i/u2u), пагинация. Возвращает массив чатов с превью последнего сообщения.

Детали одного чата по chat_id: участники, объявление, контекст, последнее сообщение.

Список сообщений чата (V3) с пагинацией. Возвращает массив сообщений (текст, изображения, голос, ссылки, дата).

Получение URL для скачивания голосовых сообщений по их идентификаторам. Принимает CSV-список voice_ids.

Текущие подписки на webhooks (URL получения уведомлений + статус).

⚠️ ОТПРАВЛЯЕТ РЕАЛЬНОЕ сообщение клиенту в чат. text до 1000 символов. Подтверждайте у пользователя перед вызовом — это видит покупатель.

⚠️ ОТПРАВЛЯЕТ изображение в чат. Сначала загрузите изображение через messenger_upload_images и используйте полученный image_id.

⚠️ УДАЛЯЕТ сообщение в чате. Подтверждайте у пользователя.

Помечает все непрочитанные сообщения чата как прочитанные.

⚠️ БЛОКИРУЕТ пользователей. users: массив {user_id, context?:{item_id, reason_id}}. reason_id: 1=спам, 2=мошенничество, 3=оскорбления, 4=другое.

⚠️ ВКЛЮЧАЕТ webhook-уведомления о новых сообщениях. Требует ПУБЛИЧНЫЙ HTTPS URL, доступный из интернета. Локально не работает.

Отключает webhook-подписку по URL.

(deprecated, используйте autoload_get_profile_v2) Профиль автозагрузки v1.

(deprecated, используйте autoload_create_or_update_profile_v2) Создание/редактирование настроек профиля автозагрузки v1.

⚠️ ЗАПУСКАЕТ процесс автозагрузки объявлений из файла по URL, указанному в настройках профиля. Лимит: одна выгрузка в час. Не требует параметров.

Полное дерево категорий товаров Avito для автозагрузки.

Список полей (атрибутов) для конкретной категории. node_slug — slug категории из autoload_user_docs_tree.

Получить Ad ID (из файла) по Avito ID. query — CSV-список Avito ID.

Получить Avito ID по Ad ID (из файла). query — CSV-список Ad ID.

Профиль автозагрузки v2 (актуальная версия).

Создание/редактирование настроек профиля автозагрузки v2. feeds_data — массив фидов (XML/YML/CSV URL + категории). schedule — расписание.

Список отчётов автозагрузки с пагинацией и фильтром по датам.

Информация об объявлениях в автозагрузке по ID. query — CSV-список ID.

(deprecated, используйте v3) Статистика по последней завершённой выгрузке.

(deprecated, используйте v3) Статистика по конкретной выгрузке.

Все объявления из конкретной выгрузки (с пагинацией и фильтрами).

Списания за объявления в конкретной выгрузке.

Статистика по последней завершённой выгрузке (v3).

Статистика по конкретной выгрузке (v3).

Список заказов с фильтрами. ids/statuses — массивы строк. dateFrom — Unix timestamp (сек). Пагинация: page+limit.

Доступные временные промежутки приезда курьера для заказа.

Скачать сгенерированный PDF-файл этикетки по taskID (из generateLabels/Extended). С v0.5.0 возвращает структурированный binary-ответ: {mimeType: "application/pdf", sizeBytes, base64}. Декодируйте base64 чтобы сохранить файл локально или напечатать.

⚠️ ПЕРЕДАЁТ "честный знак" (DataMatrix) для маркировки товара в заказе.

⚠️ Выбирает отделение Почты России для получения возврата товара.

⚠️ ИЗМЕНЯЕТ СТАТУС заказа через transition (например "confirm", "ship", "cancel"). Состав transitions зависит от текущего статуса — см. swagger Управление заказами.json.

Проверка кода подтверждения заказа (при выдаче через ПВЗ/пункт самовывоза).

⚠️ Подготовка заказа с самовывозом (CnC = click-and-collect). bookingPeriod — период бронирования (часов).

⚠️ Выбор временного промежутка для приезда курьера. Сначала вызовите orders_get_courier_delivery_range для списка доступных интервалов.

⚠️ Передача трек-номера курьерской службы для заказа.

Создать задачу на генерацию этикеток (до 100 заказов). Возвращает taskID для последующего скачивания через orders_download_label.

Создать задачу на генерацию этикеток для большого числа заказов (до 1000). Возвращает taskID для последующего скачивания через orders_download_label.

Создание анонса посылки в СД (для партнёров служб доставки).

Отмена анонса посылки в СД.

3PL-партнёрское создание посылки (CreateParcelRequest). Обязательны: orderID, parcelID, items, sender, receiver, payment. Опционально: barcodes, directOrderID, options, package. Вложенные объекты — см. соответствующие схемы в swaggers/Доставка.json.

[SANDBOX] Создание анонса в тестовой среде Avito.

[SANDBOX] Трекинг события анонса.

[SANDBOX] Установка графика работы зоны доставки на определённый день. Перезаливка перезаписывает старое расписание.

[SANDBOX] Отмена тестовой посылки. actor: sender/receiver.

[SANDBOX] Проверка кода подтверждения посылки.

[SANDBOX] Изменение параметров доставки (свойств) посылки.

[SANDBOX] Установка фактического адреса приёма/возврата посылки.

[SANDBOX] Отправка события трекинга в систему Avito.

[SANDBOX] Запрет приёма посылки от отправителя.

[SANDBOX] Список сортировочных центров.

[SANDBOX] Загрузка сортировочных центров.

[SANDBOX] Загрузка областей доставки для тарифа.

[SANDBOX] Установка тегов сортировочным центрам (своим/чужим).

[SANDBOX] Загрузка терминалов (ПВЗ) для тарифа.

[SANDBOX] Обновление зон сроков по тарифу.

[SANDBOX] Загрузка нового тарифа (v2).

[SANDBOX] Информация по задаче (taskID из ответа async-операций).

[SANDBOX v1] Отправка события об отмене тестового анонса.

[SANDBOX v1] Отмена тестовой посылки.

[SANDBOX v1] Создание заявки на изменение данных тестовой посылки.

[SANDBOX v1] Создание тестового анонса.

[SANDBOX v1] Последнее событие тестового анонса по ID.

[SANDBOX v1] Информация об изменении тестовой посылки по ID заявки.

[SANDBOX v1] Информация о тестовой посылке по ID.

[SANDBOX v1] ID зарегистрированной тестовой посылки по orderID.

[SANDBOX v2] Создание тестовой посылки.

Отправка результата исполнения заявки на изменение посылки.

[SANDBOX] Массовое обновление свойств посылок.

BBIP. Прогноз эффекта продвижения для списка объявлений (просмотры, контакты). Для каждого объявления передай {itemId, duration, oldPrice, price} — те же значения, что и для create: возьми из promotion_get_bbip_suggests_by_items_v1 (budgets[].{oldPrice,price} в копейках/день, duration.recommended в днях).

BBIP. Рекомендуемые варианты бюджета продвижения для списка объявлений.

⚠️ ПЛАТНОЕ. BBIP — подключение услуги продвижения для объявлений. Списывает деньги с баланса. Сначала вызови promotion_get_bbip_suggests_by_items_v1; для каждого товара возьми вариант из budgets[] (поля oldPrice и price, в копейках за день) и duration.recommended (дни), и передай их сюда как {itemId, duration, oldPrice, price}. Полный бюджет = price × duration.

Справочник всех типов услуг продвижения (slug, название, описание).

Список доступных услуг продвижения для конкретных объявлений.

Список заявок (orders) на продвижение пользователя с пагинацией.

Статус заявки на продвижение по orderId (UUID).