vcode-sh avatar

Dokploy MCP

vcode-sh/dokploy-mcp

Connects Claude, Cursor, and Codex to Dokploy's deployment platform through a three-tool interface that keeps your context window clean. Instead of exposing hundreds of endpoint schemas upfront, it gives you search, execute, and list_profiles, then dynamically routes to 524 generated API procedures underneath. That's a 98% reduction in token overhead compared to the classic one-tool-per-endpoint approach. Handles real workflows like compose deploys, log streaming, domain config, and database management. Ships with both local stdio and hosted HTTP transports in the same package. Supports multi-org setups through named profiles with request-scoped credentials. Fork of Dokploy/mcp, rebuilt around the idea that schema tax shouldn't cost you half your prompt budget before you type a word.

GitHub stars
4
tools
3
auth
Secret needed
transport
STDIO, HTTP
env vars
3
last updated
Jul 9, 2026

Tools

3 tools

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

searchdiscover Dokploy procedures and contracts

discover Dokploy procedures and contracts

No parameter schema in public metadata yet.

executerun multi-step workflows in one sandboxed call

run multi-step workflows in one sandboxed call

No parameter schema in public metadata yet.

list_profileslist configured Dokploy profile names and URLs without secrets

list configured Dokploy profile names and URLs without secrets

No parameter schema in public metadata yet.

Sponsors

Configuration

DOKPLOY_URL

Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy panel URL.

DOKPLOY_API_KEYsecret

Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy API key.

DOKPLOY_PROFILES_JSONsecret

Optional JSON object of named Dokploy targets. Use this when you want explicit named profiles in addition to the local default target.

Readme

@vibetools/dokploy-mcp

npm version License: MIT Node >= 24

MCP server for Dokploy that works cleanly with Codex, Cursor, Claude Code, and Claude Desktop.

Three tools up front. Hundreds of Dokploy procedures underneath. Less schema tax, more actual deploys.

Most MCP servers treat your context window like free landfill. This one starts with search, execute, and list_profiles, then earns the rest.

What that buys you:

  • compact default surface instead of hundreds of raw endpoint tools
  • generated, broad Dokploy coverage underneath
  • real workflows for deploys, compose, logs, domains, databases, and profiles
  • local stdio plus hosted HTTP metadata in the same package

Need proof instead of a sales monologue? Start with docs/live-e2e-proof.md.

Current Fact Snapshot


View the full README on GitHub

Details

Repository
github.com/vcode-sh/dokploy-mcp
Website
github.com/vcode-sh/dokploy-mcp
Package
@vibetools/dokploy-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active