Инструменты

Ниже представлена техническая документация по имеющимся у MCP инструментам.

INFO

Инструменты (tools) предназначены только для LLM, пользователь с ними не взаимодействует.

TIP

Для ИИ-ассистентов: Полная инструкция по работе с MCP находится в CPA Pony Skill: тут. Перед использованием инструментов рекомендуется ознакомиться с ней. Описания ниже являются краткой справкой.

list_campaigns [campaigns:read]

Кампании, доступные ключу. Поддерживаются поиск и пагинация.

get_campaign [campaigns:read]

Возвращает одну кампанию: источники статистики (network/tracker, со слагом и provider_name) и количество связок.

list_campaign_bindings [campaigns:read]

Возвращает список связок кампании, используемых в запросах статистики.

get_statistics_capabilities [metadata:read]

Возвращает возможности источника из реестров: доступные объекты группировки, метрики с типами, глубину периода, фильтры, лимиты. Рекомендуется вызывать перед построением сложных запросов.

get_statistics [statistics:read]

Основной инструмент получения статистики. Поддерживает выбор периода, группировку по объекту (campaign/site/ad/…), фильтрацию, сортировку, лимиты, дневную разбивку (daily, только для object=campaign) и выбор свежести данных.

get_statistics_summary [statistics:read]

Возвращает компактную сводку по метрикам одним объектом, например: «сколько потрачено за неделю».

list_triggers [campaigns:read]

Возвращает триггеры пользователя: объект, окно, интервал и блоки условий (условия внутри блока объединяются по И, блоки между собой — по ИЛИ).

list_workflows [campaigns:read]

Возвращает список сценариев пользователя с кампанией, статусом и опубликованной версией.

get_workflow [campaigns:read]

Возвращает граф сценария: узлы (тип и конфигурация) и рёбра (выходной порт → следующий узел).

get_automation_results [statistics:read]

Возвращает журнал выполнения автоматизации: срабатывания триггеров, запуски сценариев и результаты выполнения узлов с указанием объекта, над которым было выполнено действие.

get_provider_reference [metadata:read]

Возвращает справочник провайдера из реестров (KeyMap/ObjectMap/Assignments): типы объектов, канонические метрики, доступные действия по объектам, допустимыми диапазонами значений. Сырые поля API провайдера не раскрываются.

list_workflow_node_types [metadata:read]

Возвращает каталог типов узлов конструктора сценария: категории, выходные порты и config_schema, описывающую необходимые параметры настройки.

create_trigger / update_trigger [automation:write]

Создаёт или полностью обновляет триггер вместе со всеми блоками и условиями одной транзакцией. Используются слаги из справочников. Поддерживается validate_only для dry-run. В update_trigger поле blocks представляет собой полный снимок состояния — отсутствующие блоки удаляются.

set_trigger_enabled [automation:write]

Включает или отключает триггер. Возможность включения зависит от тарифного плана.

create_workflow / update_workflow_graph [automation:write]

Создаёт новый сценарий (в виде выключенного черновика, при необходимости сразу с графом) или полностью заменяет draft-граф. Ответ включает результат валидации.

publish_workflow [automation:write]

Публикует новую неизменяемую версию сценария.

set_workflow_enabled [automation:write]

Включает или отключает сценарий. Для включения требуется наличие опубликованной версии.

list_notes [notes:read]

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

create_note / update_note / delete_note [notes:write]

Создание, изменение и удаление заметок. Заметка может быть привязана к кампании, связке, триггеру, воркфлоу или храниться на уровне аккаунта.