# MCP Tools

O MCP Server disponibiliza 25+ tools para operacoes de deploy.

# Deploy Operations

# runner_deploy

Executa pipeline de deploy completo.

Parametros:

Retorno:

{
  "success": true,
  "version": "v1.2.0",
  "instance": "production",
  "duration_ms": 45000
}

# runner_rollback

Reverte para versao anterior.

Parametros:

# Application Management

# runner_list_apps

Lista todas as aplicacoes registradas.

Parametros: Nenhum

Retorno:

{
  "apps": [
    {
      "name": "meu-app",
      "path": "/data/apps/usuario_meu-app",
      "instances": ["production", "staging"]
    }
  ]
}

# runner_app_status

Retorna status detalhado de uma app.

Parametros:

# runner_add_app

Registra nova aplicacao.

Parametros:

# Instance Management

# runner_instances

Lista instancias de um projeto.

Parametros:

# runner_versions

Lista versoes de uma instancia.

Parametros:

# runner_destroy_instance

Remove instancia completamente.

Parametros:

# Canary Deployment

# runner_weights

Mostra distribuicao de trafego.

Parametros:

Retorno:

{
  "distribution": {
    "v1.0.0": 90,
    "v1.0.1-rc1": 10
  }
}

# runner_set_weight

Ajusta peso de versao.

Parametros:

# runner_promote

Promove versao para 100%.

Parametros:

# Staging (PR Environments)

# runner_stage_deploy

Cria ambiente de staging para PR.

Parametros:

Retorno:

{
  "id": "staging_meu-app_pr42",
  "url": "https://pr-42.staging.meusite.com.br",
  "ttl_hours": 48
}

# runner_stage_list

Lista ambientes de staging ativos.

Parametros: Nenhum

# runner_stage_destroy

Remove ambiente de staging.

Parametros:

# runner_stage_cleanup

Limpa stagings expirados.

Parametros: Nenhum

# Environment Management

# runner_env_status

Mostra variaveis de ambiente.

Parametros:

# runner_env_set

Define variavel de ambiente.

Parametros:

# runner_env_validate

Valida variaveis obrigatorias.

Parametros:

# Configuration

# runner_validate_config

Valida arquivo .deploy.yml.

Parametros:

# runner_generate_config

Gera template de configuracao.

Parametros: Nenhum

Retorno: Template YAML completo

# Maintenance

# runner_fetch

Busca atualizacoes nas apps.

Parametros:

# runner_cleanup

Limpa versoes antigas.

Parametros:

# Logs

# runner_logs_history

Historico de deploys.

Parametros:

# runner_logs_tail

Ultimas linhas de log.

Parametros:

# Config Templates (v2.0.0)

# runner_config_set

Define valor em values.local.yaml de uma app.

Parametros:

# runner_config_get

Le o valor resolvido de uma chave (toda hierarquia de merge).

Parametros:

# PR Deploy (v2.0.0)

# runner_pr_add

Registra um PR deploy vinculado a uma app existente.

Parametros:

# runner_pr_remove

Remove um PR deploy (para container, remove Traefik config e state).

Parametros: