Dokploy MCP Server

A comprehensive Model Context Protocol (MCP) server for Dokploy, providing type-safe access to the complete Dokploy API with extensive tool coverage across all available endpoints.

Features

• 380 Tools covering 100% of Dokploy API functionality
• Smart tool selection with core tools enabled by default
• Advanced tools available but disabled by default for performance
• Type-safe integration with auto-generated OpenAPI types
• Environment-based authentication
• Modular architecture with each tool in separate files
• Comprehensive error handling for all HTTP status codes
• Production-ready MCP server with optimized tool selection

📋 See TOOLS_STATUS.md for complete tool breakdown and current status

Installation

npx -y dokploy-mcp

Configuration

Set the following environment variables:

export DOKPLOY_URL="https://your-dokploy-instance.com"
export DOKPLOY_API_KEY="your-api-key-here"

Getting Your API Key

You can create an API key in your Dokploy dashboard:

1. Go to Settings → Profile in your Dokploy dashboard
2. Navigate to /dashboard/settings/profile
3. Generate a new API key
4. Copy the key and use it as the DOKPLOY_API_KEY environment variable

Usage with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["-y", "dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-instance.com",
        "DOKPLOY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

For a complete list of all available tools, their descriptions, and current status, see:

📋 TOOLS_STATUS.md - Complete tool reference with status and management instructions

Tool Management

Runtime Tool Control

You can control which tools are enabled/disabled at runtime using command-line arguments or environment variables:

Enable Additional Tools

# Enable specific tools or categories
npx -y dokploy-mcp --enable-tools postgres/,application-cancelDeployment

# Enable multiple categories
npx -y dokploy-mcp --enable-tools postgres/,mysql/,notification/

Disable Specific Tools

# Disable specific tools or categories
XMCP_DISABLE_TOOLS=admin/,application-cancelDeployment npx -y dokploy-mcp

# Disable multiple categories
XMCP_DISABLE_TOOLS=admin/,settings/,stripe/ npx -y dokploy-mcp

Claude Desktop Configuration

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["-y", "dokploy-mcp", "--enable-tools", "postgres/,mysql/"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-instance.com",
        "DOKPLOY_API_KEY": "your-api-key-here",
        "XMCP_DISABLE_TOOLS": "admin/,stripe/"
      }
    }
  }
}

Tool Patterns

• Category patterns: postgres/, mysql/, notification/ - enables/disables entire categories
• Specific tools: application-cancelDeployment, server-create - enables/disables individual tools
• Multiple patterns: Separate with commas: postgres/,mysql/,application-cancelDeployment

Tool Categories

For detailed information about tool categories and their current status, see TOOLS_STATUS.md.

Development Mode

To enable additional tools permanently, modify the disabled property in each tool's metadata:

export const metadata: ToolMetadata = {
  name: 'tool-name',
  description: 'Tool description',
  annotations: {
    title: 'Tool Title',
    destructiveHint: false,
    idempotentHint: true,
  },
  disabled: false, // Set to false to enable, true to disable
}

Documentation

• TOOLS_STATUS.md - Complete list of all 380 tools with their status
• API Coverage - Detailed breakdown of enabled/disabled tools

Development

# Install dependencies
pnpm install

# Build the project (automatically updates TOOLS_STATUS.md)
pnpm build

# Update tools status manually
pnpm run update-tools-status

# Run in development
pnpm dev

License

MIT