v3.0.0: Dokploy MCP, minus the schema hostage situation

Dokploy MCP v3 is out.

The default public surface stays compact:

• search
• execute

Under that, v3 is now live-tested across real Dokploy workflows:

• Docker apps
• Git-backed builds
• raw Compose
• Postgres 18
• domains and logs
• hosted HTTP

Highlights:

• compact Code Mode by default
• optional raw and hybrid modes
• improved Compose deploy guardrails
• stronger secret redaction
• more resilient project log aggregation
• setup wizard and docs rebuilt for actual humans

Current default tools/list footprint:

• about 1,485 tokens
• about 98.4% smaller than the classic endpoint-per-tool schema dump

Tiny surface. Real work. Finally.

Full Changelog: v2.2.1...v3.0.0

v2.2.1

Security: Git provider secret redaction

Git provider credentials (GitHub App private keys, client secrets, webhook secrets, Gitea/GitLab/Bitbucket tokens) are now automatically redacted from all MCP tool responses. Your AI agent sees [REDACTED] instead of raw secret values.

Affected procedures

application.one, application.many, github.one, gitea.one, gitlab.one, bitbucket.one, github.githubProviders, gitProvider.getAll

Escape hatch

Pass includeSecrets: true when you genuinely need the raw values:

await dokploy.application.one({ applicationId: "id", includeSecrets: true })
await dokploy.github.one({ githubId: "id", includeSecrets: true })

Redacted fields

githubClientSecret, githubPrivateKey, githubWebhookSecret, clientSecret, accessToken, refreshToken, secret, appPassword, apiToken, privateKey, privateKeyPass

Full Changelog: v2.2.0...v2.2.1

v2.2.0

Full Changelog: v2.1.1...v2.2.0

v2.1.1

Full Changelog: v2.1.0...v2.1.1

v2.1.0

Full Changelog: v2.0.1...v2.1.0

v2.0.1

Full Changelog: v2.0.0...v2.0.1

v2.0.0

Full Changelog: v1.2.0...v2.0.0

v1.2.0

Full Changelog: v1.0.0...v1.2.0

v1.0.0

v1.0.0

The one where it stops being a beta.

Forked from Dokploy/mcp, rebuilt from the ground up. 196 tools across 23 modules. Your AI agent can now deploy apps, manage databases, configure domains, and handle backups -- without you touching a dashboard.

What's in the box

• 196 tools, 23 modules -- applications, compose, databases (Postgres/MySQL/MariaDB/MongoDB/Redis), domains, backups, Docker, settings, and more
• Tool annotations -- readOnlyHint, destructiveHint, idempotentHint so clients can warn before you nuke something
• Type-safe schemas -- Zod v4 validation on every parameter
• Lazy config loading -- validates credentials on first API call, not at startup
• Three config sources -- env vars > config file > Dokploy CLI (first match wins)
• Setup wizard -- npx @vibetools/dokploy-mcp setup

v1.0.0 highlights

Architecture overhaul

• Database tool factory -- 5 nearly-identical database modules (postgres, mysql, mariadb, mongo, redis) consolidated into a single factory. ~900 lines of duplication eliminated. Adding a new database type is now 15 lines of config.
• Fixed annotations bug -- openWorldHint default was being double-applied in postTool and getTool, causing override issues. Defaults now flow through createTool once.
• Error mapping cleanup -- mapApiError switch replaced with a lookup table.

Config & API client

• Zod-ified config validation -- manual type guards in readConfigFile() and readDokployCliConfig() replaced with Zod schemas. 40 lines → 6 lines.
• API client cleanup -- simplified query string builder, standardized timeouts, documented the abort error dual-check.

Test suite (new)

• Vitest 4.0.18 -- 55 tests across 6 files
• Coverage reporting with @vitest/coverage-v8 -- shown in CI step summaries, not enforced (network-dependent code doesn't fake well)
• Tests cover: tool factory, database factory, config resolution, API errors, tool registration integrity (196 tools, unique names, correct annotations)

CI/CD

• GitHub Actions upgraded -- checkout v6, setup-node v6, upload-artifact v6, download-artifact v7
• Test job added to CI, PR validation, and release workflows
• Coverage reports in GitHub step summaries on every PR
• Dependabot configured for weekly npm + Actions updates
• PR template with test plan checklist

Housekeeping

• Apache 2.0 attribution -- LICENSE-ORIGINAL preserves the original copyright from Dokploy/mcp
• Fork attribution in README with contributor credits

Quick start

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["@vibetools/dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://panel.example.com",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

Works with Claude Desktop, Claude Code, Cursor, VS Code, and anything that speaks MCP.

---

Standing on the shoulders of Mauricio Siu (Dokploy creator) and Henrique Andrade (original MCP author). Full credits in README.

Full Changelog: v0.5.0...v1.0.0

v0.5.0

Full Changelog: v0.4.0...v0.5.0