sapientsai avatar

Dokploy Mcp Server

sapientsai/dokploy-mcp-server

A token-efficient alternative to the official Dokploy MCP that consolidates 67+ tools into 14 action-based tools covering the full DevOps API surface. Instead of separate tools for every database operation, you get one unified tool that handles all five database types (postgres, mysql, mariadb, mongo, redis) via action enums. The server exposes the complete lifecycle for applications, Docker Compose stacks, domains, backups, servers, and deployments. Reach for this when you're managing a self-hosted Dokploy PaaS through Claude and want full API coverage without burning through your context window. Each tool accepts an action parameter (create, deploy, stop, etc.) with optional fields that activate based on the operation, keeping token overhead minimal while maintaining complete functionality.

GitHub stars
3
tools
14
auth
Secret needed
transport
STDIO
env vars
5
last updated
Oct 4, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

dokploy_projectManage projects. list and get return nested environments with their applications, composes, and databases; create, update, remove, and duplicate are also supported.

Manage projects. list and get return nested environments with their applications, composes, and databases; create, update, remove, and duplicate are also supported.

No parameter schema in public metadata yet.

dokploy_applicationFull application lifecycle management, including create, get, update, deploy, start, stop, delete, environment variable handling, logs, and search.

Full application lifecycle management, including create, get, update, deploy, start, stop, delete, environment variable handling, logs, and search.

No parameter schema in public metadata yet.

dokploy_composeDocker Compose management, including create, get, update, delete, deploy, start, stop, environment variable handling, logs, and search.

Docker Compose management, including create, get, update, delete, deploy, start, stop, environment variable handling, logs, and search.

No parameter schema in public metadata yet.

dokploy_databaseUnified database management across postgres, mysql, mariadb, mongo, redis, and libsql, including create, get, update, start, stop, deploy, rebuild, and remove.

Unified database management across postgres, mysql, mariadb, mongo, redis, and libsql, including create, get, update, start, stop, deploy, rebuild, and remove.

No parameter schema in public metadata yet.

dokploy_domainDomain and DNS management, including create, list, get, update, delete, toggleEnable, generate, and validate.

Domain and DNS management, including create, list, get, update, delete, toggleEnable, generate, and validate.

No parameter schema in public metadata yet.

dokploy_redirectsURL redirect rules on an application, expressed as Traefik regex/replacement pairs, with create, update, remove, and get.

URL redirect rules on an application, expressed as Traefik regex/replacement pairs, with create, update, remove, and get.

No parameter schema in public metadata yet.

dokploy_environmentProject environment management, including create, get, list, update, remove, and duplicate.

Project environment management, including create, get, list, update, remove, and duplicate.

No parameter schema in public metadata yet.

dokploy_serverServer management, including list, get, create, update, remove, count, publicIp, getMetrics, and getServices.

Server management, including list, get, create, update, remove, count, publicIp, getMetrics, and getServices.

No parameter schema in public metadata yet.

dokploy_backupBackup scheduling and triggers for database and server backups, including create, get, update, remove, listFiles, and manualBackup.

Backup scheduling and triggers for database and server backups, including create, get, update, remove, listFiles, and manualBackup.

No parameter schema in public metadata yet.

dokploy_volume_backupScheduled volume-level backups taken with rclone, including create, update, remove, get, list, and runManually.

Scheduled volume-level backups taken with rclone, including create, update, remove, get, list, and runManually.

No parameter schema in public metadata yet.

dokploy_deploymentDeployment tracking, including list, queueList, killProcess, readLogs, and remove.

Deployment tracking, including list, queueList, killProcess, readLogs, and remove.

No parameter schema in public metadata yet.

dokploy_preview_deploymentPer-PR and per-branch preview deploys attached to a parent application, with list, get, remove, and redeploy.

Per-PR and per-branch preview deploys attached to a parent application, with list, get, remove, and redeploy.

No parameter schema in public metadata yet.

dokploy_scheduleCron schedules that run commands against applications, compose services, servers, or the Dokploy server, with create, update, remove, get, list, and runManually.

Cron schedules that run commands against applications, compose services, servers, or the Dokploy server, with create, update, remove, get, list, and runManually.

No parameter schema in public metadata yet.

dokploy_dockerDocker daemon management, including container lifecycle, container file operations, events, server health, disk usage, and build cache.

Docker daemon management, including container lifecycle, container file operations, events, server health, disk usage, and build cache.

No parameter schema in public metadata yet.

Sponsors

Configuration

DOKPLOY_URL*

Dokploy instance URL (e.g., https://dokploy.example.com)

DOKPLOY_API_KEY*secret

Dokploy API key (generate in Settings > API Keys)

TRANSPORT_TYPE

Transport: 'stdio' (default) or 'httpStream' for remote/Docker deployments

PORT

HTTP port for httpStream transport (default 3000)

HOST

HTTP host for httpStream transport (default 0.0.0.0)

Readme

dokploy-mcp-server

npm version

A comprehensive Model Context Protocol (MCP) server for Dokploy - the open-source, self-hosted PaaS. Deploy apps, manage containers, databases, domains, and servers through AI assistants like Claude.

Why This Server?

Tracks Dokploy v0.30.8. Tools are built against the v0.30.8 OpenAPI spec (604 paths). The comparison below was measured on 2026-10-03.

The official Dokploy MCP generates one tool per API endpoint. Its latest release, @dokploy/mcp@0.30.7, exposes 604 tools, one for each of the 604 paths in Dokploy's v0.30.8 OpenAPI spec. Coverage is complete, and every one of those schemas loads into the model's context before you ask your first question.

This server hand-curates the same API into 27 tools (one per category, each taking an action enum), covering the deploy-and-operate surface most self-hosters use daily.

Context cost


View the full README on GitHub

Details

Repository
github.com/sapientsai/dokploy-mcp-server
Category
Cloud & Infrastructure
Package
dokploy-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from sapientsai

Related Cloud & Infrastructure MCP servers

View all
1kaiser-data avatarKitsune Mcpkaiser-data/kitsune-mcpHot-reload for MCP servers + mount any community server mid-session, Docker optional. No restarts.3stars
2mswdev avatarBetter Unraid MCPmswdev/better-unraid-mcpMonitor and manage an Unraid server from any MCP client: array, Docker, VMs, ZFS, logs, and UPS.3stars
3yedanyagamiai-cmd avatarOpenClaw MCP Ecosystemyedanyagamiai-cmd/openclaw-mcp-servers9 remote MCP servers on Cloudflare Workers for AI agents. Free tier + Pro API keys.3stars
4xyver avatarDaedalMap CIA World Factbookxyver/daedal-mapCIA World Factbook country indicators: infrastructure, energy, demographics, economy, 2002-2026.2stars
5mlava avatarAgent Readymlava/agent-ready-mcpScan any URL for AI agent readability — Vercel Spec, llmstxt.org, and agent-protocol manifests.2stars
6nogoo9 avatarNo Crdnogoo9/no-crdDynamic pod spawner & proxy for ephemeral AI agent workspaces on Kubernetes without CRDs2stars