Dokploy Mcp
by vcode-shcommunityv3.1.2
4
1
MCP server for Dokploy that exposes a compact default toolset for searching procedures, executing workflows, and listing configured profiles. It can also run in raw or hybrid modes, and supports stdio as well as hosted HTTP metadata/auth flows.
From the registry: Dokploy MCP server for Codex, Cursor, and Claude with compact stdio and hosted HTTP modes
Install & configure
Prerequisites
- required
- optionalGet a Dokploy API keyCreate an API key in Dokploy under Settings > Profile > API/CLI if you plan to authenticate via environment variables.https://dokploy.com
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `dokploy-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 24 or newer** — Node.js 24+ is required to run the package via npx. (https://nodejs.org/)
Optional prerequisites:
- Get a Dokploy API key — Create an API key in Dokploy under Settings > Profile > API/CLI if you plan to authenticate via environment variables. (https://dokploy.com)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["@vibetools/dokploy-mcp"]
- optional environment variables:
- `DOKPLOY_URL`: Base URL for your Dokploy panel. Needed when configuring a default Dokploy target via environment variables. (example: `<your-dokploy-url>`)
- `DOKPLOY_API_KEY`: Dokploy API key for the default Dokploy target. Needed when configuring authentication via environment variables. (example: `<your-dokploy-api-key>`)
- `DOKPLOY_PROFILES_JSON`: JSON string defining one or more named Dokploy profiles with url and apiKey fields. Can be used instead of DOKPLOY_URL and DOKPLOY_API_KEY for multi-organization setups. (example: `<your-dokploy-profiles-json>`)
Note: Preferred install path is stdio via `npx @vibetools/dokploy-mcp`. The README notes that if you are already authenticated with the Dokploy CLI or an existing local dokploy-mcp config, you may not need environment variables at all. The package also supports a hosted HTTP mode (`serve-http`), but the README does not provide a canonical server URL or header configuration, so HTTP config cannot be extracted here.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred install path is stdio via `npx @vibetools/dokploy-mcp`. The README notes that if you are already authenticated with the Dokploy CLI or an existing local dokploy-mcp config, you may not need environment variables at all. The package also supports a hosted HTTP mode (`serve-http`), but the README does not provide a canonical server URL or header configuration, so HTTP config cannot be extracted here.
Tools (3)
search
Discover Dokploy procedures and contracts, with optional profile validation.
execute
Run multi-step Dokploy workflows in one sandboxed call, optionally targeting a named profile.
list_profiles
List configured Dokploy profile names and URLs without exposing secrets.
Environment variables
DOKPLOY_URLrequiredThe Dokploy instance URL used to connect to the panel.DOKPLOY_API_KEYrequiredAPI key for authenticating with Dokploy.DOKPLOY_PROFILES_JSONrequiredJSON string defining multiple named Dokploy profiles with their URLs and API keys.Prerequisites
- • Node >= 24
Packages
@vibetools/dokploy-mcp
npmv3.1.2transport: stdio
Remote Endpoints
https://{remoteHost}{mcpPath}
type: streamable-http
Details
- Language
- TypeScript
- License
- MIT
- Released
- May 15, 2026
- Last commit
- Jun 1, 2026
- Registry name
- io.github.vcode-sh/dokploy-mcp