Skip to main content
Glama
helbertparanhos

easypanel-mcp-server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
EASYPANEL_URLYesThe URL of your Easypanel panel (e.g., https://your-panel.example.com)
EASYPANEL_TOKENYesYour Easypanel API token (obtained from Settings -> API -> Generate Token)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_projectsA

Lista todos os projetos do Easypanel com seus serviços e status. Use para descobrir o que existe no painel antes de operar.

get_projectA

Retorna detalhes completos de um projeto: lista de serviços, configurações e status atual.

create_projectB

Cria um novo projeto no Easypanel.

delete_projectA

⚠️ DESTRUTIVO — Remove permanentemente o projeto e TODOS os seus serviços e dados. Irreversível. Requer confirm: "CONFIRMO".

inspect_serviceA

Retorna configuração completa de um serviço: source, env vars, deploy config, mounts, ports, domínios, recursos. Use SEMPRE antes de qualquer update para preservar o estado.

create_serviceA

Cria um novo serviço de app em um projeto. Após criar, configure a source com set_source_github ou set_source_image.

rename_serviceA

⚠️ Renomeia ou move um serviço. Webhooks, DNS e referências internas que usam o nome antigo deixarão de funcionar. Requer confirm: "CONFIRMO".

destroy_serviceA

⚠️ DESTRUTIVO — Remove permanentemente o serviço e seus dados. Irreversível. Requer confirm: "CONFIRMO".

deploy_serviceA

Dispara o deploy do serviço com a configuração atual. Usa o source configurado (GitHub, image, dockerfile). Funciona para serviços app E compose — detecta o tipo e roteia para o namespace certo (não precisa saber de antemão se é compose).

start_serviceA

Inicia um serviço que está parado. Funciona para app e compose (em compose, equivale a um redeploy/compose up).

stop_serviceA

⚠️ PARA o serviço em produção. Usuários não conseguirão acessar enquanto parado. Requer confirm: "CONFIRMO".

restart_serviceA

Reinicia o serviço. Causa breve indisponibilidade. Funciona para app E compose — em compose, reinicia via redeploy (docker compose up recria os containers).

get_service_errorA

Retorna o último erro registrado do serviço. Use para debugar falhas de deploy ou runtime.

get_exposed_portsB

Lista as portas expostas (publicadas no host) de um serviço. Use para descobrir em quais portas o serviço está acessível externamente.

get_service_notesA

Lê as notas/anotações salvas no serviço.

set_service_notesB

Salva notas/anotações no serviço (markdown suportado).

set_service_resourcesA

Define limites e reservas de CPU e memória do serviço. Envie só os campos que quer alterar — os omitidos mantêm o valor atual (0 = sem limite). Memória em MB, CPU em núcleos (0.5 = meio núcleo). Aplica no próximo deploy/restart.

set_source_githubB

Configura a source do serviço para um repositório GitHub. O repo deve estar conectado no Easypanel (Settings > GitHub).

set_source_imageC

Configura a source do serviço para uma imagem Docker.

enable_github_deployA

Ativa o auto-deploy via GitHub: a cada push no branch configurado, um deploy é disparado automaticamente.

disable_github_deployA

Desativa o auto-deploy via GitHub. Deploys precisarão ser disparados manualmente.

list_actionsA

Lista as ações/jobs em execução ou recentes (deploys, builds, restarts). A lista global guarda apenas uma janela curta — passe projectName/serviceName para filtrar no servidor e não perder ações de um serviço específico.

get_actionB

Retorna detalhes e logs de uma ação específica (deploy, build, etc).

get_env_varsA

Lista as variáveis de ambiente do serviço. Valores de variáveis sensíveis (KEY, SECRET, PASSWORD, TOKEN) são mascarados por padrão. Use include_values: true para ver os valores completos.

set_env_varA

Adiciona ou atualiza UMA variável de ambiente. Lê o estado atual antes de escrever — não apaga outras variáveis.

delete_env_varA

⚠️ Remove UMA variável de ambiente. Lê estado atual antes de escrever. Requer confirm: "CONFIRMO".

get_service_logsB

Busca os logs do container de um serviço. Use para debugar erros em runtime. Retorna as últimas N linhas.

get_build_logsB

Retorna os logs de build/deploy do último action registrado para o serviço. Use para debugar falhas de build.

get_system_statsA

Retorna métricas do servidor: CPU, memória, disco, rede e uptime. Use para verificar saúde do servidor.

list_domainsB

Lista todos os domínios configurados em um serviço.

add_domainB

Adiciona um domínio customizado ao serviço com HTTPS automático via Let's Encrypt.

remove_domainA

⚠️ Remove permanentemente um domínio. O tráfego para esse host parará de funcionar. Requer confirm: "CONFIRMO".

set_primary_domainA

Define qual domínio é o primário (usado como URL principal do serviço).

create_databaseA

Cria um serviço de banco de dados (Postgres, MySQL, MariaDB, MongoDB ou Redis) em um projeto.

inspect_databaseA

Retorna detalhes do banco de dados: credenciais, porta exposta, connection string e status.

destroy_databaseA

⚠️ DESTRUTIVO — Remove o banco de dados e TODOS os seus dados permanentemente. Irreversível. Requer confirm: "CONFIRMO".

get_docker_statsA

Retorna estatísticas dos containers Docker em execução: CPU, memória, rede por container.

get_storage_statsB

Retorna uso de armazenamento do servidor.

get_service_statsA

Retorna métricas de um serviço específico: CPU e memória do container.

list_containersA

Lista os containers Docker em execução de um serviço (ID, nome, imagem, comando, status, portas). Use para descobrir o container antes de exec_in_container ou para checar se o serviço está rodando.

exec_in_containerA

Executa um comando dentro do container de um serviço e retorna a saída (stdout/stderr). Use para debugar em runtime: inspecionar arquivos, checar variáveis, testar conectividade, rodar migrations, etc. Roda no primeiro container do serviço (ou no containerId informado). ⚠️ Executa comandos arbitrários — comandos potencialmente destrutivos (rm -rf, dd, mkfs, shutdown, kill, pipe para shell, etc.) exigem confirm: "CONFIRMO".

get_docker_eventsA

Captura eventos Docker do servidor em tempo real durante uma janela curta (~8s) — start, stop, kill, die, exec, health_status, etc. Use para investigar reinícios e falhas. Obs: só mostra eventos que ocorrem durante a captura (não há histórico); um servidor ocioso pode retornar vazio.

prune_dockerA

Executa um "docker system prune" no servidor inteiro via Easypanel: remove containers parados, redes sem uso, cache de build e imagens não referenciadas para liberar espaço em disco. ⚠️ Ação destrutiva e de escopo GLOBAL (afeta todos os projetos do servidor, não um serviço específico) — exige confirm: "CONFIRMO". Use cleanup_docker_images para uma limpeza mais leve (só imagens não usadas).

cleanup_docker_imagesA

Remove do servidor apenas as imagens Docker não utilizadas (dangling/sem container), liberando espaço sem mexer em containers, redes ou volumes. Operação mais leve e segura que prune_docker — imagens podem ser recriadas em um novo deploy. Escopo global do servidor.

list_mountsA

Lista os volumes/mounts de um serviço (volumes nomeados, bind mounts e arquivos montados). Use para ver onde os dados persistentes do serviço estão.

create_mountA

Adiciona um volume/mount a um serviço para persistir dados entre deploys. Use type 'volume' para volume nomeado gerenciado, 'bind' para mapear um caminho do host. Aplica no próximo deploy.

list_portsA

Lista os mapeamentos de porta de um serviço (porta publicada no host → porta do container). Complementa get_exposed_ports com a configuração completa de portas. Use para ver o que está exposto e em qual protocolo.

create_portA

Publica uma porta de um serviço no host (port mapping), expondo-a externamente sem passar pelo proxy/domínio. Útil para TCP/UDP brutos (bancos, jogos, etc). Aplica no próximo deploy. ⚠️ Portas privilegiadas (publishedPort < 1024, ex: 80/443/22) exigem confirm: "CONFIRMO".

create_composeA

Cria um serviço do tipo Docker Compose em um projeto. Depois use set_compose_file (via trpc_raw) ou o painel para definir o docker-compose, e deploy_compose para subir.

inspect_composeA

Retorna a configuração de um serviço Docker Compose: arquivo compose, env, source e estado. Use antes de qualquer alteração.

deploy_composeC

Dispara o deploy (docker compose up) de um serviço Compose com a configuração atual.

list_usersA

Lista os usuários do painel Easypanel (admin, e-mails, papéis).

list_certificatesA

Lista os certificados SSL/TLS gerenciados pelo Easypanel (domínios cobertos, emissor, validade). Use para auditar HTTPS e renovações.

list_nodesA

Lista os nós do cluster Docker Swarm gerenciado pelo Easypanel (manager/worker, status, disponibilidade). Em servidor único retorna apenas o nó local.

restart_panelA

⚠️ Reinicia o próprio Easypanel. O painel/API ficam brevemente indisponíveis; os serviços hospedados continuam rodando. Requer confirm: "CONFIRMO".

reboot_serverA

⚠️ CRÍTICO — Reinicia o SERVIDOR inteiro (máquina host). TODOS os serviços e o painel ficam fora do ar até o boot completar. Use apenas em manutenção planejada. Requer confirm: "CONFIRMO".

trpc_rawA

Chama diretamente qualquer procedure tRPC do Easypanel (~347 em 43 namespaces) não coberta pelas tools dedicadas. Use para recursos avançados: traefik., branding., cloudflareTunnel., box., mariadb., volumeBackups., databaseBackups.*, etc. Leitura (isMutation=false) é o padrão. ⚠️ Reads podem retornar dados sensíveis (env vars/secrets de qualquer projeto). Para escrita, passe isMutation:true E confirm:"CONFIRMO" — mutations arbitrárias pulam as proteções das tools curadas.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/helbertparanhos/easypanel-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server