Ferramentas e recursos do MCP

Esta referência é gerada automaticamente a partir do servidor MCP em execução.

Fluxo de trabalho

Os agentes de IA devem seguir este fluxo de trabalho para executar pipelines:

1. list_pipelines — descubra os pipelines disponíveis
2. get_pipeline_schema — obtenha o schema de entrada do pipeline escolhido
3. request_upload — envie os arquivos necessários (imagens, vídeos, áudio)
4. run_pipeline — execute o pipeline com a entrada obrigatória
5. get_pipeline_run_status — verifique o resultado (ou aguarde as notificações em tempo real)

Dica

Depois de chamar run_pipeline, o servidor se inscreve automaticamente para receber atualizações de status. Seu assistente receberá notifications/pipeline/status conforme o pipeline avança por pending → running → completed (ou failed).

---

Ferramentas

list_pipelines

Lista todos os pipelines de vídeo/imagem de IA disponíveis. Retorna nome, slug, descrição, categoria, custo em créditos e provedores necessários para cada pipeline ativo.

Parâmetros: Nenhum

---

get_pipeline_schema

Obtém o schema de entrada de um pipeline específico. Retorna o JSON Schema que descreve os campos de entrada obrigatórios e opcionais. Use isto antes de executar um pipeline para entender quais entradas são necessárias.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
pipeline_slug	string	Sim	O identificador de slug do pipeline (por exemplo, ‘image-generator’, ‘video-generator’)

---

run_pipeline

Executa um pipeline de IA por slug com a entrada fornecida. Use list_pipelines para descobrir os pipelines disponíveis e get_pipeline_schema para ver as entradas necessárias. Retorna um ID de execução para acompanhar o status.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
input	object	Sim	Campos de entrada do pipeline como um objeto JSON. Use get_pipeline_schema para ver os campos obrigatórios de cada pipeline.
pipeline_slug	string	Sim	O identificador de slug do pipeline a executar (por exemplo, ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Verifica o status de uma execução de pipeline. Retorna o status (pending/running/completed/failed), os dados de saída, mensagens de erro, timestamps e as URLs dos assets gerados.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
run_id	string	Sim	O ID da execução do pipeline retornado por run_pipeline

---

request_upload

Solicita uma URL de upload S3 pré-assinada para um arquivo. Use isto para entradas de pipeline que exigem URLs de arquivos (por exemplo, imagens, vídeos, áudio).

Fluxo de upload em duas etapas:

1. Chame esta ferramenta com o nome do arquivo e o content_type para obter uma URL de upload pré-assinada e a URL final do asset
2. Envie (PUT) o conteúdo do arquivo para a upload_url (pré-assinada, expira em 5 minutos)
3. Use a asset_url como valor de entrada ao executar um pipeline

Tipos de conteúdo suportados: image/* (máx. 10MB), video/* (máx. 50MB), audio/* (máx. 20MB)

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
content_type	string	Sim	Tipo MIME do arquivo (por exemplo, ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Sim	Nome do arquivo a enviar (por exemplo, ‘photo.jpg’, ‘video.mp4’)

---

---

Recursos

billing://balance

Saldo de créditos

Seu saldo de créditos atual, incluindo créditos disponíveis e reservados.

Tipo MIME: application/json

---

billing://history

Histórico de créditos

Seu histórico de transações de créditos, mostrando compras, uso e reembolsos.

Tipo MIME: application/json

---

assets://list

Listar assets

Lista seus assets gerados (imagens, vídeos, áudio). Todos os assets de execuções de pipeline.

Tipo MIME: application/json

---

assets://get/{asset_id}

Obter asset

Obtém os detalhes de um asset específico por ID, incluindo metadados e URL de download.

Tipo MIME: application/json

---

assets://list/{type}

Listar assets por tipo

Lista seus assets gerados filtrados por tipo (image, video, audio).

Tipo MIME: application/json

---

---

Notificações em tempo real

Quando você executa um pipeline, o servidor MCP se inscreve automaticamente para receber atualizações de status. As notificações usam o método 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"
      }
    ]
  }
}

Valores de status: pending, running, completed, failed, cancelled