Dokploy MCP Server
@andradehenrique
About Dokploy MCP Server
Dokploy MCP Server exposes Dokploy functionalities as tools consumable via the Model Context Protocol (MCP)
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"dokploy-mcp": {
"command": "npx",
"args": [
"-y",
"@ahdev/dokploy-mcp"
],
"env": {
"DOKPLOY_URL": "https://your-dokploy-server.com/api",
"DOKPLOY_API_KEY": "your-dokploy-api-token"
}
}
}
}Tools
67Lists all projects in Dokploy with optimized response size suitable for LLM consumption. Returns summary data including project info, environment counts, and service counts per environment. Excludes large fields like env vars and compose files.
Creates a new project in Dokploy.
Duplicates an existing environment in Dokploy with optional service selection. Creates a new environment with the same configuration and optionally the same services.
Gets a specific project by its ID in Dokploy.
Removes/deletes an existing project in Dokploy.
Updates an existing project in Dokploy. Only provide the fields you want to update. System fields like createdAt and organizationId are typically not modified.
Cancels an ongoing deployment for an application in Dokploy.
Cleans the queues for an application in Dokploy.
Creates a new application in Dokploy.
Deletes an application in Dokploy.
Deploys an application in Dokploy.
Disconnects Git provider configuration from an application in Dokploy.
Marks an application as running in Dokploy.
Moves an application to a different environment in Dokploy.
Gets a specific application by its ID in Dokploy.
Reads monitoring data for an application in Dokploy.
Reads Traefik configuration for an application in Dokploy.
Redeploys an application in Dokploy.
Refreshes the token for an application in Dokploy.
Reloads an application in Dokploy.
Saves Bitbucket provider configuration for an application in Dokploy.
Saves build type configuration for an application in Dokploy.
Saves Docker provider configuration for an application in Dokploy.
Saves environment variables for an application in Dokploy.
Saves Git provider configuration for an application in Dokploy.
Saves Gitea provider configuration for an application in Dokploy.
Saves GitHub provider configuration for an application in Dokploy.
Saves GitLab provider configuration for an application in Dokploy.
Starts an application in Dokploy.
Stops an application in Dokploy.
Updates an existing application in Dokploy.
Updates Traefik configuration for an application in Dokploy.
Retrieves all domains associated with a specific application in Dokploy. Returns a list of domain configurations including SSL settings, paths, and routing information.
Retrieves all domains associated with a specific compose stack/service in Dokploy. Returns a list of domain configurations including SSL settings, paths, and routing information.
Checks whether Traefik.me domains can be generated for a specific server in Dokploy.
Creates a new domain configuration in Dokploy. Domains can be configured for applications, compose services, or preview deployments with SSL/TLS certificate options.
Deletes an existing domain configuration in Dokploy by its ID.
Generates a suggested domain for a given application name, optionally scoped to a server.
Retrieves a specific domain configuration by its ID in Dokploy.
Updates an existing domain configuration in Dokploy. Allows modifying domain settings including host, SSL configuration, routing options, and service associations.
Validates if a domain is correctly configured, optionally against a specific server IP.
Changes the status of a MySQL database in Dokploy.
Creates a new MySQL database in Dokploy.
Deploys a MySQL database in Dokploy.
Moves a MySQL database to a different environment in Dokploy.
Gets a specific MySQL database by its ID in Dokploy.
Rebuilds a MySQL database in Dokploy.
Reloads a MySQL database configuration in Dokploy.
Removes a MySQL database from Dokploy.
Saves environment variables for a MySQL database in Dokploy.
Saves external port configuration for a MySQL database in Dokploy.
Starts a MySQL database in Dokploy.
Stops a MySQL database in Dokploy.
Updates a MySQL database configuration in Dokploy.
Changes the status of a PostgreSQL database in Dokploy.
Creates a new PostgreSQL database in Dokploy.
Deploys a PostgreSQL database in Dokploy.
Moves a PostgreSQL database to a different environment in Dokploy.
Gets a specific PostgreSQL database by its ID in Dokploy.
Rebuilds a PostgreSQL database in Dokploy.
Reloads a PostgreSQL database in Dokploy.
Removes/deletes a PostgreSQL database from Dokploy.
Saves environment variables for a PostgreSQL database in Dokploy.
Saves external port configuration for a PostgreSQL database in Dokploy.
Starts a PostgreSQL database in Dokploy.
Stops a PostgreSQL database in Dokploy.
Updates an existing PostgreSQL database in Dokploy.
Overview
What is Dokploy MCP Server?
Dokploy MCP Server exposes Dokploy functionalities as tools consumable via the Model Context Protocol (MCP). It allows MCP-compatible clients (e.g., AI models, other applications) to interact with your Dokploy server programmatically. The server provides 43 tools organized into project, application, and database management. This project is discontinued and has been moved to the official Dokploy organization repository (https://github.com/Dokploy/mcp).
How to use Dokploy MCP Server?
Install using npx -y @ahdev/dokploy-mcp (or with Bun, Deno, or Docker). Set the environment variables DOKPLOY_URL (your Dokploy server API URL) and DOKPLOY_API_KEY (your API token). Configure the server in your MCP client (Cursor, VS Code, Zed, Claude Desktop, etc.) by adding a JSON configuration block specifying the command and environment variables. The server runs in stdio mode by default; use --http or MCP_TRANSPORT=http to enable HTTP mode.
Key features of Dokploy MCP Server
- 43 tools for Dokploy project, application, and database management
- Supports multiple Git providers: GitHub, GitLab, Bitbucket, Gitea, Git, and Docker
- Build type configuration (Dockerfile, Heroku, Nixpacks, etc.)
- Environment variable and build argument management
- Two transport modes: stdio (default) and HTTP (Streamable HTTP + legacy SSE)
- Docker deployment support with both stdio and HTTP modes
Use cases of Dokploy MCP Server
- Manage Dokploy projects and applications through AI-powered chat interfaces
- Automate deployment workflows with lifecycle commands (deploy, stop, reload)
- Duplicate projects with selective service copying
- Configure and update application build settings and environment variables
- Monitor application health and integrate with monitoring tools
FAQ from Dokploy MCP Server
What are the requirements to run Dokploy MCP Server?
Node.js >= v18.0.0 (or Docker), an MCP-compatible client (Cursor, VS Code, Claude Desktop, etc.), and a running Dokploy server instance.
How do I configure Dokploy MCP Server?
Set the environment variables DOKPLOY_URL (your Dokploy server API URL) and DOKPLOY_API_KEY (your API authentication token) in the MCP client configuration file.
What transport modes does Dokploy MCP Server support?
Stdio mode (default) for desktop applications and HTTP mode (Streamable HTTP + legacy SSE) for web applications. The HTTP server listens on port 3000 by default.
Is Dokploy MCP Server still maintained?
No. This repository is discontinued and has been moved to the official Dokploy organization. Please migrate to the new repository at https://github.com/Dokploy/mcp for updates and support.
How can I migrate to the official repository?
Follow the migration guide referenced in the README (MIGRATION.md) and switch to the official repository at https://github.com/Dokploy/mcp.
Frequently asked questions
What are the requirements to run Dokploy MCP Server?
Node.js >= v18.0.0 (or Docker), an MCP-compatible client (Cursor, VS Code, Claude Desktop, etc.), and a running Dokploy server instance.
How do I configure Dokploy MCP Server?
Set the environment variables `DOKPLOY_URL` (your Dokploy server API URL) and `DOKPLOY_API_KEY` (your API authentication token) in the MCP client configuration file.
What transport modes does Dokploy MCP Server support?
Stdio mode (default) for desktop applications and HTTP mode (Streamable HTTP + legacy SSE) for web applications. The HTTP server listens on port 3000 by default.
Is Dokploy MCP Server still maintained?
No. This repository is discontinued and has been moved to the official Dokploy organization. Please migrate to the new repository at https://github.com/Dokploy/mcp for updates and support.
How can I migrate to the official repository?
Follow the migration guide referenced in the README (MIGRATION.md) and switch to the official repository at https://github.com/Dokploy/mcp.
Basic information
More Other MCP servers
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
YOUB
Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov
Codelf
unbugA search tool helps dev to solve the naming things problem.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Comments