easypanel-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EASYPANEL_URL | Yes | The URL of your Easypanel panel (e.g., https://your-panel.example.com) | |
| EASYPANEL_TOKEN | Yes | Your Easypanel API token (obtained from Settings -> API -> Generate Token) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
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