# Яндекс Директ: Прямой вызов API Яндекс Директа — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Директа:** Универсальный запрос: вызывает напрямую любой сервис или метод API Яндекс Директа v5 (например service "bidmodifiers", method "get").

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

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

> Я хочу выполнить дополнительный запрос к API.

Универсальный запрос: вызывает напрямую любой сервис или метод API Яндекс Директа v5 (например service "bidmodifiers", method "get").

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

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

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

- `service` — **обязательно**. Путь сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, vcards, changes, keywordsresearch.
- `method` — **обязательно**. Метод API, например get, add, update, delete, set, toggle, checkCampaigns.
- `params` — **необязательно**. Объект params для метода — как есть.
- `confirmWrite` — **необязательно**. Должен быть true для запуска метода записи (всё, кроме get/has/check).

## Что вернёт

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

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

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

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

> Выполнить дополнительный запрос к API в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

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

Нужен для сервисов, у которых нет отдельного инструмента. Деньги — в микроединицах (без конвертации). Методы чтения (get/has/check) выполняются свободно; любой другой метод считается записью и требует confirmWrite=true.

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

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

Связанных специализированных инструментов в этой группе нет.

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

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