MCP-инструменты и ресурсы

Этот справочник генерируется автоматически из работающего MCP-сервера.

Рабочий процесс

ИИ-агентам следует выполнять этот рабочий процесс для запуска конвейеров:

1. list_pipelines — обнаружить доступные конвейеры
2. get_pipeline_schema — получить схему входных данных для выбранного конвейера
3. request_upload — загрузить необходимые файлы (изображения, видео, аудио)
4. run_pipeline — запустить конвейер с нужными входными данными
5. get_pipeline_run_status — проверить результат (или дождаться уведомлений в реальном времени)

Совет

После вызова run_pipeline сервер автоматически подписывается на обновления статуса. Ваш ассистент будет получать notifications/pipeline/status по мере прохождения конвейером стадий pending → running → completed (или failed).

---

Инструменты

list_pipelines

Выводит список всех доступных ИИ-конвейеров для видео/изображений. Возвращает name, slug, description, category, стоимость в кредитах и требуемых провайдеров для каждого активного конвейера.

Параметры: Нет

---

get_pipeline_schema

Получает схему входных данных для конкретного конвейера. Возвращает JSON Schema, описывающую обязательные и необязательные поля ввода. Используйте это перед запуском конвейера, чтобы понять, какие входные данные нужны.

Параметры:

Имя	Тип	Обязательный	Описание
pipeline_slug	string	Да	Слаг-идентификатор конвейера (например, ‘image-generator’, ‘video-generator’)

---

run_pipeline

Запускает ИИ-конвейер по слагу с заданными входными данными. Используйте list_pipelines для обнаружения доступных конвейеров и get_pipeline_schema для просмотра обязательных входных данных. Возвращает ID запуска для отслеживания статуса.

Параметры:

Имя	Тип	Обязательный	Описание
input	object	Да	Поля ввода конвейера в виде JSON-объекта. Используйте get_pipeline_schema для просмотра обязательных полей каждого конвейера.
pipeline_slug	string	Да	Слаг-идентификатор конвейера для запуска (например, ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Проверяет статус запуска конвейера. Возвращает статус (pending/running/completed/failed), выходные данные, сообщения об ошибках, отметки времени и URL сгенерированных ресурсов.

Параметры:

Имя	Тип	Обязательный	Описание
run_id	string	Да	ID запуска конвейера, возвращённый run_pipeline

---

request_upload

Запрашивает предподписанный URL для загрузки файла в S3. Используйте это для входных данных конвейера, которым требуются URL файлов (например, изображения, видео, аудио).

Двухшаговый процесс загрузки:

1. Вызовите этот инструмент с filename и content_type, чтобы получить предподписанный URL для загрузки и итоговый URL ресурса
2. Отправьте содержимое файла методом PUT на upload_url (предподписанный, истекает через 5 минут)
3. Используйте asset_url в качестве входного значения при запуске конвейера

Поддерживаемые типы контента: image/* (до 10 МБ), video/* (до 50 МБ), audio/* (до 20 МБ)

Параметры:

Имя	Тип	Обязательный	Описание
content_type	string	Да	MIME-тип файла (например, ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Да	Имя загружаемого файла (например, ‘photo.jpg’, ‘video.mp4’)

---

---

Ресурсы

billing://balance

Баланс кредитов

Ваш текущий баланс кредитов, включая доступные и зарезервированные кредиты.

MIME-тип: application/json

---

billing://history

История кредитов

История ваших операций с кредитами: покупки, использование и возвраты.

MIME-тип: application/json

---

assets://list

Список ресурсов

Выводит список ваших сгенерированных ресурсов (изображения, видео, аудио). Все ресурсы из запусков конвейеров.

MIME-тип: application/json

---

assets://get/{asset_id}

Получить ресурс

Получает сведения о конкретном ресурсе по ID, включая метаданные и URL для скачивания.

MIME-тип: application/json

---

assets://list/{type}

Список ресурсов по типу

Выводит список ваших сгенерированных ресурсов, отфильтрованных по типу (image, video, audio).

MIME-тип: application/json

---

---

Уведомления в реальном времени

Когда вы запускаете конвейер, MCP-сервер автоматически подписывается на обновления статуса. Уведомления используют метод notifications/pipeline/status:

{
  "method": "notifications/pipeline/status",
  "params": {
    "run_id": "uuid",
    "status": "completed",
    "pipeline_name": "Pipeline Name",
    "pipeline_slug": "pipeline-slug",
    "assets": [
      {
        "id": "uuid",
        "url": "https://s3.pipe2.ai/assets/...",
        "type": "image"
      }
    ]
  }
}

Значения статуса: pending, running, completed, failed, cancelled