@payloadcms/plugin-mcp 3.72.0-canary.1 → 3.72.0-canary.3

package/dist/mcp/getMcpHandler.js

@@ -31,7 +31,7 @@ import { runJobTool } from './tools/job/run.js';
 import { updateJobTool } from './tools/job/update.js';
 export const getMCPHandler = (pluginOptions, mcpAccessSettings, req)=>{
     const { payload } = req;
-    const configSchema = configToJSONSchema(payload.config);
+    const configSchema = configToJSONSchema(payload.config, payload.db.defaultIDType, req.i18n);
     // Handler wrapper that injects req before the _extra argument
     const wrapHandler = (handler)=>{
         return async (...args)=>{

package/dist/mcp/getMcpHandler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/getMcpHandler.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { createMcpHandler } from '@vercel/mcp-adapter'\nimport { join } from 'path'\nimport { APIError, configToJSONSchema, type PayloadRequest, type TypedUser } from 'payload'\n\nimport type { MCPAccessSettings, PluginMCPServerConfig } from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\nimport { getEnabledSlugs } from '../utils/getEnabledSlugs.js'\nimport { registerTool } from './registerTool.js'\n\n// Tools\nimport { findGlobalTool } from './tools/global/find.js'\nimport { updateGlobalTool } from './tools/global/update.js'\nimport { createResourceTool } from './tools/resource/create.js'\nimport { deleteResourceTool } from './tools/resource/delete.js'\nimport { findResourceTool } from './tools/resource/find.js'\nimport { updateResourceTool } from './tools/resource/update.js'\n\n// Experimental Tools\n/**\n * @experimental This tools are experimental and may change or be removed in the future.\n */\nimport { authTool } from './tools/auth/auth.js'\nimport { forgotPasswordTool } from './tools/auth/forgotPassword.js'\nimport { loginTool } from './tools/auth/login.js'\nimport { resetPasswordTool } from './tools/auth/resetPassword.js'\nimport { unlockTool } from './tools/auth/unlock.js'\nimport { verifyTool } from './tools/auth/verify.js'\nimport { createCollectionTool } from './tools/collection/create.js'\nimport { deleteCollectionTool } from './tools/collection/delete.js'\nimport { findCollectionTool } from './tools/collection/find.js'\nimport { updateCollectionTool } from './tools/collection/update.js'\nimport { findConfigTool } from './tools/config/find.js'\nimport { updateConfigTool } from './tools/config/update.js'\nimport { createJobTool } from './tools/job/create.js'\nimport { runJobTool } from './tools/job/run.js'\nimport { updateJobTool } from './tools/job/update.js'\n\nexport const getMCPHandler = (\n  pluginOptions: PluginMCPServerConfig,\n  mcpAccessSettings: MCPAccessSettings,\n  req: PayloadRequest,\n) => {\n  const { payload } = req\n  const configSchema = configToJSONSchema(payload.config)\n\n  // Handler wrapper that injects req before the _extra argument\n  const wrapHandler = (handler: (...args: any[]) => any) => {\n    return async (...args: any[]) => {\n      const _extra = args[args.length - 1]\n      const handlerArgs = args.slice(0, -1)\n      return await handler(...handlerArgs, req, _extra)\n    }\n  }\n\n  const payloadToolHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['tools']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  const payloadPromptHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['prompts']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  const payloadResourceHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['resources']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  // User\n  const user = mcpAccessSettings.user\n\n  // MCP Server and Handler Options\n  const MCPOptions = pluginOptions.mcp || {}\n  const customMCPTools = MCPOptions.tools || []\n  const customMCPPrompts = MCPOptions.prompts || []\n  const customMCPResources = MCPOptions.resources || []\n  const MCPHandlerOptions = MCPOptions.handlerOptions || {}\n  const serverOptions = MCPOptions.serverOptions || {}\n  const useVerboseLogs = MCPHandlerOptions.verboseLogs ?? false\n\n  // Experimental MCP Tool Requirements\n  const isDevelopment = process.env.NODE_ENV === 'development'\n  const experimentalTools: NonNullable<PluginMCPServerConfig['experimental']>['tools'] =\n    pluginOptions?.experimental?.tools || {}\n  const collectionsPluginConfig = pluginOptions.collections || {}\n  const globalsPluginConfig = pluginOptions.globals || {}\n  const collectionsDirPath =\n    experimentalTools && experimentalTools.collections?.collectionsDirPath\n      ? experimentalTools.collections.collectionsDirPath\n      : join(process.cwd(), 'src/collections')\n  const configFilePath =\n    experimentalTools && experimentalTools.config?.configFilePath\n      ? experimentalTools.config.configFilePath\n      : join(process.cwd(), 'src/payload.config.ts')\n  const jobsDirPath =\n    experimentalTools && experimentalTools.jobs?.jobsDirPath\n      ? experimentalTools.jobs.jobsDirPath\n      : join(process.cwd(), 'src/jobs')\n\n  try {\n    return createMcpHandler(\n      (server) => {\n        // Get enabled collections\n        const enabledCollectionSlugs = getEnabledSlugs(collectionsPluginConfig, 'collection')\n\n        // Collection Operation Tools\n        enabledCollectionSlugs.forEach((enabledCollectionSlug) => {\n          try {\n            const schema = configSchema.definitions?.[enabledCollectionSlug] as JSONSchema4\n\n            const toolCapabilities = mcpAccessSettings?.[\n              `${toCamelCase(enabledCollectionSlug)}`\n            ] as Record<string, unknown>\n            const allowCreate: boolean | undefined = toolCapabilities?.create as boolean\n            const allowUpdate: boolean | undefined = toolCapabilities?.update as boolean\n            const allowFind: boolean | undefined = toolCapabilities?.find as boolean\n            const allowDelete: boolean | undefined = toolCapabilities?.delete as boolean\n\n            if (allowCreate) {\n              registerTool(\n                allowCreate,\n                `Create ${enabledCollectionSlug}`,\n                () =>\n                  createResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowUpdate) {\n              registerTool(\n                allowUpdate,\n                `Update ${enabledCollectionSlug}`,\n                () =>\n                  updateResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowFind) {\n              registerTool(\n                allowFind,\n                `Find ${enabledCollectionSlug}`,\n                () =>\n                  findResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowDelete) {\n              registerTool(\n                allowDelete,\n                `Delete ${enabledCollectionSlug}`,\n                () =>\n                  deleteResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n          } catch (error) {\n            throw new APIError(\n              `Error registering tools for collection ${enabledCollectionSlug}: ${String(error)}`,\n              500,\n            )\n          }\n        })\n\n        // Global Operation Tools\n        const enabledGlobalSlugs = getEnabledSlugs(globalsPluginConfig, 'global')\n\n        enabledGlobalSlugs.forEach((enabledGlobalSlug) => {\n          try {\n            const schema = configSchema.definitions?.[enabledGlobalSlug] as JSONSchema4\n\n            const toolCapabilities = mcpAccessSettings?.[\n              `${toCamelCase(enabledGlobalSlug)}`\n            ] as Record<string, unknown>\n            const allowFind: boolean | undefined = toolCapabilities?.['find'] as boolean\n            const allowUpdate: boolean | undefined = toolCapabilities?.['update'] as boolean\n\n            if (allowFind) {\n              registerTool(\n                allowFind,\n                `Find ${enabledGlobalSlug}`,\n                () =>\n                  findGlobalTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledGlobalSlug,\n                    globalsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowUpdate) {\n              registerTool(\n                allowUpdate,\n                `Update ${enabledGlobalSlug}`,\n                () =>\n                  updateGlobalTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledGlobalSlug,\n                    globalsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n          } catch (error) {\n            throw new APIError(\n              `Error registering tools for global ${enabledGlobalSlug}: ${String(error)}`,\n              500,\n            )\n          }\n        })\n\n        // Custom tools\n        customMCPTools.forEach((tool) => {\n          const camelCasedToolName = toCamelCase(tool.name)\n          const isToolEnabled = mcpAccessSettings['payload-mcp-tool']?.[camelCasedToolName] ?? false\n\n          registerTool(\n            isToolEnabled,\n            tool.name,\n            () =>\n              server.tool(\n                tool.name,\n                tool.description,\n                tool.parameters,\n                payloadToolHandler(tool.handler),\n              ),\n            payload,\n            useVerboseLogs,\n          )\n        })\n\n        // Custom prompts\n        customMCPPrompts.forEach((prompt) => {\n          const camelCasedPromptName = toCamelCase(prompt.name)\n          const isPromptEnabled =\n            mcpAccessSettings['payload-mcp-prompt']?.[camelCasedPromptName] ?? false\n\n          if (isPromptEnabled) {\n            server.registerPrompt(\n              prompt.name,\n              {\n                argsSchema: prompt.argsSchema,\n                description: prompt.description,\n                title: prompt.title,\n              },\n              payloadPromptHandler(prompt.handler),\n            )\n            if (useVerboseLogs) {\n              payload.logger.info(`[payload-mcp] ✅ Prompt: ${prompt.title} Registered.`)\n            }\n          } else if (useVerboseLogs) {\n            payload.logger.info(`[payload-mcp] ⏭️ Prompt: ${prompt.title} Skipped.`)\n          }\n        })\n\n        // Custom resources\n        customMCPResources.forEach((resource) => {\n          const camelCasedResourceName = toCamelCase(resource.name)\n          const isResourceEnabled =\n            mcpAccessSettings['payload-mcp-resource']?.[camelCasedResourceName] ?? false\n\n          if (isResourceEnabled) {\n            server.registerResource(\n              resource.name,\n              // @ts-expect-error - Overload type is not working however -- ResourceTemplate OR String is a valid type\n              resource.uri,\n              {\n                description: resource.description,\n                mimeType: resource.mimeType,\n                title: resource.title,\n              },\n              payloadResourceHandler(resource.handler),\n            )\n\n            if (useVerboseLogs) {\n              payload.logger.info(`[payload-mcp] ✅ Resource: ${resource.title} Registered.`)\n            }\n          } else if (useVerboseLogs) {\n            payload.logger.info(`[payload-mcp] ⏭️ Resource: ${resource.title} Skipped.`)\n          }\n        })\n\n        // Experimental - Collection Schema Modfication Tools\n        if (\n          mcpAccessSettings.collections?.create &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.create,\n            'Create Collection',\n            () =>\n              createCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n        if (\n          mcpAccessSettings.collections?.delete &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.delete,\n            'Delete Collection',\n            () =>\n              deleteCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.collections?.find &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.find,\n            'Find Collection',\n            () => findCollectionTool(server, req, useVerboseLogs, collectionsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.collections?.update &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.update,\n            'Update Collection',\n            () =>\n              updateCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Payload Config Modification Tools\n        if (mcpAccessSettings.config?.find && experimentalTools.config?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.config.find,\n            'Find Config',\n            () => findConfigTool(server, req, useVerboseLogs, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.config?.update &&\n          experimentalTools.config?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.config.update,\n            'Update Config',\n            () => updateConfigTool(server, req, useVerboseLogs, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Job Modification Tools\n        if (mcpAccessSettings.jobs?.create && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.create,\n            'Create Job',\n            () => createJobTool(server, req, useVerboseLogs, jobsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.jobs?.update && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.update,\n            'Update Job',\n            () => updateJobTool(server, req, useVerboseLogs, jobsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.jobs?.run && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.run,\n            'Run Job',\n            () => runJobTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Auth Modification Tools\n        if (mcpAccessSettings.auth?.auth && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.auth,\n            'Auth',\n            () => authTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.login && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.login,\n            'Login',\n            () => loginTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.verify && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.verify,\n            'Verify',\n            () => verifyTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.resetPassword && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.resetPassword,\n            'Reset Password',\n            () => resetPasswordTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.forgotPassword && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.forgotPassword,\n            'Forgot Password',\n            () => forgotPasswordTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.unlock && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.unlock,\n            'Unlock',\n            () => unlockTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (useVerboseLogs) {\n          payload.logger.info('[payload-mcp] 🚀 MCP Server Ready.')\n        }\n      },\n      {\n        serverInfo: serverOptions.serverInfo,\n      },\n      {\n        basePath: MCPHandlerOptions.basePath || '/api',\n        maxDuration: MCPHandlerOptions.maxDuration || 60,\n        // INFO: Disabled until developer clarity is reached for server side streaming and we have an auth pattern for all SSE patterns\n        // redisUrl: MCPHandlerOptions.redisUrl || process.env.REDIS_URL,\n        verboseLogs: useVerboseLogs,\n      },\n    )\n  } catch (error) {\n    throw new APIError(`Error initializing MCP handler: ${String(error)}`, 500)\n  }\n}\n"],"names":["createMcpHandler","join","APIError","configToJSONSchema","toCamelCase","getEnabledSlugs","registerTool","findGlobalTool","updateGlobalTool","createResourceTool","deleteResourceTool","findResourceTool","updateResourceTool","authTool","forgotPasswordTool","loginTool","resetPasswordTool","unlockTool","verifyTool","createCollectionTool","deleteCollectionTool","findCollectionTool","updateCollectionTool","findConfigTool","updateConfigTool","createJobTool","runJobTool","updateJobTool","getMCPHandler","pluginOptions","mcpAccessSettings","req","payload","configSchema","config","wrapHandler","handler","args","_extra","length","handlerArgs","slice","payloadToolHandler","payloadPromptHandler","payloadResourceHandler","user","MCPOptions","mcp","customMCPTools","tools","customMCPPrompts","prompts","customMCPResources","resources","MCPHandlerOptions","handlerOptions","serverOptions","useVerboseLogs","verboseLogs","isDevelopment","process","env","NODE_ENV","experimentalTools","experimental","collectionsPluginConfig","collections","globalsPluginConfig","globals","collectionsDirPath","cwd","configFilePath","jobsDirPath","jobs","server","enabledCollectionSlugs","forEach","enabledCollectionSlug","schema","definitions","toolCapabilities","allowCreate","create","allowUpdate","update","allowFind","find","allowDelete","delete","error","String","enabledGlobalSlugs","enabledGlobalSlug","tool","camelCasedToolName","name","isToolEnabled","description","parameters","prompt","camelCasedPromptName","isPromptEnabled","registerPrompt","argsSchema","title","logger","info","resource","camelCasedResourceName","isResourceEnabled","registerResource","uri","mimeType","enabled","run","auth","login","verify","resetPassword","forgotPassword","unlock","serverInfo","basePath","maxDuration"],"mappings":"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"}
+{"version":3,"sources":["../../src/mcp/getMcpHandler.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { createMcpHandler } from '@vercel/mcp-adapter'\nimport { join } from 'path'\nimport { APIError, configToJSONSchema, type PayloadRequest, type TypedUser } from 'payload'\n\nimport type { MCPAccessSettings, PluginMCPServerConfig } from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\nimport { getEnabledSlugs } from '../utils/getEnabledSlugs.js'\nimport { registerTool } from './registerTool.js'\n\n// Tools\nimport { findGlobalTool } from './tools/global/find.js'\nimport { updateGlobalTool } from './tools/global/update.js'\nimport { createResourceTool } from './tools/resource/create.js'\nimport { deleteResourceTool } from './tools/resource/delete.js'\nimport { findResourceTool } from './tools/resource/find.js'\nimport { updateResourceTool } from './tools/resource/update.js'\n\n// Experimental Tools\n/**\n * @experimental This tools are experimental and may change or be removed in the future.\n */\nimport { authTool } from './tools/auth/auth.js'\nimport { forgotPasswordTool } from './tools/auth/forgotPassword.js'\nimport { loginTool } from './tools/auth/login.js'\nimport { resetPasswordTool } from './tools/auth/resetPassword.js'\nimport { unlockTool } from './tools/auth/unlock.js'\nimport { verifyTool } from './tools/auth/verify.js'\nimport { createCollectionTool } from './tools/collection/create.js'\nimport { deleteCollectionTool } from './tools/collection/delete.js'\nimport { findCollectionTool } from './tools/collection/find.js'\nimport { updateCollectionTool } from './tools/collection/update.js'\nimport { findConfigTool } from './tools/config/find.js'\nimport { updateConfigTool } from './tools/config/update.js'\nimport { createJobTool } from './tools/job/create.js'\nimport { runJobTool } from './tools/job/run.js'\nimport { updateJobTool } from './tools/job/update.js'\n\nexport const getMCPHandler = (\n  pluginOptions: PluginMCPServerConfig,\n  mcpAccessSettings: MCPAccessSettings,\n  req: PayloadRequest,\n) => {\n  const { payload } = req\n  const configSchema = configToJSONSchema(payload.config, payload.db.defaultIDType, req.i18n)\n\n  // Handler wrapper that injects req before the _extra argument\n  const wrapHandler = (handler: (...args: any[]) => any) => {\n    return async (...args: any[]) => {\n      const _extra = args[args.length - 1]\n      const handlerArgs = args.slice(0, -1)\n      return await handler(...handlerArgs, req, _extra)\n    }\n  }\n\n  const payloadToolHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['tools']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  const payloadPromptHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['prompts']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  const payloadResourceHandler = (\n    handler: NonNullable<NonNullable<PluginMCPServerConfig['mcp']>['resources']>[number]['handler'],\n  ) => wrapHandler(handler)\n\n  // User\n  const user = mcpAccessSettings.user\n\n  // MCP Server and Handler Options\n  const MCPOptions = pluginOptions.mcp || {}\n  const customMCPTools = MCPOptions.tools || []\n  const customMCPPrompts = MCPOptions.prompts || []\n  const customMCPResources = MCPOptions.resources || []\n  const MCPHandlerOptions = MCPOptions.handlerOptions || {}\n  const serverOptions = MCPOptions.serverOptions || {}\n  const useVerboseLogs = MCPHandlerOptions.verboseLogs ?? false\n\n  // Experimental MCP Tool Requirements\n  const isDevelopment = process.env.NODE_ENV === 'development'\n  const experimentalTools: NonNullable<PluginMCPServerConfig['experimental']>['tools'] =\n    pluginOptions?.experimental?.tools || {}\n  const collectionsPluginConfig = pluginOptions.collections || {}\n  const globalsPluginConfig = pluginOptions.globals || {}\n  const collectionsDirPath =\n    experimentalTools && experimentalTools.collections?.collectionsDirPath\n      ? experimentalTools.collections.collectionsDirPath\n      : join(process.cwd(), 'src/collections')\n  const configFilePath =\n    experimentalTools && experimentalTools.config?.configFilePath\n      ? experimentalTools.config.configFilePath\n      : join(process.cwd(), 'src/payload.config.ts')\n  const jobsDirPath =\n    experimentalTools && experimentalTools.jobs?.jobsDirPath\n      ? experimentalTools.jobs.jobsDirPath\n      : join(process.cwd(), 'src/jobs')\n\n  try {\n    return createMcpHandler(\n      (server) => {\n        // Get enabled collections\n        const enabledCollectionSlugs = getEnabledSlugs(collectionsPluginConfig, 'collection')\n\n        // Collection Operation Tools\n        enabledCollectionSlugs.forEach((enabledCollectionSlug) => {\n          try {\n            const schema = configSchema.definitions?.[enabledCollectionSlug] as JSONSchema4\n\n            const toolCapabilities = mcpAccessSettings?.[\n              `${toCamelCase(enabledCollectionSlug)}`\n            ] as Record<string, unknown>\n            const allowCreate: boolean | undefined = toolCapabilities?.create as boolean\n            const allowUpdate: boolean | undefined = toolCapabilities?.update as boolean\n            const allowFind: boolean | undefined = toolCapabilities?.find as boolean\n            const allowDelete: boolean | undefined = toolCapabilities?.delete as boolean\n\n            if (allowCreate) {\n              registerTool(\n                allowCreate,\n                `Create ${enabledCollectionSlug}`,\n                () =>\n                  createResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowUpdate) {\n              registerTool(\n                allowUpdate,\n                `Update ${enabledCollectionSlug}`,\n                () =>\n                  updateResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowFind) {\n              registerTool(\n                allowFind,\n                `Find ${enabledCollectionSlug}`,\n                () =>\n                  findResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowDelete) {\n              registerTool(\n                allowDelete,\n                `Delete ${enabledCollectionSlug}`,\n                () =>\n                  deleteResourceTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledCollectionSlug,\n                    collectionsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n          } catch (error) {\n            throw new APIError(\n              `Error registering tools for collection ${enabledCollectionSlug}: ${String(error)}`,\n              500,\n            )\n          }\n        })\n\n        // Global Operation Tools\n        const enabledGlobalSlugs = getEnabledSlugs(globalsPluginConfig, 'global')\n\n        enabledGlobalSlugs.forEach((enabledGlobalSlug) => {\n          try {\n            const schema = configSchema.definitions?.[enabledGlobalSlug] as JSONSchema4\n\n            const toolCapabilities = mcpAccessSettings?.[\n              `${toCamelCase(enabledGlobalSlug)}`\n            ] as Record<string, unknown>\n            const allowFind: boolean | undefined = toolCapabilities?.['find'] as boolean\n            const allowUpdate: boolean | undefined = toolCapabilities?.['update'] as boolean\n\n            if (allowFind) {\n              registerTool(\n                allowFind,\n                `Find ${enabledGlobalSlug}`,\n                () =>\n                  findGlobalTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledGlobalSlug,\n                    globalsPluginConfig,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n            if (allowUpdate) {\n              registerTool(\n                allowUpdate,\n                `Update ${enabledGlobalSlug}`,\n                () =>\n                  updateGlobalTool(\n                    server,\n                    req,\n                    user,\n                    useVerboseLogs,\n                    enabledGlobalSlug,\n                    globalsPluginConfig,\n                    schema,\n                  ),\n                payload,\n                useVerboseLogs,\n              )\n            }\n          } catch (error) {\n            throw new APIError(\n              `Error registering tools for global ${enabledGlobalSlug}: ${String(error)}`,\n              500,\n            )\n          }\n        })\n\n        // Custom tools\n        customMCPTools.forEach((tool) => {\n          const camelCasedToolName = toCamelCase(tool.name)\n          const isToolEnabled = mcpAccessSettings['payload-mcp-tool']?.[camelCasedToolName] ?? false\n\n          registerTool(\n            isToolEnabled,\n            tool.name,\n            () =>\n              server.tool(\n                tool.name,\n                tool.description,\n                tool.parameters,\n                payloadToolHandler(tool.handler),\n              ),\n            payload,\n            useVerboseLogs,\n          )\n        })\n\n        // Custom prompts\n        customMCPPrompts.forEach((prompt) => {\n          const camelCasedPromptName = toCamelCase(prompt.name)\n          const isPromptEnabled =\n            mcpAccessSettings['payload-mcp-prompt']?.[camelCasedPromptName] ?? false\n\n          if (isPromptEnabled) {\n            server.registerPrompt(\n              prompt.name,\n              {\n                argsSchema: prompt.argsSchema,\n                description: prompt.description,\n                title: prompt.title,\n              },\n              payloadPromptHandler(prompt.handler),\n            )\n            if (useVerboseLogs) {\n              payload.logger.info(`[payload-mcp] ✅ Prompt: ${prompt.title} Registered.`)\n            }\n          } else if (useVerboseLogs) {\n            payload.logger.info(`[payload-mcp] ⏭️ Prompt: ${prompt.title} Skipped.`)\n          }\n        })\n\n        // Custom resources\n        customMCPResources.forEach((resource) => {\n          const camelCasedResourceName = toCamelCase(resource.name)\n          const isResourceEnabled =\n            mcpAccessSettings['payload-mcp-resource']?.[camelCasedResourceName] ?? false\n\n          if (isResourceEnabled) {\n            server.registerResource(\n              resource.name,\n              // @ts-expect-error - Overload type is not working however -- ResourceTemplate OR String is a valid type\n              resource.uri,\n              {\n                description: resource.description,\n                mimeType: resource.mimeType,\n                title: resource.title,\n              },\n              payloadResourceHandler(resource.handler),\n            )\n\n            if (useVerboseLogs) {\n              payload.logger.info(`[payload-mcp] ✅ Resource: ${resource.title} Registered.`)\n            }\n          } else if (useVerboseLogs) {\n            payload.logger.info(`[payload-mcp] ⏭️ Resource: ${resource.title} Skipped.`)\n          }\n        })\n\n        // Experimental - Collection Schema Modfication Tools\n        if (\n          mcpAccessSettings.collections?.create &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.create,\n            'Create Collection',\n            () =>\n              createCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n        if (\n          mcpAccessSettings.collections?.delete &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.delete,\n            'Delete Collection',\n            () =>\n              deleteCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.collections?.find &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.find,\n            'Find Collection',\n            () => findCollectionTool(server, req, useVerboseLogs, collectionsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.collections?.update &&\n          experimentalTools.collections?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.collections.update,\n            'Update Collection',\n            () =>\n              updateCollectionTool(server, req, useVerboseLogs, collectionsDirPath, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Payload Config Modification Tools\n        if (mcpAccessSettings.config?.find && experimentalTools.config?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.config.find,\n            'Find Config',\n            () => findConfigTool(server, req, useVerboseLogs, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (\n          mcpAccessSettings.config?.update &&\n          experimentalTools.config?.enabled &&\n          isDevelopment\n        ) {\n          registerTool(\n            mcpAccessSettings.config.update,\n            'Update Config',\n            () => updateConfigTool(server, req, useVerboseLogs, configFilePath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Job Modification Tools\n        if (mcpAccessSettings.jobs?.create && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.create,\n            'Create Job',\n            () => createJobTool(server, req, useVerboseLogs, jobsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.jobs?.update && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.update,\n            'Update Job',\n            () => updateJobTool(server, req, useVerboseLogs, jobsDirPath),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.jobs?.run && experimentalTools.jobs?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.jobs.run,\n            'Run Job',\n            () => runJobTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        // Experimental - Auth Modification Tools\n        if (mcpAccessSettings.auth?.auth && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.auth,\n            'Auth',\n            () => authTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.login && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.login,\n            'Login',\n            () => loginTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.verify && experimentalTools.auth?.enabled && isDevelopment) {\n          registerTool(\n            mcpAccessSettings.auth.verify,\n            'Verify',\n            () => verifyTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.resetPassword && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.resetPassword,\n            'Reset Password',\n            () => resetPasswordTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.forgotPassword && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.forgotPassword,\n            'Forgot Password',\n            () => forgotPasswordTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (mcpAccessSettings.auth?.unlock && experimentalTools.auth?.enabled) {\n          registerTool(\n            mcpAccessSettings.auth.unlock,\n            'Unlock',\n            () => unlockTool(server, req, useVerboseLogs),\n            payload,\n            useVerboseLogs,\n          )\n        }\n\n        if (useVerboseLogs) {\n          payload.logger.info('[payload-mcp] 🚀 MCP Server Ready.')\n        }\n      },\n      {\n        serverInfo: serverOptions.serverInfo,\n      },\n      {\n        basePath: MCPHandlerOptions.basePath || '/api',\n        maxDuration: MCPHandlerOptions.maxDuration || 60,\n        // INFO: Disabled until developer clarity is reached for server side streaming and we have an auth pattern for all SSE patterns\n        // redisUrl: MCPHandlerOptions.redisUrl || process.env.REDIS_URL,\n        verboseLogs: useVerboseLogs,\n      },\n    )\n  } catch (error) {\n    throw new APIError(`Error initializing MCP handler: ${String(error)}`, 500)\n  }\n}\n"],"names":["createMcpHandler","join","APIError","configToJSONSchema","toCamelCase","getEnabledSlugs","registerTool","findGlobalTool","updateGlobalTool","createResourceTool","deleteResourceTool","findResourceTool","updateResourceTool","authTool","forgotPasswordTool","loginTool","resetPasswordTool","unlockTool","verifyTool","createCollectionTool","deleteCollectionTool","findCollectionTool","updateCollectionTool","findConfigTool","updateConfigTool","createJobTool","runJobTool","updateJobTool","getMCPHandler","pluginOptions","mcpAccessSettings","req","payload","configSchema","config","db","defaultIDType","i18n","wrapHandler","handler","args","_extra","length","handlerArgs","slice","payloadToolHandler","payloadPromptHandler","payloadResourceHandler","user","MCPOptions","mcp","customMCPTools","tools","customMCPPrompts","prompts","customMCPResources","resources","MCPHandlerOptions","handlerOptions","serverOptions","useVerboseLogs","verboseLogs","isDevelopment","process","env","NODE_ENV","experimentalTools","experimental","collectionsPluginConfig","collections","globalsPluginConfig","globals","collectionsDirPath","cwd","configFilePath","jobsDirPath","jobs","server","enabledCollectionSlugs","forEach","enabledCollectionSlug","schema","definitions","toolCapabilities","allowCreate","create","allowUpdate","update","allowFind","find","allowDelete","delete","error","String","enabledGlobalSlugs","enabledGlobalSlug","tool","camelCasedToolName","name","isToolEnabled","description","parameters","prompt","camelCasedPromptName","isPromptEnabled","registerPrompt","argsSchema","title","logger","info","resource","camelCasedResourceName","isResourceEnabled","registerResource","uri","mimeType","enabled","run","auth","login","verify","resetPassword","forgotPassword","unlock","serverInfo","basePath","maxDuration"],"mappings":"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"}

package/dist/mcp/tools/resource/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,kBAAkB,WACrB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,UACzC,WAAW,SA2IpB,CAAA"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,kBAAkB,WACrB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,UACzC,WAAW,SAsJpB,CAAA"}

package/dist/mcp/tools/resource/create.js

@@ -3,7 +3,7 @@ import { toCamelCase } from '../../../utils/camelCase.js';
 import { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js';
 import { toolSchemas } from '../schemas.js';
 export const createResourceTool = (server, req, user, verboseLogs, collectionSlug, collections, schema)=>{
-    const tool = async (data, draft, locale, fallbackLocale)=>{
+    const tool = async (data, depth = 0, draft, locale, fallbackLocale)=>{
         const payload = req.payload;
         if (verboseLogs) {
             payload.logger.info(`[payload-mcp] Creating resource in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`);
@@ -31,6 +31,7 @@ export const createResourceTool = (server, req, user, verboseLogs, collectionSlu
             const result = await payload.create({
                 collection: collectionSlug,
                 data: parsedData,
+                depth,
                 draft,
                 overrideAccess: false,
                 req,
@@ -77,14 +78,15 @@ ${JSON.stringify(result, null, 2)}
         // Create a new schema that combines the converted fields with create-specific parameters
         const createResourceSchema = z.object({
             ...convertedFields.shape,
+            depth: z.number().int().min(0).max(10).optional().default(0).describe('How many levels deep to populate relationships in response'),
             draft: z.boolean().optional().default(false).describe('Whether to create the document as a draft'),
             fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             locale: z.string().optional().describe('Optional: locale code to create the document in (e.g., "en", "es"). Defaults to the default locale')
         });
         server.tool(`create${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.createResource.description.trim()}`, createResourceSchema.shape, async (params)=>{
-            const { draft, fallbackLocale, locale, ...fieldData } = params;
+            const { depth, draft, fallbackLocale, locale, ...fieldData } = params;
             const data = JSON.stringify(fieldData);
-            return await tool(data, draft, locale, fallbackLocale);
+            return await tool(data, depth, draft, locale, fallbackLocale);
         });
     }
 };

package/dist/mcp/tools/resource/create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/tools/resource/create.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport { z } from 'zod'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js'\nimport { toolSchemas } from '../schemas.js'\nexport const createResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n  schema: JSONSchema4,\n) => {\n  const tool = async (\n    data: string,\n    draft: boolean,\n    locale?: string,\n    fallbackLocale?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Creating resource in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse the data JSON\n      let parsedData: Record<string, unknown>\n      try {\n        parsedData = JSON.parse(data)\n        if (verboseLogs) {\n          payload.logger.info(\n            `[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`,\n          )\n        }\n      } catch (_parseError) {\n        payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`)\n        return {\n          content: [{ type: 'text' as const, text: 'Error: Invalid JSON data provided' }],\n        }\n      }\n\n      // Create the resource\n      const result = await payload.create({\n        collection: collectionSlug,\n        data: parsedData,\n        draft,\n        overrideAccess: false,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n      })\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Successfully created resource in ${collectionSlug} with ID: ${result.id}`,\n        )\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Resource created successfully in collection \"${collectionSlug}\"!\nCreated resource:\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error creating resource in ${collectionSlug}: ${errorMessage}`,\n      )\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error creating resource in collection \"${collectionSlug}\": ${errorMessage}`,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    const convertedFields = convertCollectionSchemaToZod(schema)\n\n    // Create a new schema that combines the converted fields with create-specific parameters\n    const createResourceSchema = z.object({\n      ...convertedFields.shape,\n      draft: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to create the document as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n    })\n\n    server.tool(\n      `create${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.createResource.description.trim()}`,\n      createResourceSchema.shape,\n      async (params: Record<string, unknown>) => {\n        const { draft, fallbackLocale, locale, ...fieldData } = params\n        const data = JSON.stringify(fieldData)\n        return await tool(\n          data,\n          draft as boolean,\n          locale as string | undefined,\n          fallbackLocale as string | undefined,\n        )\n      },\n    )\n  }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","toolSchemas","createResourceTool","server","req","user","verboseLogs","collectionSlug","collections","schema","tool","data","draft","locale","fallbackLocale","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","content","type","text","result","create","collection","overrideAccess","id","response","overrideResponse","errorMessage","Error","message","enabled","convertedFields","createResourceSchema","object","shape","boolean","optional","default","describe","string","charAt","toUpperCase","slice","description","createResource","trim","params","fieldData"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/tools/resource/create.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport { z } from 'zod'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js'\nimport { toolSchemas } from '../schemas.js'\nexport const createResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n  schema: JSONSchema4,\n) => {\n  const tool = async (\n    data: string,\n    depth: number = 0,\n    draft: boolean,\n    locale?: string,\n    fallbackLocale?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Creating resource in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse the data JSON\n      let parsedData: Record<string, unknown>\n      try {\n        parsedData = JSON.parse(data)\n        if (verboseLogs) {\n          payload.logger.info(\n            `[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`,\n          )\n        }\n      } catch (_parseError) {\n        payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`)\n        return {\n          content: [{ type: 'text' as const, text: 'Error: Invalid JSON data provided' }],\n        }\n      }\n\n      // Create the resource\n      const result = await payload.create({\n        collection: collectionSlug,\n        data: parsedData,\n        depth,\n        draft,\n        overrideAccess: false,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n      })\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Successfully created resource in ${collectionSlug} with ID: ${result.id}`,\n        )\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Resource created successfully in collection \"${collectionSlug}\"!\nCreated resource:\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error creating resource in ${collectionSlug}: ${errorMessage}`,\n      )\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error creating resource in collection \"${collectionSlug}\": ${errorMessage}`,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    const convertedFields = convertCollectionSchemaToZod(schema)\n\n    // Create a new schema that combines the converted fields with create-specific parameters\n    const createResourceSchema = z.object({\n      ...convertedFields.shape,\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('How many levels deep to populate relationships in response'),\n      draft: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to create the document as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n    })\n\n    server.tool(\n      `create${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.createResource.description.trim()}`,\n      createResourceSchema.shape,\n      async (params: Record<string, unknown>) => {\n        const { depth, draft, fallbackLocale, locale, ...fieldData } = params\n        const data = JSON.stringify(fieldData)\n        return await tool(\n          data,\n          depth as number,\n          draft as boolean,\n          locale as string | undefined,\n          fallbackLocale as string | undefined,\n        )\n      },\n    )\n  }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","toolSchemas","createResourceTool","server","req","user","verboseLogs","collectionSlug","collections","schema","tool","data","depth","draft","locale","fallbackLocale","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","content","type","text","result","create","collection","overrideAccess","id","response","overrideResponse","errorMessage","Error","message","enabled","convertedFields","createResourceSchema","object","shape","number","int","min","max","optional","default","describe","boolean","string","charAt","toUpperCase","slice","description","createResource","trim","params","fieldData"],"mappings":"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"}

package/dist/mcp/tools/resource/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,gBAAgB,WACnB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,SAgMlD,CAAA"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/resource/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK9D,eAAO,MAAM,gBAAgB,WACnB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,kBACJ,MAAM,eACT,qBAAqB,CAAC,aAAa,CAAC,SAmMlD,CAAA"}

package/dist/mcp/tools/resource/find.js

@@ -1,7 +1,7 @@
 import { toCamelCase } from '../../../utils/camelCase.js';
 import { toolSchemas } from '../schemas.js';
 export const findResourceTool = (server, req, user, verboseLogs, collectionSlug, collections)=>{
-    const tool = async (id, limit = 10, page = 1, sort, where, locale, fallbackLocale, draft)=>{
+    const tool = async (id, limit = 10, page = 1, sort, where, depth = 0, locale, fallbackLocale, draft)=>{
         const payload = req.payload;
         if (verboseLogs) {
             payload.logger.info(`[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`);
@@ -34,6 +34,7 @@ export const findResourceTool = (server, req, user, verboseLogs, collectionSlug,
                     const doc = await payload.findByID({
                         id,
                         collection: collectionSlug,
+                        depth,
                         overrideAccess: false,
                         req,
                         user,
@@ -76,6 +77,7 @@ ${JSON.stringify(doc, null, 2)}`
             // Otherwise, use find to get multiple documents
             const findOptions = {
                 collection: collectionSlug,
+                depth,
                 limit,
                 overrideAccess: false,
                 page,
@@ -132,8 +134,8 @@ Page: ${result.page} of ${result.totalPages}
         }
     };
     if (collections?.[collectionSlug]?.enabled) {
-        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, draft, fallbackLocale, limit, locale, page, sort, where })=>{
-            return await tool(id, limit, page, sort, where, locale, fallbackLocale, draft);
+        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, depth, draft, fallbackLocale, limit, locale, page, sort, where })=>{
+            return await tool(id, limit, page, sort, where, depth, locale, fallbackLocale, draft);
         });
     }
 };

package/dist/mcp/tools/resource/find.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/tools/resource/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n) => {\n  const tool = async (\n    id?: number | string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n    locale?: string,\n    fallbackLocale?: string,\n    draft?: boolean,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // If ID is provided, use findByID\n      if (id) {\n        try {\n          const doc = await payload.findByID({\n            id,\n            collection: collectionSlug,\n            overrideAccess: false,\n            req,\n            user,\n            ...(locale && { locale }),\n            ...(fallbackLocale && { fallbackLocale }),\n            ...(draft !== undefined && { draft }),\n          })\n\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Found document with ID: ${id}`)\n          }\n\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Resource from collection \"${collectionSlug}\":\n${JSON.stringify(doc, null, 2)}`,\n              },\n            ],\n          }\n\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        } catch (_findError) {\n          payload.logger.warn(\n            `[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`,\n          )\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Error: Document with ID \"${id}\" not found in collection \"${collectionSlug}\"`,\n              },\n            ],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Otherwise, use find to get multiple documents\n      const findOptions: Parameters<typeof payload.find>[0] = {\n        collection: collectionSlug,\n        limit,\n        overrideAccess: false,\n        page,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n        ...(draft !== undefined && { draft }),\n      }\n\n      if (sort) {\n        findOptions.sort = sort\n      }\n\n      if (Object.keys(whereClause).length > 0) {\n        findOptions.where = whereClause\n      }\n\n      const result = await payload.find(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`,\n        )\n      }\n\n      let responseText = `Collection: \"${collectionSlug}\"\nTotal: ${result.totalDocs} documents\nPage: ${result.page} of ${result.totalPages}\n`\n\n      for (const doc of result.docs) {\n        responseText += `\\n\\`\\`\\`json\\n${JSON.stringify(doc, null, 2)}\\n\\`\\`\\``\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`,\n      )\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading resources from collection \"${collectionSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    server.tool(\n      `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, draft, fallbackLocale, limit, locale, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where, locale, fallbackLocale, draft)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","locale","fallbackLocale","draft","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","overrideAccess","undefined","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/tools/resource/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n) => {\n  const tool = async (\n    id?: number | string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n    depth: number = 0,\n    locale?: string,\n    fallbackLocale?: string,\n    draft?: boolean,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // If ID is provided, use findByID\n      if (id) {\n        try {\n          const doc = await payload.findByID({\n            id,\n            collection: collectionSlug,\n            depth,\n            overrideAccess: false,\n            req,\n            user,\n            ...(locale && { locale }),\n            ...(fallbackLocale && { fallbackLocale }),\n            ...(draft !== undefined && { draft }),\n          })\n\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Found document with ID: ${id}`)\n          }\n\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Resource from collection \"${collectionSlug}\":\n${JSON.stringify(doc, null, 2)}`,\n              },\n            ],\n          }\n\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        } catch (_findError) {\n          payload.logger.warn(\n            `[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`,\n          )\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Error: Document with ID \"${id}\" not found in collection \"${collectionSlug}\"`,\n              },\n            ],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Otherwise, use find to get multiple documents\n      const findOptions: Parameters<typeof payload.find>[0] = {\n        collection: collectionSlug,\n        depth,\n        limit,\n        overrideAccess: false,\n        page,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n        ...(draft !== undefined && { draft }),\n      }\n\n      if (sort) {\n        findOptions.sort = sort\n      }\n\n      if (Object.keys(whereClause).length > 0) {\n        findOptions.where = whereClause\n      }\n\n      const result = await payload.find(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`,\n        )\n      }\n\n      let responseText = `Collection: \"${collectionSlug}\"\nTotal: ${result.totalDocs} documents\nPage: ${result.page} of ${result.totalPages}\n`\n\n      for (const doc of result.docs) {\n        responseText += `\\n\\`\\`\\`json\\n${JSON.stringify(doc, null, 2)}\\n\\`\\`\\``\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`,\n      )\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading resources from collection \"${collectionSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    server.tool(\n      `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, depth, draft, fallbackLocale, limit, locale, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where, depth, locale, fallbackLocale, draft)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","depth","locale","fallbackLocale","draft","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","overrideAccess","undefined","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"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"}

package/dist/mcp/tools/schemas.d.ts

@@ -20,6 +20,7 @@ export declare const toolSchemas: {
         description: string;
         parameters: z.ZodObject<{
             id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             draft: z.ZodOptional<z.ZodBoolean>;
             fallbackLocale: z.ZodOptional<z.ZodString>;
             limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -28,6 +29,7 @@ export declare const toolSchemas: {
             sort: z.ZodOptional<z.ZodString>;
             where: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            depth: number;
             limit: number;
             page: number;
             locale?: string | undefined;
@@ -37,6 +39,7 @@ export declare const toolSchemas: {
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
         }, {
+            depth?: number | undefined;
             locale?: string | undefined;
             sort?: string | undefined;
             draft?: boolean | undefined;
@@ -51,16 +54,19 @@ export declare const toolSchemas: {
         description: string;
         parameters: z.ZodObject<{
             data: z.ZodString;
+            depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             fallbackLocale: z.ZodOptional<z.ZodString>;
             locale: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            depth: number;
             draft: boolean;
             data: string;
             locale?: string | undefined;
             fallbackLocale?: string | undefined;
         }, {
             data: string;
+            depth?: number | undefined;
             locale?: string | undefined;
             draft?: boolean | undefined;
             fallbackLocale?: string | undefined;

package/dist/mcp/tools/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwdvB,CAAA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwevB,CAAA"}

package/dist/mcp/tools/schemas.js

@@ -15,6 +15,7 @@ export const toolSchemas = {
                 z.string(),
                 z.number()
             ]).optional().describe('Optional: specific document ID to retrieve. If not provided, returns all documents'),
+            depth: z.number().int().min(0).max(10).optional().default(0).describe('How many levels deep to populate relationships (default: 0)'),
             draft: z.boolean().optional().describe('Optional: Whether the document should be queried from the versions table/collection or not.'),
             fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             limit: z.number().int().min(1, 'Limit must be at least 1').max(100, 'Limit cannot exceed 100').optional().default(10).describe('Maximum number of documents to return (default: 10, max: 100)'),
@@ -28,6 +29,7 @@ export const toolSchemas = {
         description: 'Create a document in a collection.',
         parameters: z.object({
             data: z.string().describe('JSON string containing the data for the new document'),
+            depth: z.number().int().min(0).max(10).optional().default(0).describe('How many levels deep to populate relationships in response (default: 0)'),
             draft: z.boolean().optional().default(false).describe('Whether to create the document as a draft'),
             fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             locale: z.string().optional().describe('Optional: locale code to create the document in (e.g., "en", "es"). Defaults to the default locale')

package/dist/mcp/tools/schemas.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/mcp/tools/schemas.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const toolSchemas = {\n  findGlobal: {\n    description: 'Find a Payload global singleton configuration.',\n    parameters: z.object({\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n        ),\n    }),\n  },\n\n  findResources: {\n    description: 'Find documents in a collection by ID or where clause using Find or FindByID.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe(\n          'Optional: specific document ID to retrieve. If not provided, returns all documents',\n        ),\n      draft: z\n        .boolean()\n        .optional()\n        .describe(\n          'Optional: Whether the document should be queried from the versions table/collection or not.',\n        ),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      limit: z\n        .number()\n        .int()\n        .min(1, 'Limit must be at least 1')\n        .max(100, 'Limit cannot exceed 100')\n        .optional()\n        .default(10)\n        .describe('Maximum number of documents to return (default: 10, max: 100)'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n        ),\n      page: z\n        .number()\n        .int()\n        .min(1, 'Page must be at least 1')\n        .optional()\n        .default(1)\n        .describe('Page number for pagination (default: 1)'),\n      sort: z\n        .string()\n        .optional()\n        .describe('Field to sort by (e.g., \"createdAt\", \"-updatedAt\" for descending)'),\n      where: z\n        .string()\n        .optional()\n        .describe(\n          'Optional JSON string for where clause filtering (e.g., \\'{\"title\": {\"contains\": \"test\"}}\\')',\n        ),\n    }),\n  },\n\n  createResource: {\n    description: 'Create a document in a collection.',\n    parameters: z.object({\n      data: z.string().describe('JSON string containing the data for the new document'),\n      draft: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to create the document as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n    }),\n  },\n\n  updateResource: {\n    description: 'Update documents in a collection by ID or where clause.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe('Optional: specific document ID to update'),\n      data: z.string().describe('JSON string containing the data to update'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      filePath: z.string().optional().describe('Optional: absolute file path for file uploads'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n      overrideLock: z\n        .boolean()\n        .optional()\n        .default(true)\n        .describe('Whether to override document locks'),\n      overwriteExistingFiles: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to overwrite existing files'),\n      where: z\n        .string()\n        .optional()\n        .describe('Optional: JSON string for where clause to update multiple documents'),\n    }),\n  },\n\n  deleteResource: {\n    description: 'Delete documents in a collection by ID or where clause.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe('Optional: specific document ID to delete'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships in response'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code for the operation (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n      where: z\n        .string()\n        .optional()\n        .describe('Optional: JSON string for where clause to delete multiple documents'),\n    }),\n  },\n\n  updateGlobal: {\n    description: 'Update a Payload global singleton configuration.',\n    parameters: z.object({\n      data: z.string().describe('JSON string containing the data to update'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update data in (e.g., \"en\", \"es\"). Use \"all\" to update all locales for localized fields',\n        ),\n    }),\n  },\n\n  // Experimental Below This Line\n  createCollection: {\n    description: 'Creates a new collection with specified fields and configuration.',\n    parameters: z.object({\n      collectionDescription: z\n        .string()\n        .optional()\n        .describe('Optional description for the collection'),\n      collectionName: z.string().describe('The name of the collection to create'),\n      fields: z.array(z.any()).describe('Array of field definitions for the collection'),\n      hasUpload: z\n        .boolean()\n        .optional()\n        .describe('Whether the collection should have upload capabilities'),\n    }),\n  },\n\n  findCollections: {\n    description: 'Finds and lists collections with optional content and document counts.',\n    parameters: z.object({\n      collectionName: z\n        .string()\n        .optional()\n        .describe('Optional: specific collection name to retrieve'),\n      includeContent: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include collection file content'),\n      includeCount: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include document counts for each collection'),\n    }),\n  },\n\n  updateCollection: {\n    description:\n      'Updates an existing collection with new fields, modifications, or configuration changes.',\n    parameters: z.object({\n      collectionName: z.string().describe('The name of the collection to update'),\n      configUpdates: z.any().optional().describe('Configuration updates (for update_config type)'),\n      fieldModifications: z\n        .array(z.any())\n        .optional()\n        .describe('Field modifications (for modify_field type)'),\n      fieldNamesToRemove: z\n        .array(z.string())\n        .optional()\n        .describe('Field names to remove (for remove_field type)'),\n      newContent: z\n        .string()\n        .optional()\n        .describe('New content to replace entire collection (for replace_content type)'),\n      newFields: z.array(z.any()).optional().describe('New fields to add (for add_field type)'),\n      updateType: z\n        .enum(['add_field', 'remove_field', 'modify_field', 'update_config', 'replace_content'])\n        .describe('Type of update to perform'),\n    }),\n  },\n\n  deleteCollection: {\n    description: 'Deletes a collection and optionally updates the configuration.',\n    parameters: z.object({\n      collectionName: z.string().describe('The name of the collection to delete'),\n      confirmDeletion: z.boolean().describe('Confirmation flag to prevent accidental deletion'),\n      updateConfig: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to update payload.config.ts to remove collection reference'),\n    }),\n  },\n\n  findConfig: {\n    description: 'Reads and displays the current configuration file.',\n    parameters: z.object({\n      includeMetadata: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include file metadata (size, modified date, etc.)'),\n    }),\n  },\n\n  updateConfig: {\n    description: 'Updates the configuration file with various modifications.',\n    parameters: z.object({\n      adminConfig: z\n        .any()\n        .optional()\n        .describe('Admin configuration updates (for update_admin type)'),\n      collectionName: z\n        .string()\n        .optional()\n        .describe('Collection name (required for add_collection and remove_collection)'),\n      databaseConfig: z\n        .any()\n        .optional()\n        .describe('Database configuration updates (for update_database type)'),\n      generalConfig: z.any().optional().describe('General configuration updates'),\n      newContent: z\n        .string()\n        .optional()\n        .describe('New configuration content (for replace_content type)'),\n      pluginUpdates: z\n        .any()\n        .optional()\n        .describe('Plugin configuration updates (for update_plugins type)'),\n      updateType: z\n        .enum([\n          'add_collection',\n          'remove_collection',\n          'update_admin',\n          'update_database',\n          'update_plugins',\n          'replace_content',\n        ])\n        .describe('Type of configuration update to perform'),\n    }),\n  },\n\n  auth: {\n    description: 'Checks authentication status for the current user.',\n    parameters: z.object({\n      headers: z\n        .string()\n        .optional()\n        .describe(\n          'Optional JSON string containing custom headers to send with the authentication request',\n        ),\n    }),\n  },\n\n  login: {\n    description: 'Authenticates a user with email and password.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      email: z.string().email().describe('The user email address'),\n      overrideAccess: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to override access controls'),\n      password: z.string().describe('The user password'),\n      showHiddenFields: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to show hidden fields in the response'),\n    }),\n  },\n\n  verify: {\n    description: 'Verifies a user email with a verification token.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      token: z.string().describe('The verification token sent to the user email'),\n    }),\n  },\n\n  resetPassword: {\n    description: 'Resets a user password with a reset token.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      password: z.string().describe('The new password for the user'),\n      token: z.string().describe('The password reset token sent to the user email'),\n    }),\n  },\n\n  forgotPassword: {\n    description: 'Sends a password reset email to a user.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      disableEmail: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to disable sending the email (for testing)'),\n      email: z.string().email().describe('The user email address'),\n    }),\n  },\n\n  unlock: {\n    description: 'Unlocks a user account that has been locked due to failed login attempts.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      email: z.string().email().describe('The user email address'),\n    }),\n  },\n\n  createJob: {\n    description: 'Creates a new job (task or workflow) with specified configuration.',\n    parameters: z.object({\n      description: z.string().describe('Description of what the job does'),\n      inputSchema: z.record(z.any()).optional().default({}).describe('Input schema for the job'),\n      jobData: z\n        .record(z.any())\n        .optional()\n        .default({})\n        .describe('Additional job configuration data'),\n      jobName: z\n        .string()\n        .min(1, 'Job name cannot be empty')\n        .regex(/^[a-z][\\w-]*$/i, 'Job name must be alphanumeric and can contain underscores/dashes')\n        .describe('The name of the job to create'),\n      jobSlug: z\n        .string()\n        .min(1, 'Job slug cannot be empty')\n        .regex(/^[a-z][a-z0-9-]*$/, 'Job slug must be kebab-case')\n        .describe('The slug for the job (kebab-case format)'),\n      jobType: z\n        .enum(['task', 'workflow'])\n        .describe('Whether to create a task (individual unit) or workflow (orchestrates tasks)'),\n      outputSchema: z.record(z.any()).optional().default({}).describe('Output schema for the job'),\n    }),\n  },\n\n  updateJob: {\n    description: 'Updates an existing job with new configuration, schema, or handler code.',\n    parameters: z.object({\n      configUpdate: z.record(z.any()).optional().describe('New configuration for the job'),\n      handlerCode: z\n        .string()\n        .optional()\n        .describe('New handler code to replace the existing handler'),\n      inputSchema: z.record(z.any()).optional().describe('New input schema for the job'),\n      jobSlug: z.string().describe('The slug of the job to update'),\n      outputSchema: z.record(z.any()).optional().describe('New output schema for the job'),\n      taskSequence: z.array(z.any()).optional().describe('New task sequence for workflows'),\n      updateType: z\n        .enum(['modify_schema', 'update_tasks', 'change_config', 'replace_handler'])\n        .describe('Type of update to perform on the job'),\n    }),\n  },\n\n  runJob: {\n    description: 'Runs a job with specified input data and queue options.',\n    parameters: z.object({\n      delay: z\n        .number()\n        .int()\n        .min(0)\n        .optional()\n        .describe('Delay in milliseconds before job execution'),\n      input: z.record(z.any()).describe('Input data for the job execution'),\n      jobSlug: z.string().describe('The slug of the job to run'),\n      priority: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe('Job priority (1-10, higher is more important)'),\n      queue: z\n        .string()\n        .optional()\n        .describe('Queue name to use for job execution (default: \"default\")'),\n    }),\n  },\n}\n"],"names":["z","toolSchemas","findGlobal","description","parameters","object","depth","number","int","min","max","optional","default","describe","fallbackLocale","string","locale","findResources","id","union","draft","boolean","limit","page","sort","where","createResource","data","updateResource","filePath","overrideLock","overwriteExistingFiles","deleteResource","updateGlobal","createCollection","collectionDescription","collectionName","fields","array","any","hasUpload","findCollections","includeContent","includeCount","updateCollection","configUpdates","fieldModifications","fieldNamesToRemove","newContent","newFields","updateType","enum","deleteCollection","confirmDeletion","updateConfig","findConfig","includeMetadata","adminConfig","databaseConfig","generalConfig","pluginUpdates","auth","headers","login","collection","email","overrideAccess","password","showHiddenFields","verify","token","resetPassword","forgotPassword","disableEmail","unlock","createJob","inputSchema","record","jobData","jobName","regex","jobSlug","jobType","outputSchema","updateJob","configUpdate","handlerCode","taskSequence","runJob","delay","input","priority","queue"],"mappings":"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"}
+{"version":3,"sources":["../../../src/mcp/tools/schemas.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const toolSchemas = {\n  findGlobal: {\n    description: 'Find a Payload global singleton configuration.',\n    parameters: z.object({\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n        ),\n    }),\n  },\n\n  findResources: {\n    description: 'Find documents in a collection by ID or where clause using Find or FindByID.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe(\n          'Optional: specific document ID to retrieve. If not provided, returns all documents',\n        ),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('How many levels deep to populate relationships (default: 0)'),\n      draft: z\n        .boolean()\n        .optional()\n        .describe(\n          'Optional: Whether the document should be queried from the versions table/collection or not.',\n        ),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      limit: z\n        .number()\n        .int()\n        .min(1, 'Limit must be at least 1')\n        .max(100, 'Limit cannot exceed 100')\n        .optional()\n        .default(10)\n        .describe('Maximum number of documents to return (default: 10, max: 100)'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve all locales for localized fields',\n        ),\n      page: z\n        .number()\n        .int()\n        .min(1, 'Page must be at least 1')\n        .optional()\n        .default(1)\n        .describe('Page number for pagination (default: 1)'),\n      sort: z\n        .string()\n        .optional()\n        .describe('Field to sort by (e.g., \"createdAt\", \"-updatedAt\" for descending)'),\n      where: z\n        .string()\n        .optional()\n        .describe(\n          'Optional JSON string for where clause filtering (e.g., \\'{\"title\": {\"contains\": \"test\"}}\\')',\n        ),\n    }),\n  },\n\n  createResource: {\n    description: 'Create a document in a collection.',\n    parameters: z.object({\n      data: z.string().describe('JSON string containing the data for the new document'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('How many levels deep to populate relationships in response (default: 0)'),\n      draft: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to create the document as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n    }),\n  },\n\n  updateResource: {\n    description: 'Update documents in a collection by ID or where clause.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe('Optional: specific document ID to update'),\n      data: z.string().describe('JSON string containing the data to update'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      filePath: z.string().optional().describe('Optional: absolute file path for file uploads'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n      overrideLock: z\n        .boolean()\n        .optional()\n        .default(true)\n        .describe('Whether to override document locks'),\n      overwriteExistingFiles: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to overwrite existing files'),\n      where: z\n        .string()\n        .optional()\n        .describe('Optional: JSON string for where clause to update multiple documents'),\n    }),\n  },\n\n  deleteResource: {\n    description: 'Delete documents in a collection by ID or where clause.',\n    parameters: z.object({\n      id: z\n        .union([z.string(), z.number()])\n        .optional()\n        .describe('Optional: specific document ID to delete'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships in response'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code for the operation (e.g., \"en\", \"es\"). Defaults to the default locale',\n        ),\n      where: z\n        .string()\n        .optional()\n        .describe('Optional: JSON string for where clause to delete multiple documents'),\n    }),\n  },\n\n  updateGlobal: {\n    description: 'Update a Payload global singleton configuration.',\n    parameters: z.object({\n      data: z.string().describe('JSON string containing the data to update'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update data in (e.g., \"en\", \"es\"). Use \"all\" to update all locales for localized fields',\n        ),\n    }),\n  },\n\n  // Experimental Below This Line\n  createCollection: {\n    description: 'Creates a new collection with specified fields and configuration.',\n    parameters: z.object({\n      collectionDescription: z\n        .string()\n        .optional()\n        .describe('Optional description for the collection'),\n      collectionName: z.string().describe('The name of the collection to create'),\n      fields: z.array(z.any()).describe('Array of field definitions for the collection'),\n      hasUpload: z\n        .boolean()\n        .optional()\n        .describe('Whether the collection should have upload capabilities'),\n    }),\n  },\n\n  findCollections: {\n    description: 'Finds and lists collections with optional content and document counts.',\n    parameters: z.object({\n      collectionName: z\n        .string()\n        .optional()\n        .describe('Optional: specific collection name to retrieve'),\n      includeContent: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include collection file content'),\n      includeCount: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include document counts for each collection'),\n    }),\n  },\n\n  updateCollection: {\n    description:\n      'Updates an existing collection with new fields, modifications, or configuration changes.',\n    parameters: z.object({\n      collectionName: z.string().describe('The name of the collection to update'),\n      configUpdates: z.any().optional().describe('Configuration updates (for update_config type)'),\n      fieldModifications: z\n        .array(z.any())\n        .optional()\n        .describe('Field modifications (for modify_field type)'),\n      fieldNamesToRemove: z\n        .array(z.string())\n        .optional()\n        .describe('Field names to remove (for remove_field type)'),\n      newContent: z\n        .string()\n        .optional()\n        .describe('New content to replace entire collection (for replace_content type)'),\n      newFields: z.array(z.any()).optional().describe('New fields to add (for add_field type)'),\n      updateType: z\n        .enum(['add_field', 'remove_field', 'modify_field', 'update_config', 'replace_content'])\n        .describe('Type of update to perform'),\n    }),\n  },\n\n  deleteCollection: {\n    description: 'Deletes a collection and optionally updates the configuration.',\n    parameters: z.object({\n      collectionName: z.string().describe('The name of the collection to delete'),\n      confirmDeletion: z.boolean().describe('Confirmation flag to prevent accidental deletion'),\n      updateConfig: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to update payload.config.ts to remove collection reference'),\n    }),\n  },\n\n  findConfig: {\n    description: 'Reads and displays the current configuration file.',\n    parameters: z.object({\n      includeMetadata: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to include file metadata (size, modified date, etc.)'),\n    }),\n  },\n\n  updateConfig: {\n    description: 'Updates the configuration file with various modifications.',\n    parameters: z.object({\n      adminConfig: z\n        .any()\n        .optional()\n        .describe('Admin configuration updates (for update_admin type)'),\n      collectionName: z\n        .string()\n        .optional()\n        .describe('Collection name (required for add_collection and remove_collection)'),\n      databaseConfig: z\n        .any()\n        .optional()\n        .describe('Database configuration updates (for update_database type)'),\n      generalConfig: z.any().optional().describe('General configuration updates'),\n      newContent: z\n        .string()\n        .optional()\n        .describe('New configuration content (for replace_content type)'),\n      pluginUpdates: z\n        .any()\n        .optional()\n        .describe('Plugin configuration updates (for update_plugins type)'),\n      updateType: z\n        .enum([\n          'add_collection',\n          'remove_collection',\n          'update_admin',\n          'update_database',\n          'update_plugins',\n          'replace_content',\n        ])\n        .describe('Type of configuration update to perform'),\n    }),\n  },\n\n  auth: {\n    description: 'Checks authentication status for the current user.',\n    parameters: z.object({\n      headers: z\n        .string()\n        .optional()\n        .describe(\n          'Optional JSON string containing custom headers to send with the authentication request',\n        ),\n    }),\n  },\n\n  login: {\n    description: 'Authenticates a user with email and password.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .optional()\n        .default(0)\n        .describe('Depth of population for relationships'),\n      email: z.string().email().describe('The user email address'),\n      overrideAccess: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to override access controls'),\n      password: z.string().describe('The user password'),\n      showHiddenFields: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to show hidden fields in the response'),\n    }),\n  },\n\n  verify: {\n    description: 'Verifies a user email with a verification token.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      token: z.string().describe('The verification token sent to the user email'),\n    }),\n  },\n\n  resetPassword: {\n    description: 'Resets a user password with a reset token.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      password: z.string().describe('The new password for the user'),\n      token: z.string().describe('The password reset token sent to the user email'),\n    }),\n  },\n\n  forgotPassword: {\n    description: 'Sends a password reset email to a user.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      disableEmail: z\n        .boolean()\n        .optional()\n        .default(false)\n        .describe('Whether to disable sending the email (for testing)'),\n      email: z.string().email().describe('The user email address'),\n    }),\n  },\n\n  unlock: {\n    description: 'Unlocks a user account that has been locked due to failed login attempts.',\n    parameters: z.object({\n      collection: z.string().describe('The collection containing the user (e.g., \"users\")'),\n      email: z.string().email().describe('The user email address'),\n    }),\n  },\n\n  createJob: {\n    description: 'Creates a new job (task or workflow) with specified configuration.',\n    parameters: z.object({\n      description: z.string().describe('Description of what the job does'),\n      inputSchema: z.record(z.any()).optional().default({}).describe('Input schema for the job'),\n      jobData: z\n        .record(z.any())\n        .optional()\n        .default({})\n        .describe('Additional job configuration data'),\n      jobName: z\n        .string()\n        .min(1, 'Job name cannot be empty')\n        .regex(/^[a-z][\\w-]*$/i, 'Job name must be alphanumeric and can contain underscores/dashes')\n        .describe('The name of the job to create'),\n      jobSlug: z\n        .string()\n        .min(1, 'Job slug cannot be empty')\n        .regex(/^[a-z][a-z0-9-]*$/, 'Job slug must be kebab-case')\n        .describe('The slug for the job (kebab-case format)'),\n      jobType: z\n        .enum(['task', 'workflow'])\n        .describe('Whether to create a task (individual unit) or workflow (orchestrates tasks)'),\n      outputSchema: z.record(z.any()).optional().default({}).describe('Output schema for the job'),\n    }),\n  },\n\n  updateJob: {\n    description: 'Updates an existing job with new configuration, schema, or handler code.',\n    parameters: z.object({\n      configUpdate: z.record(z.any()).optional().describe('New configuration for the job'),\n      handlerCode: z\n        .string()\n        .optional()\n        .describe('New handler code to replace the existing handler'),\n      inputSchema: z.record(z.any()).optional().describe('New input schema for the job'),\n      jobSlug: z.string().describe('The slug of the job to update'),\n      outputSchema: z.record(z.any()).optional().describe('New output schema for the job'),\n      taskSequence: z.array(z.any()).optional().describe('New task sequence for workflows'),\n      updateType: z\n        .enum(['modify_schema', 'update_tasks', 'change_config', 'replace_handler'])\n        .describe('Type of update to perform on the job'),\n    }),\n  },\n\n  runJob: {\n    description: 'Runs a job with specified input data and queue options.',\n    parameters: z.object({\n      delay: z\n        .number()\n        .int()\n        .min(0)\n        .optional()\n        .describe('Delay in milliseconds before job execution'),\n      input: z.record(z.any()).describe('Input data for the job execution'),\n      jobSlug: z.string().describe('The slug of the job to run'),\n      priority: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe('Job priority (1-10, higher is more important)'),\n      queue: z\n        .string()\n        .optional()\n        .describe('Queue name to use for job execution (default: \"default\")'),\n    }),\n  },\n}\n"],"names":["z","toolSchemas","findGlobal","description","parameters","object","depth","number","int","min","max","optional","default","describe","fallbackLocale","string","locale","findResources","id","union","draft","boolean","limit","page","sort","where","createResource","data","updateResource","filePath","overrideLock","overwriteExistingFiles","deleteResource","updateGlobal","createCollection","collectionDescription","collectionName","fields","array","any","hasUpload","findCollections","includeContent","includeCount","updateCollection","configUpdates","fieldModifications","fieldNamesToRemove","newContent","newFields","updateType","enum","deleteCollection","confirmDeletion","updateConfig","findConfig","includeMetadata","adminConfig","databaseConfig","generalConfig","pluginUpdates","auth","headers","login","collection","email","overrideAccess","password","showHiddenFields","verify","token","resetPassword","forgotPassword","disableEmail","unlock","createJob","inputSchema","record","jobData","jobName","regex","jobSlug","jobType","outputSchema","updateJob","configUpdate","handlerCode","taskSequence","runJob","delay","input","priority","queue"],"mappings":"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"}

package/dist/utils/convertCollectionSchemaToZod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convertCollectionSchemaToZod.d.ts","sourceRoot":"","sources":["../../src/utils/convertCollectionSchemaToZod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAM9C,eAAO,MAAM,4BAA4B,WAAY,WAAW,QA2B/D,CAAA"}
+{"version":3,"file":"convertCollectionSchemaToZod.d.ts","sourceRoot":"","sources":["../../src/utils/convertCollectionSchemaToZod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAoD9C,eAAO,MAAM,4BAA4B,WAAY,WAAW,QAuC/D,CAAA"}

package/dist/utils/convertCollectionSchemaToZod.js

@@ -1,11 +1,60 @@
 import { jsonSchemaToZod } from 'json-schema-to-zod';
 import * as ts from 'typescript';
 import { z } from 'zod';
+/**
+ * Recursively processes JSON schema properties to simplify relationship fields.
+ * For create/update validation we only need to accept IDs (string/number),
+ * not populated objects. This removes the $ref option from oneOf unions
+ * that represent relationship fields, leaving only the ID shape.
+ *
+ * NOTE: This function must operate on a cloned schema to avoid mutating
+ * the original JSON schema used for tool listing.
+ */ function simplifyRelationshipFields(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return schema;
+    }
+    const processed = {
+        ...schema
+    };
+    if (Array.isArray(processed.oneOf)) {
+        const hasRef = processed.oneOf.some((option)=>option && typeof option === 'object' && '$ref' in option);
+        processed.oneOf = processed.oneOf.map((option)=>{
+            if (option && typeof option === 'object' && '$ref' in option) {
+                // Replace unresolved $ref with a permissive object schema to keep the union shape
+                return {
+                    type: 'object',
+                    additionalProperties: true
+                };
+            }
+            return simplifyRelationshipFields(option);
+        });
+    }
+    if (processed.properties && typeof processed.properties === 'object') {
+        processed.properties = Object.fromEntries(Object.entries(processed.properties).map(([key, value])=>[
+                key,
+                simplifyRelationshipFields(value)
+            ]));
+    }
+    if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {
+        processed.items = simplifyRelationshipFields(processed.items);
+    }
+    return processed;
+}
 export const convertCollectionSchemaToZod = (schema)=>{
+    // Clone to avoid mutating the original schema (used elsewhere for tool listing)
+    const schemaClone = JSON.parse(JSON.stringify(schema));
     // Remove properties that should not be included in the Zod schema
-    delete schema?.properties?.createdAt;
-    delete schema?.properties?.updatedAt;
-    const zodSchemaAsString = jsonSchemaToZod(schema);
+    delete schemaClone?.properties?.id;
+    delete schemaClone?.properties?.createdAt;
+    delete schemaClone?.properties?.updatedAt;
+    if (Array.isArray(schemaClone.required)) {
+        schemaClone.required = schemaClone.required.filter((field)=>field !== 'id');
+        if (schemaClone.required.length === 0) {
+            delete schemaClone.required;
+        }
+    }
+    const simplifiedSchema = simplifyRelationshipFields(schemaClone);
+    const zodSchemaAsString = jsonSchemaToZod(simplifiedSchema);
     // Transpile TypeScript to JavaScript
     const transpileResult = ts.transpileModule(zodSchemaAsString, {
         compilerOptions: {

package/dist/utils/convertCollectionSchemaToZod.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/convertCollectionSchemaToZod.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { jsonSchemaToZod } from 'json-schema-to-zod'\nimport * as ts from 'typescript'\nimport { z } from 'zod'\n\nexport const convertCollectionSchemaToZod = (schema: JSONSchema4) => {\n  // Remove properties that should not be included in the Zod schema\n  delete schema?.properties?.createdAt\n  delete schema?.properties?.updatedAt\n\n  const zodSchemaAsString = jsonSchemaToZod(schema)\n\n  // Transpile TypeScript to JavaScript\n  const transpileResult = ts.transpileModule(zodSchemaAsString, {\n    compilerOptions: {\n      module: ts.ModuleKind.CommonJS,\n      removeComments: true,\n      strict: false,\n      target: ts.ScriptTarget.ES2018,\n    },\n  })\n\n  /**\n   * This Function evaluation is safe because:\n   * 1. The input schema comes from Payload's collection configuration, which is controlled by the application developer\n   * 2. The jsonSchemaToZod library converts JSON Schema to Zod schema definitions, producing only type validation code\n   * 3. The transpiled output contains only Zod schema definitions (z.string(), z.number(), etc.) - no executable logic\n   * 4. The resulting Zod schema is used only for parameter validation in MCP tools, not for data processing\n   * 5. No user input or external data is involved in the schema generation process\n   */\n  // eslint-disable-next-line @typescript-eslint/no-implied-eval\n  return new Function('z', `return ${transpileResult.outputText}`)(z)\n}\n"],"names":["jsonSchemaToZod","ts","z","convertCollectionSchemaToZod","schema","properties","createdAt","updatedAt","zodSchemaAsString","transpileResult","transpileModule","compilerOptions","module","ModuleKind","CommonJS","removeComments","strict","target","ScriptTarget","ES2018","Function","outputText"],"mappings":"AAEA,SAASA,eAAe,QAAQ,qBAAoB;AACpD,YAAYC,QAAQ,aAAY;AAChC,SAASC,CAAC,QAAQ,MAAK;AAEvB,OAAO,MAAMC,+BAA+B,CAACC;IAC3C,kEAAkE;IAClE,OAAOA,QAAQC,YAAYC;IAC3B,OAAOF,QAAQC,YAAYE;IAE3B,MAAMC,oBAAoBR,gBAAgBI;IAE1C,qCAAqC;IACrC,MAAMK,kBAAkBR,GAAGS,eAAe,CAACF,mBAAmB;QAC5DG,iBAAiB;YACfC,QAAQX,GAAGY,UAAU,CAACC,QAAQ;YAC9BC,gBAAgB;YAChBC,QAAQ;YACRC,QAAQhB,GAAGiB,YAAY,CAACC,MAAM;QAChC;IACF;IAEA;;;;;;;GAOC,GACD,8DAA8D;IAC9D,OAAO,IAAIC,SAAS,KAAK,CAAC,OAAO,EAAEX,gBAAgBY,UAAU,EAAE,EAAEnB;AACnE,EAAC"}
+{"version":3,"sources":["../../src/utils/convertCollectionSchemaToZod.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { jsonSchemaToZod } from 'json-schema-to-zod'\nimport * as ts from 'typescript'\nimport { z } from 'zod'\n\n/**\n * Recursively processes JSON schema properties to simplify relationship fields.\n * For create/update validation we only need to accept IDs (string/number),\n * not populated objects. This removes the $ref option from oneOf unions\n * that represent relationship fields, leaving only the ID shape.\n *\n * NOTE: This function must operate on a cloned schema to avoid mutating\n * the original JSON schema used for tool listing.\n */\nfunction simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {\n  if (!schema || typeof schema !== 'object') {\n    return schema\n  }\n\n  const processed = { ...schema }\n\n  if (Array.isArray(processed.oneOf)) {\n    const hasRef = processed.oneOf.some(\n      (option) => option && typeof option === 'object' && '$ref' in option,\n    )\n\n    processed.oneOf = processed.oneOf.map((option) => {\n      if (option && typeof option === 'object' && '$ref' in option) {\n        // Replace unresolved $ref with a permissive object schema to keep the union shape\n        return { type: 'object', additionalProperties: true }\n      }\n      return simplifyRelationshipFields(option)\n    })\n  }\n\n  if (processed.properties && typeof processed.properties === 'object') {\n    processed.properties = Object.fromEntries(\n      Object.entries(processed.properties).map(([key, value]) => [\n        key,\n        simplifyRelationshipFields(value),\n      ]),\n    )\n  }\n\n  if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {\n    processed.items = simplifyRelationshipFields(processed.items)\n  }\n\n  return processed\n}\n\nexport const convertCollectionSchemaToZod = (schema: JSONSchema4) => {\n  // Clone to avoid mutating the original schema (used elsewhere for tool listing)\n  const schemaClone = JSON.parse(JSON.stringify(schema)) as JSONSchema4\n\n  // Remove properties that should not be included in the Zod schema\n  delete schemaClone?.properties?.id\n  delete schemaClone?.properties?.createdAt\n  delete schemaClone?.properties?.updatedAt\n  if (Array.isArray(schemaClone.required)) {\n    schemaClone.required = schemaClone.required.filter((field) => field !== 'id')\n    if (schemaClone.required.length === 0) {\n      delete schemaClone.required\n    }\n  }\n\n  const simplifiedSchema = simplifyRelationshipFields(schemaClone)\n\n  const zodSchemaAsString = jsonSchemaToZod(simplifiedSchema)\n\n  // Transpile TypeScript to JavaScript\n  const transpileResult = ts.transpileModule(zodSchemaAsString, {\n    compilerOptions: {\n      module: ts.ModuleKind.CommonJS,\n      removeComments: true,\n      strict: false,\n      target: ts.ScriptTarget.ES2018,\n    },\n  })\n\n  /**\n   * This Function evaluation is safe because:\n   * 1. The input schema comes from Payload's collection configuration, which is controlled by the application developer\n   * 2. The jsonSchemaToZod library converts JSON Schema to Zod schema definitions, producing only type validation code\n   * 3. The transpiled output contains only Zod schema definitions (z.string(), z.number(), etc.) - no executable logic\n   * 4. The resulting Zod schema is used only for parameter validation in MCP tools, not for data processing\n   * 5. No user input or external data is involved in the schema generation process\n   */\n  // eslint-disable-next-line @typescript-eslint/no-implied-eval\n  return new Function('z', `return ${transpileResult.outputText}`)(z)\n}\n"],"names":["jsonSchemaToZod","ts","z","simplifyRelationshipFields","schema","processed","Array","isArray","oneOf","hasRef","some","option","map","type","additionalProperties","properties","Object","fromEntries","entries","key","value","items","convertCollectionSchemaToZod","schemaClone","JSON","parse","stringify","id","createdAt","updatedAt","required","filter","field","length","simplifiedSchema","zodSchemaAsString","transpileResult","transpileModule","compilerOptions","module","ModuleKind","CommonJS","removeComments","strict","target","ScriptTarget","ES2018","Function","outputText"],"mappings":"AAEA,SAASA,eAAe,QAAQ,qBAAoB;AACpD,YAAYC,QAAQ,aAAY;AAChC,SAASC,CAAC,QAAQ,MAAK;AAEvB;;;;;;;;CAQC,GACD,SAASC,2BAA2BC,MAAmB;IACrD,IAAI,CAACA,UAAU,OAAOA,WAAW,UAAU;QACzC,OAAOA;IACT;IAEA,MAAMC,YAAY;QAAE,GAAGD,MAAM;IAAC;IAE9B,IAAIE,MAAMC,OAAO,CAACF,UAAUG,KAAK,GAAG;QAClC,MAAMC,SAASJ,UAAUG,KAAK,CAACE,IAAI,CACjC,CAACC,SAAWA,UAAU,OAAOA,WAAW,YAAY,UAAUA;QAGhEN,UAAUG,KAAK,GAAGH,UAAUG,KAAK,CAACI,GAAG,CAAC,CAACD;YACrC,IAAIA,UAAU,OAAOA,WAAW,YAAY,UAAUA,QAAQ;gBAC5D,kFAAkF;gBAClF,OAAO;oBAAEE,MAAM;oBAAUC,sBAAsB;gBAAK;YACtD;YACA,OAAOX,2BAA2BQ;QACpC;IACF;IAEA,IAAIN,UAAUU,UAAU,IAAI,OAAOV,UAAUU,UAAU,KAAK,UAAU;QACpEV,UAAUU,UAAU,GAAGC,OAAOC,WAAW,CACvCD,OAAOE,OAAO,CAACb,UAAUU,UAAU,EAAEH,GAAG,CAAC,CAAC,CAACO,KAAKC,MAAM,GAAK;gBACzDD;gBACAhB,2BAA2BiB;aAC5B;IAEL;IAEA,IAAIf,UAAUgB,KAAK,IAAI,OAAOhB,UAAUgB,KAAK,KAAK,YAAY,CAACf,MAAMC,OAAO,CAACF,UAAUgB,KAAK,GAAG;QAC7FhB,UAAUgB,KAAK,GAAGlB,2BAA2BE,UAAUgB,KAAK;IAC9D;IAEA,OAAOhB;AACT;AAEA,OAAO,MAAMiB,+BAA+B,CAAClB;IAC3C,gFAAgF;IAChF,MAAMmB,cAAcC,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACtB;IAE9C,kEAAkE;IAClE,OAAOmB,aAAaR,YAAYY;IAChC,OAAOJ,aAAaR,YAAYa;IAChC,OAAOL,aAAaR,YAAYc;IAChC,IAAIvB,MAAMC,OAAO,CAACgB,YAAYO,QAAQ,GAAG;QACvCP,YAAYO,QAAQ,GAAGP,YAAYO,QAAQ,CAACC,MAAM,CAAC,CAACC,QAAUA,UAAU;QACxE,IAAIT,YAAYO,QAAQ,CAACG,MAAM,KAAK,GAAG;YACrC,OAAOV,YAAYO,QAAQ;QAC7B;IACF;IAEA,MAAMI,mBAAmB/B,2BAA2BoB;IAEpD,MAAMY,oBAAoBnC,gBAAgBkC;IAE1C,qCAAqC;IACrC,MAAME,kBAAkBnC,GAAGoC,eAAe,CAACF,mBAAmB;QAC5DG,iBAAiB;YACfC,QAAQtC,GAAGuC,UAAU,CAACC,QAAQ;YAC9BC,gBAAgB;YAChBC,QAAQ;YACRC,QAAQ3C,GAAG4C,YAAY,CAACC,MAAM;QAChC;IACF;IAEA;;;;;;;GAOC,GACD,8DAA8D;IAC9D,OAAO,IAAIC,SAAS,KAAK,CAAC,OAAO,EAAEX,gBAAgBY,UAAU,EAAE,EAAE9C;AACnE,EAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/plugin-mcp",
-  "version": "3.72.0-canary.1",
+  "version": "3.72.0-canary.3",
   "description": "MCP (Model Context Protocol) capabilities with Payload",
   "keywords": [
     "plugin",
@@ -45,10 +45,10 @@
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "3.28.0",
-    "payload": "3.72.0-canary.1"
+    "payload": "3.72.0-canary.3"
   },
   "peerDependencies": {
-    "payload": "3.72.0-canary.1"
+    "payload": "3.72.0-canary.3"
   },
   "homepage:": "https://payloadcms.com",
   "scripts": {

package/src/mcp/getMcpHandler.ts

@@ -44,7 +44,7 @@ export const getMCPHandler = (
   req: PayloadRequest,
 ) => {
   const { payload } = req
-  const configSchema = configToJSONSchema(payload.config)
+  const configSchema = configToJSONSchema(payload.config, payload.db.defaultIDType, req.i18n)
 
   // Handler wrapper that injects req before the _extra argument
   const wrapHandler = (handler: (...args: any[]) => any) => {

package/src/mcp/tools/resource/create.ts

@@ -20,6 +20,7 @@ export const createResourceTool = (
 ) => {
   const tool = async (
     data: string,
+    depth: number = 0,
     draft: boolean,
     locale?: string,
     fallbackLocale?: string,
@@ -58,6 +59,7 @@ export const createResourceTool = (
       const result = await payload.create({
         collection: collectionSlug,
         data: parsedData,
+        depth,
         draft,
         overrideAccess: false,
         req,
@@ -122,6 +124,14 @@ ${JSON.stringify(result, null, 2)}
     // Create a new schema that combines the converted fields with create-specific parameters
     const createResourceSchema = z.object({
       ...convertedFields.shape,
+      depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .default(0)
+        .describe('How many levels deep to populate relationships in response'),
       draft: z
         .boolean()
         .optional()
@@ -144,10 +154,11 @@ ${JSON.stringify(result, null, 2)}
       `${collections?.[collectionSlug]?.description || toolSchemas.createResource.description.trim()}`,
       createResourceSchema.shape,
       async (params: Record<string, unknown>) => {
-        const { draft, fallbackLocale, locale, ...fieldData } = params
+        const { depth, draft, fallbackLocale, locale, ...fieldData } = params
         const data = JSON.stringify(fieldData)
         return await tool(
           data,
+          depth as number,
           draft as boolean,
           locale as string | undefined,
           fallbackLocale as string | undefined,

package/src/mcp/tools/resource/find.ts

@@ -20,6 +20,7 @@ export const findResourceTool = (
     page: number = 1,
     sort?: string,
     where?: string,
+    depth: number = 0,
     locale?: string,
     fallbackLocale?: string,
     draft?: boolean,
@@ -67,6 +68,7 @@ export const findResourceTool = (
           const doc = await payload.findByID({
             id,
             collection: collectionSlug,
+            depth,
             overrideAccess: false,
             req,
             user,
@@ -121,6 +123,7 @@ ${JSON.stringify(doc, null, 2)}`,
       // Otherwise, use find to get multiple documents
       const findOptions: Parameters<typeof payload.find>[0] = {
         collection: collectionSlug,
+        depth,
         limit,
         overrideAccess: false,
         page,
@@ -199,8 +202,8 @@ Page: ${result.page} of ${result.totalPages}
       `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,
       `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,
       toolSchemas.findResources.parameters.shape,
-      async ({ id, draft, fallbackLocale, limit, locale, page, sort, where }) => {
-        return await tool(id, limit, page, sort, where, locale, fallbackLocale, draft)
+      async ({ id, depth, draft, fallbackLocale, limit, locale, page, sort, where }) => {
+        return await tool(id, limit, page, sort, where, depth, locale, fallbackLocale, draft)
       },
     )
   }

package/src/mcp/tools/schemas.ts

@@ -34,6 +34,14 @@ export const toolSchemas = {
         .describe(
           'Optional: specific document ID to retrieve. If not provided, returns all documents',
         ),
+      depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .default(0)
+        .describe('How many levels deep to populate relationships (default: 0)'),
       draft: z
         .boolean()
         .optional()
@@ -82,6 +90,14 @@ export const toolSchemas = {
     description: 'Create a document in a collection.',
     parameters: z.object({
       data: z.string().describe('JSON string containing the data for the new document'),
+      depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .default(0)
+        .describe('How many levels deep to populate relationships in response (default: 0)'),
       draft: z
         .boolean()
         .optional()

package/src/utils/convertCollectionSchemaToZod.ts

@@ -4,12 +4,70 @@ import { jsonSchemaToZod } from 'json-schema-to-zod'
 import * as ts from 'typescript'
 import { z } from 'zod'
 
+/**
+ * Recursively processes JSON schema properties to simplify relationship fields.
+ * For create/update validation we only need to accept IDs (string/number),
+ * not populated objects. This removes the $ref option from oneOf unions
+ * that represent relationship fields, leaving only the ID shape.
+ *
+ * NOTE: This function must operate on a cloned schema to avoid mutating
+ * the original JSON schema used for tool listing.
+ */
+function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {
+  if (!schema || typeof schema !== 'object') {
+    return schema
+  }
+
+  const processed = { ...schema }
+
+  if (Array.isArray(processed.oneOf)) {
+    const hasRef = processed.oneOf.some(
+      (option) => option && typeof option === 'object' && '$ref' in option,
+    )
+
+    processed.oneOf = processed.oneOf.map((option) => {
+      if (option && typeof option === 'object' && '$ref' in option) {
+        // Replace unresolved $ref with a permissive object schema to keep the union shape
+        return { type: 'object', additionalProperties: true }
+      }
+      return simplifyRelationshipFields(option)
+    })
+  }
+
+  if (processed.properties && typeof processed.properties === 'object') {
+    processed.properties = Object.fromEntries(
+      Object.entries(processed.properties).map(([key, value]) => [
+        key,
+        simplifyRelationshipFields(value),
+      ]),
+    )
+  }
+
+  if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {
+    processed.items = simplifyRelationshipFields(processed.items)
+  }
+
+  return processed
+}
+
 export const convertCollectionSchemaToZod = (schema: JSONSchema4) => {
+  // Clone to avoid mutating the original schema (used elsewhere for tool listing)
+  const schemaClone = JSON.parse(JSON.stringify(schema)) as JSONSchema4
+
   // Remove properties that should not be included in the Zod schema
-  delete schema?.properties?.createdAt
-  delete schema?.properties?.updatedAt
+  delete schemaClone?.properties?.id
+  delete schemaClone?.properties?.createdAt
+  delete schemaClone?.properties?.updatedAt
+  if (Array.isArray(schemaClone.required)) {
+    schemaClone.required = schemaClone.required.filter((field) => field !== 'id')
+    if (schemaClone.required.length === 0) {
+      delete schemaClone.required
+    }
+  }
+
+  const simplifiedSchema = simplifyRelationshipFields(schemaClone)
 
-  const zodSchemaAsString = jsonSchemaToZod(schema)
+  const zodSchemaAsString = jsonSchemaToZod(simplifiedSchema)
 
   // Transpile TypeScript to JavaScript
   const transpileResult = ts.transpileModule(zodSchemaAsString, {