# Dokploy Mcp

> 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.

- **Type:** MCP server
- **Install:** `agentstack add mcp-tacticlaunch-dokploy-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tacticlaunch](https://agentstack.voostack.com/s/tacticlaunch)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tacticlaunch](https://github.com/tacticlaunch)
- **Source:** https://github.com/tacticlaunch/dokploy-mcp
- **Website:** https://npmjs.com/dokploy-mcp

## Install

```sh
agentstack add mcp-tacticlaunch-dokploy-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](./TOOLS_STATUS.md) for complete tool breakdown and current status**

## Installation

```bash
npx -y dokploy-mcp
```

## Configuration

Set the following environment variables:

```bash
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:

```json
{
  "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](./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
```bash
# 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
```bash
# 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
```json
{
  "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](./TOOLS_STATUS.md)**.

### Development Mode

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

```typescript
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](./TOOLS_STATUS.md)** - Complete list of all 380 tools with their status
- **[API Coverage](./TOOLS_STATUS.md#api-coverage)** - Detailed breakdown of enabled/disabled tools

## Development

```bash
# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tacticlaunch](https://github.com/tacticlaunch)
- **Source:** [tacticlaunch/dokploy-mcp](https://github.com/tacticlaunch/dokploy-mcp)
- **License:** MIT
- **Homepage:** https://npmjs.com/dokploy-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-tacticlaunch-dokploy-mcp
- Seller: https://agentstack.voostack.com/s/tacticlaunch
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.