MCP Tools

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

Deploy Operations

runner_deploy

Executa pipeline de deploy completo.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho ou nome da app
version string Nao Versao especifica
instance string Nao Instancia alvo
skip_tests boolean Nao Pular testes

Retorno:

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

runner_rollback

Reverte para versao anterior.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho ou nome da app
instance string Nao Instancia alvo
to string Nao Versao especifica

Application Management

runner_list_apps

Lista todas as aplicacoes registradas.

Parametros: Nenhum

Retorno:

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

runner_app_status

Retorna status detalhado de uma app.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho ou nome da app

runner_add_app

Registra nova aplicacao.

Parametros:

Nome Tipo Obrigatorio Descricao
repo string Sim Repositorio GitHub
deploy boolean Nao Executar deploy apos add

Instance Management

runner_instances

Lista instancias de um projeto.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto

runner_versions

Lista versoes de uma instancia.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto
instance string Sim Nome da instancia

runner_destroy_instance

Remove instancia completamente.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto
instance string Sim Nome da instancia

Canary Deployment

runner_weights

Mostra distribuicao de trafego.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto
instance string Sim Nome da instancia

Retorno:

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

runner_set_weight

Ajusta peso de versao.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto
instance string Sim Nome da instancia
version string Sim Versao
weight integer Sim Peso (0-100)

runner_promote

Promove versao para 100%.

Parametros:

Nome Tipo Obrigatorio Descricao
project string Sim Nome do projeto
instance string Sim Nome da instancia
version string Sim Versao a promover

Staging (PR Environments)

runner_stage_deploy

Cria ambiente de staging para PR.

Parametros:

Nome Tipo Obrigatorio Descricao
repo string Sim Repositorio GitHub
pr integer Sim Numero da PR

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:

Nome Tipo Obrigatorio Descricao
id string Sim ID do staging

runner_stage_cleanup

Limpa stagings expirados.

Parametros: Nenhum

Environment Management

runner_env_status

Mostra variaveis de ambiente.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho da app

runner_env_set

Define variavel de ambiente.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho da app
key string Sim Nome da variavel
value string Sim Valor
secret boolean Nao Se e secret

runner_env_validate

Valida variaveis obrigatorias.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho da app
required string Sim Lista separada por virgula

Configuration

runner_validate_config

Valida arquivo .deploy.yml.

Parametros:

Nome Tipo Obrigatorio Descricao
path string Sim Caminho do arquivo

runner_generate_config

Gera template de configuracao.

Parametros: Nenhum

Retorno: Template YAML completo

Maintenance

runner_fetch

Busca atualizacoes nas apps.

Parametros:

Nome Tipo Obrigatorio Descricao
deploy boolean Nao Executar deploy se houver mudancas

runner_cleanup

Limpa versoes antigas.

Parametros:

Nome Tipo Obrigatorio Descricao
expired boolean Nao Incluir instancias expiradas

Logs

runner_logs_history

Historico de deploys.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho da app
limit integer Nao Numero de entradas

runner_logs_tail

Ultimas linhas de log.

Parametros:

Nome Tipo Obrigatorio Descricao
app string Sim Caminho da app
lines integer Nao Numero de linhas
By Borlot.com.br on 12/02/2026