Skip to main content

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 (AI models, code editors, and other applications) to interact with your Dokploy server programmatically through a clean and efficient interface.
Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables AI assistants to securely access tools, data sources, and APIs through a unified interface.

What is Dokploy?

Dokploy is a self-hosted platform for deploying and managing applications, databases, and services. It provides a streamlined alternative to complex cloud platforms, allowing you to deploy applications with Git integration, manage databases, configure domains, and more—all from your own infrastructure.

What You Can Do

With Dokploy MCP Server, you can manage your entire Dokploy infrastructure through natural language commands in MCP-compatible clients:
  • Deploy applications from GitHub, GitLab, Bitbucket, Gitea, or custom Git repositories
  • Manage databases including PostgreSQL and MySQL with full lifecycle control
  • Configure domains with automatic SSL/TLS certificates via Let’s Encrypt
  • Control deployments with start, stop, redeploy, and rollback capabilities
  • Monitor applications with real-time metrics and Traefik routing configuration
  • Organize projects to group related applications and databases

Key Features

67 Tools

Comprehensive API coverage across projects, applications, domains, PostgreSQL, and MySQL management

Multiple Transports

Supports both Stdio (default) and HTTP modes with modern Streamable HTTP and legacy SSE protocols

Git Provider Support

Native integrations for GitHub, GitLab, Bitbucket, Gitea, and custom Git servers

Type Safety

Built with TypeScript and Zod for robust schema validation and error handling

Tool Categories

The 67 tools are organized into five main categories:
  • Project Management (6 tools) - Create, update, duplicate, and organize projects
  • Application Management (26 tools) - Full application lifecycle, Git configuration, and monitoring
  • Domain Management (9 tools) - Domain configuration, SSL certificates, and DNS validation
  • PostgreSQL Management (13 tools) - Complete PostgreSQL database operations
  • MySQL Management (13 tools) - Complete MySQL database operations
All tools include semantic annotations (readOnlyHint, destructiveHint, idempotentHint) to help MCP clients understand their behavior and safety characteristics.

What You’ll Learn

This documentation will guide you through:
  1. Installation - Set up Dokploy MCP Server in Cursor, VS Code, Claude Desktop, and other MCP clients
  2. Quickstart - Get up and running with your first commands in minutes
  3. API Reference - Detailed documentation for all 67 tools with schemas and examples

Architecture

Dokploy MCP Server is built on modern, production-ready technologies:
  • @modelcontextprotocol/sdk - Official MCP SDK for TypeScript
  • TypeScript - Full type safety and IDE support
  • Zod - Runtime schema validation for all tool inputs
  • Axios - Robust HTTP client with retry logic
  • Express - HTTP transport server (when using HTTP mode)

Requirements

1

Node.js or Docker

Node.js >= v18.0.0 (for native fetch support) or Docker for containerized deployment
2

MCP Client

Cursor, VS Code, Claude Desktop, Windsurf, Zed, BoltAI, or another MCP-compatible client
3

Dokploy Server

A running Dokploy server instance with API access enabled

Next Steps

Installation

Install Dokploy MCP Server in your preferred MCP client

Quickstart

Deploy your first application in minutes

Build docs developers (and LLMs) love