@vibetools/dokploy-mcp 2.0.0 → 2.0.1

package/dist/codemode/tools/execute.js

@@ -8,7 +8,13 @@ import { resolveSandboxRuntime } from '../sandbox/runtime.js';
 import { runExecuteInSubprocess } from '../sandbox/subprocess-runner.js';
 const executeSchema = z
     .object({
-    code: z.string().min(1).describe('Async JavaScript function to execute a Dokploy workflow'),
+    code: z
+        .string()
+        .min(1)
+        .describe('An async arrow function receiving ({ dokploy, helpers }). ' +
+        'Example: async ({ dokploy }) => { const p = await dokploy.project.all(); return p }. ' +
+        'dokploy.<module>.<method>(params) calls the Dokploy API. ' +
+        'helpers: sleep(ms), assert(cond, msg), pick(obj, keys), limit(arr, n), selectOne(arr, pred).'),
 })
     .strict();
 export function buildExecuteContext(executor, maxCalls = resolveSandboxLimits().maxCalls) {
@@ -42,7 +48,13 @@ export async function runExecuteWithHost(code, host) {
 export const executeTool = createTool({
     name: 'execute',
     title: 'Execute Dokploy Workflow',
-    description: 'Execute a sandboxed Dokploy workflow against the generated Dokploy SDK.',
+    description: 'Execute a sandboxed Dokploy workflow. ' +
+        'The code parameter must be an async arrow function: async ({ dokploy, helpers }) => { ... }. ' +
+        'Use dokploy.<module>.<method>(params) to call any Dokploy API procedure ' +
+        '(e.g. dokploy.application.one({ applicationId }), dokploy.project.all()). ' +
+        'Available modules: project, environment, application, compose, domain, postgres, mysql, mariadb, mongo, redis, ' +
+        'deployment, docker, server, settings, user, notification, backup, mounts, registry, certificates, and more. ' +
+        'Use search tool first to discover exact procedure names and required parameters.',
     schema: executeSchema,
     annotations: { openWorldHint: true },
     handler: async ({ input }) => {

package/dist/codemode/tools/search.js

@@ -6,7 +6,13 @@ import { resolveSandboxRuntime } from '../sandbox/runtime.js';
 import { runSearchInSubprocess } from '../sandbox/subprocess-runner.js';
 const searchSchema = z
     .object({
-    code: z.string().min(1).describe('Async JavaScript function to search the Dokploy API catalog'),
+    code: z
+        .string()
+        .min(1)
+        .describe('An async arrow function receiving ({ catalog }). ' +
+        'Example: async ({ catalog }) => catalog.searchText("application deploy"). ' +
+        'catalog methods: searchText(query), get(procedure), getByTag(tag), ' +
+        'endpoints (array of all procedures), byTag (grouped by module).'),
 })
     .strict();
 const searchCatalog = createSearchCatalogView();
@@ -42,7 +48,12 @@ function trimArrayToBytes(items) {
 export const searchTool = createTool({
     name: 'search',
     title: 'Search Dokploy API',
-    description: 'Search the Dokploy API catalog by executing sandboxed code against a compact API index.',
+    description: 'Search the Dokploy API catalog to discover procedures, parameters, and modules. ' +
+        'The code parameter must be an async arrow function: async ({ catalog }) => { ... }. ' +
+        'Use catalog.searchText("query") to find procedures by keyword, ' +
+        'catalog.getByTag("application") to list all procedures in a module, ' +
+        'catalog.get("application.one") to get details of a specific procedure. ' +
+        'Returns procedure names, required/optional parameters, and HTTP methods.',
     schema: searchSchema,
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     handler: async ({ input }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibetools/dokploy-mcp",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Dokploy MCP server with Code Mode by default",
   "type": "module",
   "exports": {