@payloadcms/plugin-mcp 4.0.0-internal.5f0cd13 → 4.0.0-internal.a0ef1b8

package/dist/@types/assets.d.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=assets.d.js.map

package/dist/@types/assets.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/@types/assets.d.ts"],"names":[],"mappings":""}

package/dist/collection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAI3D,eAAO,MAAM,oBAAoB,GAAI,mBAElC;IACD,YAAY,EAAE,wBAAwB,CAAA;CACvC,KAAG,gBAoDH,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAI3D,eAAO,MAAM,oBAAoB,GAAI,mBAElC;IACD,YAAY,EAAE,wBAAwB,CAAA;CACvC,KAAG,gBAqDH,CAAA"}

package/dist/collection/index.js

@@ -51,7 +51,8 @@ export const getAPIKeysCollection = ({ pluginConfig })=>{
         labels: {
             plural: 'API Keys',
             singular: 'API Key'
-        }
+        },
+        versions: false
     };
     return pluginConfig.overrideApiKeyCollection ? pluginConfig.overrideApiKeyCollection(collection) : collection;
 };

package/dist/collection/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/collection/index.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nimport type { SanitizedMCPPluginConfig } from '../types.js'\n\nimport { getAccessField } from './getAccessField.js'\n\nexport const getAPIKeysCollection = ({\n  pluginConfig,\n}: {\n  pluginConfig: SanitizedMCPPluginConfig\n}): CollectionConfig => {\n  const collection: CollectionConfig = {\n    slug: 'payload-mcp-api-keys',\n    admin: {\n      description:\n        'API keys control which collections, resources, tools, and prompts MCP clients can access',\n      group: 'MCP',\n      useAsTitle: 'label',\n    },\n    auth: {\n      disableLocalStrategy: true,\n      useAPIKey: true,\n    },\n    fields: [\n      {\n        name: 'user',\n        type: 'relationship',\n        admin: { description: 'The user that the API key is associated with.' },\n        relationTo: pluginConfig.userCollection,\n        required: true,\n      },\n      {\n        name: 'label',\n        type: 'text',\n        admin: { description: 'A useful label for the API key.' },\n      },\n      {\n        name: 'description',\n        type: 'text',\n        admin: { description: 'The purpose of the API key.' },\n      },\n      {\n        name: 'overrideAccess',\n        type: 'checkbox',\n        admin: {\n          description:\n            'When checked, this key bypasses Payload access control on every operation it performs. Leave unchecked unless you have a specific reason.',\n        },\n        defaultValue: false,\n        label: 'Override access control',\n      },\n      getAccessField({ pluginConfig }),\n    ],\n    labels: {\n      plural: 'API Keys',\n      singular: 'API Key',\n    },\n  }\n\n  return pluginConfig.overrideApiKeyCollection\n    ? pluginConfig.overrideApiKeyCollection(collection)\n    : collection\n}\n"],"names":["getAccessField","getAPIKeysCollection","pluginConfig","collection","slug","admin","description","group","useAsTitle","auth","disableLocalStrategy","useAPIKey","fields","name","type","relationTo","userCollection","required","defaultValue","label","labels","plural","singular","overrideApiKeyCollection"],"mappings":"AAIA,SAASA,cAAc,QAAQ,sBAAqB;AAEpD,OAAO,MAAMC,uBAAuB,CAAC,EACnCC,YAAY,EAGb;IACC,MAAMC,aAA+B;QACnCC,MAAM;QACNC,OAAO;YACLC,aACE;YACFC,OAAO;YACPC,YAAY;QACd;QACAC,MAAM;YACJC,sBAAsB;YACtBC,WAAW;QACb;QACAC,QAAQ;YACN;gBACEC,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAAgD;gBACtES,YAAYb,aAAac,cAAc;gBACvCC,UAAU;YACZ;YACA;gBACEJ,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAAkC;YAC1D;YACA;gBACEO,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAA8B;YACtD;YACA;gBACEO,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBACLC,aACE;gBACJ;gBACAY,cAAc;gBACdC,OAAO;YACT;YACAnB,eAAe;gBAAEE;YAAa;SAC/B;QACDkB,QAAQ;YACNC,QAAQ;YACRC,UAAU;QACZ;IACF;IAEA,OAAOpB,aAAaqB,wBAAwB,GACxCrB,aAAaqB,wBAAwB,CAACpB,cACtCA;AACN,EAAC"}
+{"version":3,"sources":["../../src/collection/index.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nimport type { SanitizedMCPPluginConfig } from '../types.js'\n\nimport { getAccessField } from './getAccessField.js'\n\nexport const getAPIKeysCollection = ({\n  pluginConfig,\n}: {\n  pluginConfig: SanitizedMCPPluginConfig\n}): CollectionConfig => {\n  const collection: CollectionConfig = {\n    slug: 'payload-mcp-api-keys',\n    admin: {\n      description:\n        'API keys control which collections, resources, tools, and prompts MCP clients can access',\n      group: 'MCP',\n      useAsTitle: 'label',\n    },\n    auth: {\n      disableLocalStrategy: true,\n      useAPIKey: true,\n    },\n    fields: [\n      {\n        name: 'user',\n        type: 'relationship',\n        admin: { description: 'The user that the API key is associated with.' },\n        relationTo: pluginConfig.userCollection,\n        required: true,\n      },\n      {\n        name: 'label',\n        type: 'text',\n        admin: { description: 'A useful label for the API key.' },\n      },\n      {\n        name: 'description',\n        type: 'text',\n        admin: { description: 'The purpose of the API key.' },\n      },\n      {\n        name: 'overrideAccess',\n        type: 'checkbox',\n        admin: {\n          description:\n            'When checked, this key bypasses Payload access control on every operation it performs. Leave unchecked unless you have a specific reason.',\n        },\n        defaultValue: false,\n        label: 'Override access control',\n      },\n      getAccessField({ pluginConfig }),\n    ],\n    labels: {\n      plural: 'API Keys',\n      singular: 'API Key',\n    },\n    versions: false,\n  }\n\n  return pluginConfig.overrideApiKeyCollection\n    ? pluginConfig.overrideApiKeyCollection(collection)\n    : collection\n}\n"],"names":["getAccessField","getAPIKeysCollection","pluginConfig","collection","slug","admin","description","group","useAsTitle","auth","disableLocalStrategy","useAPIKey","fields","name","type","relationTo","userCollection","required","defaultValue","label","labels","plural","singular","versions","overrideApiKeyCollection"],"mappings":"AAIA,SAASA,cAAc,QAAQ,sBAAqB;AAEpD,OAAO,MAAMC,uBAAuB,CAAC,EACnCC,YAAY,EAGb;IACC,MAAMC,aAA+B;QACnCC,MAAM;QACNC,OAAO;YACLC,aACE;YACFC,OAAO;YACPC,YAAY;QACd;QACAC,MAAM;YACJC,sBAAsB;YACtBC,WAAW;QACb;QACAC,QAAQ;YACN;gBACEC,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAAgD;gBACtES,YAAYb,aAAac,cAAc;gBACvCC,UAAU;YACZ;YACA;gBACEJ,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAAkC;YAC1D;YACA;gBACEO,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBAAEC,aAAa;gBAA8B;YACtD;YACA;gBACEO,MAAM;gBACNC,MAAM;gBACNT,OAAO;oBACLC,aACE;gBACJ;gBACAY,cAAc;gBACdC,OAAO;YACT;YACAnB,eAAe;gBAAEE;YAAa;SAC/B;QACDkB,QAAQ;YACNC,QAAQ;YACRC,UAAU;QACZ;QACAC,UAAU;IACZ;IAEA,OAAOrB,aAAasB,wBAAwB,GACxCtB,aAAasB,wBAAwB,CAACrB,cACtCA;AACN,EAAC"}

package/dist/mcp/buildMcpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildMcpServer.d.ts","sourceRoot":"","sources":["../../src/mcp/buildMcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,8BAA8B,CAAA;AAC5E,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAE3E,OAAO,KAAK,EACV,aAAa,EAIb,wBAAwB,EACzB,MAAM,aAAa,CAAA;AAiBpB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,uCAI5B;IACD,aAAa,EAAE,aAAa,CAAA;IAC5B,YAAY,EAAE,wBAAwB,CAAA;IACtC,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,SAmLH,CAAA"}
+{"version":3,"file":"buildMcpServer.d.ts","sourceRoot":"","sources":["../../src/mcp/buildMcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,8BAA8B,CAAA;AAC5E,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAErF,OAAO,KAAK,EACV,aAAa,EAIb,wBAAwB,EACzB,MAAM,aAAa,CAAA;AAiBpB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,uCAI5B;IACD,aAAa,EAAE,aAAa,CAAA;IAC5B,YAAY,EAAE,wBAAwB,CAAA;IACtC,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,SAwLH,CAAA"}

package/dist/mcp/buildMcpServer.js

@@ -1,5 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/server';
-import { APIError, configToJSONSchema } from 'payload';
+import { APIError, entityToStandaloneJSONSchema } from 'payload';
 import { toCamelCase } from '../utils/camelCase.js';
 import { getLogger } from '../utils/getLogger.js';
 import { getCollectionVirtualFieldNames, getGlobalVirtualFieldNames } from '../utils/getVirtualFieldNames.js';
@@ -36,9 +36,6 @@ import { toStandardSchema } from '../utils/toStandardSchema.js';
         const { doc: _doc, ...rest } = overridden;
         return rest;
     };
-    const { jsonSchema: configSchema } = configToJSONSchema(req.payload.config, req.payload.db.defaultIDType, req.i18n, {
-        forceInlineBlocks: true
-    });
     try {
         for (const item of authorizedMCP.items){
             switch(item.type){
@@ -48,11 +45,16 @@ import { toStandardSchema } from '../utils/toStandardSchema.js';
                         const name = wireName(item.key, item.collectionSlug);
                         let inputSchema = tool.input;
                         if (typeof inputSchema === 'function') {
-                            const raw = configSchema.definitions?.[item.collectionSlug];
-                            if (!raw) {
+                            const collection = req.payload.collections[item.collectionSlug]?.config;
+                            if (!collection) {
                                 throw new APIError(`Collection schema not found for slug: ${item.collectionSlug}`, 500);
                             }
-                            const collectionSchema = removeVirtualFieldsFromSchema(JSON.parse(JSON.stringify(raw)), getCollectionVirtualFieldNames(req.payload.config, item.collectionSlug));
+                            const collectionSchema = removeVirtualFieldsFromSchema(entityToStandaloneJSONSchema({
+                                config: req.payload.config,
+                                defaultIDType: req.payload.db.defaultIDType,
+                                entity: collection,
+                                i18n: req.i18n
+                            }), getCollectionVirtualFieldNames(req.payload.config, item.collectionSlug));
                             inputSchema = inputSchema({
                                 collectionSchema
                             });
@@ -76,11 +78,16 @@ import { toStandardSchema } from '../utils/toStandardSchema.js';
                         const name = wireName(item.key, item.globalSlug);
                         let inputSchema = tool.input;
                         if (typeof inputSchema === 'function') {
-                            const raw = configSchema.definitions?.[item.globalSlug];
-                            if (!raw) {
+                            const globalEntity = req.payload.config.globals.find((globalConfig)=>globalConfig.slug === item.globalSlug);
+                            if (!globalEntity) {
                                 throw new APIError(`Global schema not found for slug: ${item.globalSlug}`, 500);
                             }
-                            const globalSchema = removeVirtualFieldsFromSchema(JSON.parse(JSON.stringify(raw)), getGlobalVirtualFieldNames(req.payload.config, item.globalSlug));
+                            const globalSchema = removeVirtualFieldsFromSchema(entityToStandaloneJSONSchema({
+                                config: req.payload.config,
+                                defaultIDType: req.payload.db.defaultIDType,
+                                entity: globalEntity,
+                                i18n: req.i18n
+                            }), getGlobalVirtualFieldNames(req.payload.config, item.globalSlug));
                             inputSchema = inputSchema({
                                 globalSchema
                             });

package/dist/mcp/buildMcpServer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/buildMcpServer.ts"],"sourcesContent":["import { McpServer, type ServerContext } from '@modelcontextprotocol/server'\nimport { APIError, configToJSONSchema, type PayloadRequest } from 'payload'\n\nimport type {\n  AuthorizedMCP,\n  JsonSchemaType,\n  MCPResponseOverride,\n  MCPToolResponse,\n  SanitizedMCPPluginConfig,\n} from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\nimport { getLogger } from '../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  getGlobalVirtualFieldNames,\n} from '../utils/getVirtualFieldNames.js'\nimport { removeVirtualFieldsFromSchema } from '../utils/schemaConversion/removeVirtualFieldsFromSchema.js'\nimport { toStandardSchema } from '../utils/toStandardSchema.js'\n\n/** `findPosts`, `updateSiteSettings` — auto-prefixed wire name for collection/global tools. */\nconst wireName = (key: string, slug: string): string => {\n  const camel = toCamelCase(slug)\n  return `${key}${camel.charAt(0).toUpperCase()}${camel.slice(1)}`\n}\n\n/**\n * Transport-agnostic core: registers every authorized MCP item onto a fresh\n * `McpServer` and returns it. The caller is responsible for picking a transport\n * (`WebStandardStreamableHTTPServerTransport`, `StdioServerTransport`, …) and\n * calling `server.connect(transport)`.\n *\n * `req` is the request context handlers see. For HTTP it's the live\n * `PayloadRequest` derived from the incoming HTTP request; for stdio it's a\n * synthesized one built via `createLocalReq`.\n */\nexport const buildMcpServer = ({\n  authorizedMCP,\n  pluginConfig,\n  req,\n}: {\n  authorizedMCP: AuthorizedMCP\n  pluginConfig: SanitizedMCPPluginConfig\n  req: PayloadRequest\n}): McpServer => {\n  const serverOptions = pluginConfig.mcp?.serverOptions || {}\n  const server = new McpServer(\n    { name: 'Payload MCP Server', version: '1.0.0', ...serverOptions.serverInfo },\n    serverOptions.options,\n  )\n\n  const logger = getLogger({ payload: req.payload })\n\n  /**\n   * Wrap a tool handler's response with the tool's `overrideResponse`, then\n   * strip the internal `doc` field so it doesn't leak onto the wire.\n   */\n  const finalizeToolResponse = (\n    response: MCPToolResponse,\n    overrideResponse?: MCPResponseOverride,\n  ): MCPToolResponse => {\n    const overridden = overrideResponse?.(response, response.doc ?? {}, req) ?? response\n    const { doc: _doc, ...rest } = overridden\n    return rest\n  }\n\n  const { jsonSchema: configSchema } = configToJSONSchema(\n    req.payload.config,\n    req.payload.db.defaultIDType,\n    req.i18n,\n    { forceInlineBlocks: true },\n  ) as { jsonSchema: JsonSchemaType; typeStringDefinitions: Set<string> }\n\n  try {\n    for (const item of authorizedMCP.items) {\n      switch (item.type) {\n        case 'collectionTool': {\n          const tool = item.tool\n          const name = wireName(item.key, item.collectionSlug)\n          let inputSchema = tool.input\n          if (typeof inputSchema === 'function') {\n            const raw = configSchema.definitions?.[item.collectionSlug]\n            if (!raw) {\n              throw new APIError(\n                `Collection schema not found for slug: ${item.collectionSlug}`,\n                500,\n              )\n            }\n            const collectionSchema = removeVirtualFieldsFromSchema(\n              JSON.parse(JSON.stringify(raw)) as JsonSchemaType,\n              getCollectionVirtualFieldNames(req.payload.config, item.collectionSlug),\n            )\n            inputSchema = inputSchema({ collectionSchema })\n          }\n          server.registerTool(\n            name,\n            {\n              description: tool.description,\n              inputSchema: inputSchema ? toStandardSchema(inputSchema) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  collectionSlug: item.collectionSlug,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${name} Registered.`)\n          break\n        }\n        case 'globalTool': {\n          const tool = item.tool\n          const name = wireName(item.key, item.globalSlug)\n          let inputSchema = tool.input\n          if (typeof inputSchema === 'function') {\n            const raw = configSchema.definitions?.[item.globalSlug]\n            if (!raw) {\n              throw new APIError(`Global schema not found for slug: ${item.globalSlug}`, 500)\n            }\n            const globalSchema = removeVirtualFieldsFromSchema(\n              JSON.parse(JSON.stringify(raw)) as JsonSchemaType,\n              getGlobalVirtualFieldNames(req.payload.config, item.globalSlug),\n            )\n\n            inputSchema = inputSchema({ globalSchema })\n          }\n          server.registerTool(\n            name,\n            {\n              description: tool.description,\n              inputSchema: inputSchema ? toStandardSchema(inputSchema) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  globalSlug: item.globalSlug,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${name} Registered.`)\n          break\n        }\n        case 'prompt': {\n          const prompt = item.prompt\n          server.registerPrompt(\n            item.key,\n            {\n              argsSchema: prompt.argsSchema ? toStandardSchema(prompt.argsSchema) : undefined,\n              description: prompt.description,\n              title: prompt.title,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              prompt.handler({\n                input: (input ?? {}) as Record<string, unknown>,\n                req,\n                serverContext: ctx,\n              }),\n          )\n          logger.info(`✅ Prompt: ${prompt.title} Registered.`)\n          break\n        }\n        case 'resource': {\n          const resource = item.resource\n          server.registerResource(\n            item.key,\n            // @ts-expect-error - Overload type ambiguity (string OR ResourceTemplate is valid)\n            resource.uri,\n            {\n              description: resource.description,\n              mimeType: resource.mimeType,\n              title: resource.title,\n            },\n            // Static URIs call (uri, ctx); ResourceTemplates call (uri, params, ctx).\n            // The rest-params shape lets us collect either signature uniformly.\n            async (...sdkArgs: unknown[]) => {\n              const ctx = sdkArgs[sdkArgs.length - 1] as ServerContext\n              const uri = sdkArgs[0] as URL\n              const params = (sdkArgs.length > 2 ? sdkArgs[1] : {}) as Record<string, string>\n              return resource.handler({ params, req, serverContext: ctx, uri })\n            },\n          )\n          logger.info(`✅ Resource: ${resource.title} Registered.`)\n          break\n        }\n        case 'tool': {\n          const tool = item.tool\n          server.registerTool(\n            item.key,\n            {\n              description: tool.description,\n              inputSchema: tool.input ? toStandardSchema(tool.input) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${item.key} Registered.`)\n          break\n        }\n      }\n    }\n  } catch (error) {\n    throw new APIError(`Error initializing MCP handler: ${String(error)}`, 500)\n  }\n\n  return server\n}\n"],"names":["McpServer","APIError","configToJSONSchema","toCamelCase","getLogger","getCollectionVirtualFieldNames","getGlobalVirtualFieldNames","removeVirtualFieldsFromSchema","toStandardSchema","wireName","key","slug","camel","charAt","toUpperCase","slice","buildMcpServer","authorizedMCP","pluginConfig","req","serverOptions","mcp","server","name","version","serverInfo","options","logger","payload","finalizeToolResponse","response","overrideResponse","overridden","doc","_doc","rest","jsonSchema","configSchema","config","db","defaultIDType","i18n","forceInlineBlocks","item","items","type","tool","collectionSlug","inputSchema","input","raw","definitions","collectionSchema","JSON","parse","stringify","registerTool","description","undefined","ctx","handler","serverContext","info","globalSlug","globalSchema","prompt","registerPrompt","argsSchema","title","resource","registerResource","uri","mimeType","sdkArgs","length","params","error","String"],"mappings":"AAAA,SAASA,SAAS,QAA4B,+BAA8B;AAC5E,SAASC,QAAQ,EAAEC,kBAAkB,QAA6B,UAAS;AAU3E,SAASC,WAAW,QAAQ,wBAAuB;AACnD,SAASC,SAAS,QAAQ,wBAAuB;AACjD,SACEC,8BAA8B,EAC9BC,0BAA0B,QACrB,mCAAkC;AACzC,SAASC,6BAA6B,QAAQ,6DAA4D;AAC1G,SAASC,gBAAgB,QAAQ,+BAA8B;AAE/D,6FAA6F,GAC7F,MAAMC,WAAW,CAACC,KAAaC;IAC7B,MAAMC,QAAQT,YAAYQ;IAC1B,OAAO,GAAGD,MAAME,MAAMC,MAAM,CAAC,GAAGC,WAAW,KAAKF,MAAMG,KAAK,CAAC,IAAI;AAClE;AAEA;;;;;;;;;CASC,GACD,OAAO,MAAMC,iBAAiB,CAAC,EAC7BC,aAAa,EACbC,YAAY,EACZC,GAAG,EAKJ;IACC,MAAMC,gBAAgBF,aAAaG,GAAG,EAAED,iBAAiB,CAAC;IAC1D,MAAME,SAAS,IAAItB,UACjB;QAAEuB,MAAM;QAAsBC,SAAS;QAAS,GAAGJ,cAAcK,UAAU;IAAC,GAC5EL,cAAcM,OAAO;IAGvB,MAAMC,SAASvB,UAAU;QAAEwB,SAAST,IAAIS,OAAO;IAAC;IAEhD;;;GAGC,GACD,MAAMC,uBAAuB,CAC3BC,UACAC;QAEA,MAAMC,aAAaD,mBAAmBD,UAAUA,SAASG,GAAG,IAAI,CAAC,GAAGd,QAAQW;QAC5E,MAAM,EAAEG,KAAKC,IAAI,EAAE,GAAGC,MAAM,GAAGH;QAC/B,OAAOG;IACT;IAEA,MAAM,EAAEC,YAAYC,YAAY,EAAE,GAAGnC,mBACnCiB,IAAIS,OAAO,CAACU,MAAM,EAClBnB,IAAIS,OAAO,CAACW,EAAE,CAACC,aAAa,EAC5BrB,IAAIsB,IAAI,EACR;QAAEC,mBAAmB;IAAK;IAG5B,IAAI;QACF,KAAK,MAAMC,QAAQ1B,cAAc2B,KAAK,CAAE;YACtC,OAAQD,KAAKE,IAAI;gBACf,KAAK;oBAAkB;wBACrB,MAAMC,OAAOH,KAAKG,IAAI;wBACtB,MAAMvB,OAAOd,SAASkC,KAAKjC,GAAG,EAAEiC,KAAKI,cAAc;wBACnD,IAAIC,cAAcF,KAAKG,KAAK;wBAC5B,IAAI,OAAOD,gBAAgB,YAAY;4BACrC,MAAME,MAAMb,aAAac,WAAW,EAAE,CAACR,KAAKI,cAAc,CAAC;4BAC3D,IAAI,CAACG,KAAK;gCACR,MAAM,IAAIjD,SACR,CAAC,sCAAsC,EAAE0C,KAAKI,cAAc,EAAE,EAC9D;4BAEJ;4BACA,MAAMK,mBAAmB7C,8BACvB8C,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACL,OAC1B7C,+BAA+Bc,IAAIS,OAAO,CAACU,MAAM,EAAEK,KAAKI,cAAc;4BAExEC,cAAcA,YAAY;gCAAEI;4BAAiB;wBAC/C;wBACA9B,OAAOkC,YAAY,CACjBjC,MACA;4BACEkC,aAAaX,KAAKW,WAAW;4BAC7BT,aAAaA,cAAcxC,iBAAiBwC,eAAeU;wBAC7D,GACA,OAAOT,OAAgBU,MACrB9B,qBACE,MAAMiB,KAAKc,OAAO,CAAC;gCACjB3C;gCACA8B,gBAAgBJ,KAAKI,cAAc;gCACnCE,OAAQA,SAAS,CAAC;gCAClB9B;gCACA0C,eAAeF;4BACjB,IACAb,KAAKf,gBAAgB;wBAG3BJ,OAAOmC,IAAI,CAAC,CAAC,QAAQ,EAAEvC,KAAK,YAAY,CAAC;wBACzC;oBACF;gBACA,KAAK;oBAAc;wBACjB,MAAMuB,OAAOH,KAAKG,IAAI;wBACtB,MAAMvB,OAAOd,SAASkC,KAAKjC,GAAG,EAAEiC,KAAKoB,UAAU;wBAC/C,IAAIf,cAAcF,KAAKG,KAAK;wBAC5B,IAAI,OAAOD,gBAAgB,YAAY;4BACrC,MAAME,MAAMb,aAAac,WAAW,EAAE,CAACR,KAAKoB,UAAU,CAAC;4BACvD,IAAI,CAACb,KAAK;gCACR,MAAM,IAAIjD,SAAS,CAAC,kCAAkC,EAAE0C,KAAKoB,UAAU,EAAE,EAAE;4BAC7E;4BACA,MAAMC,eAAezD,8BACnB8C,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACL,OAC1B5C,2BAA2Ba,IAAIS,OAAO,CAACU,MAAM,EAAEK,KAAKoB,UAAU;4BAGhEf,cAAcA,YAAY;gCAAEgB;4BAAa;wBAC3C;wBACA1C,OAAOkC,YAAY,CACjBjC,MACA;4BACEkC,aAAaX,KAAKW,WAAW;4BAC7BT,aAAaA,cAAcxC,iBAAiBwC,eAAeU;wBAC7D,GACA,OAAOT,OAAgBU,MACrB9B,qBACE,MAAMiB,KAAKc,OAAO,CAAC;gCACjB3C;gCACA8C,YAAYpB,KAAKoB,UAAU;gCAC3Bd,OAAQA,SAAS,CAAC;gCAClB9B;gCACA0C,eAAeF;4BACjB,IACAb,KAAKf,gBAAgB;wBAG3BJ,OAAOmC,IAAI,CAAC,CAAC,QAAQ,EAAEvC,KAAK,YAAY,CAAC;wBACzC;oBACF;gBACA,KAAK;oBAAU;wBACb,MAAM0C,SAAStB,KAAKsB,MAAM;wBAC1B3C,OAAO4C,cAAc,CACnBvB,KAAKjC,GAAG,EACR;4BACEyD,YAAYF,OAAOE,UAAU,GAAG3D,iBAAiByD,OAAOE,UAAU,IAAIT;4BACtED,aAAaQ,OAAOR,WAAW;4BAC/BW,OAAOH,OAAOG,KAAK;wBACrB,GACA,OAAOnB,OAAgBU,MACrBM,OAAOL,OAAO,CAAC;gCACbX,OAAQA,SAAS,CAAC;gCAClB9B;gCACA0C,eAAeF;4BACjB;wBAEJhC,OAAOmC,IAAI,CAAC,CAAC,UAAU,EAAEG,OAAOG,KAAK,CAAC,YAAY,CAAC;wBACnD;oBACF;gBACA,KAAK;oBAAY;wBACf,MAAMC,WAAW1B,KAAK0B,QAAQ;wBAC9B/C,OAAOgD,gBAAgB,CACrB3B,KAAKjC,GAAG,EACR,mFAAmF;wBACnF2D,SAASE,GAAG,EACZ;4BACEd,aAAaY,SAASZ,WAAW;4BACjCe,UAAUH,SAASG,QAAQ;4BAC3BJ,OAAOC,SAASD,KAAK;wBACvB,GACA,0EAA0E;wBAC1E,oEAAoE;wBACpE,OAAO,GAAGK;4BACR,MAAMd,MAAMc,OAAO,CAACA,QAAQC,MAAM,GAAG,EAAE;4BACvC,MAAMH,MAAME,OAAO,CAAC,EAAE;4BACtB,MAAME,SAAUF,QAAQC,MAAM,GAAG,IAAID,OAAO,CAAC,EAAE,GAAG,CAAC;4BACnD,OAAOJ,SAAST,OAAO,CAAC;gCAAEe;gCAAQxD;gCAAK0C,eAAeF;gCAAKY;4BAAI;wBACjE;wBAEF5C,OAAOmC,IAAI,CAAC,CAAC,YAAY,EAAEO,SAASD,KAAK,CAAC,YAAY,CAAC;wBACvD;oBACF;gBACA,KAAK;oBAAQ;wBACX,MAAMtB,OAAOH,KAAKG,IAAI;wBACtBxB,OAAOkC,YAAY,CACjBb,KAAKjC,GAAG,EACR;4BACE+C,aAAaX,KAAKW,WAAW;4BAC7BT,aAAaF,KAAKG,KAAK,GAAGzC,iBAAiBsC,KAAKG,KAAK,IAAIS;wBAC3D,GACA,OAAOT,OAAgBU,MACrB9B,qBACE,MAAMiB,KAAKc,OAAO,CAAC;gCACjB3C;gCACAgC,OAAQA,SAAS,CAAC;gCAClB9B;gCACA0C,eAAeF;4BACjB,IACAb,KAAKf,gBAAgB;wBAG3BJ,OAAOmC,IAAI,CAAC,CAAC,QAAQ,EAAEnB,KAAKjC,GAAG,CAAC,YAAY,CAAC;wBAC7C;oBACF;YACF;QACF;IACF,EAAE,OAAOkE,OAAO;QACd,MAAM,IAAI3E,SAAS,CAAC,gCAAgC,EAAE4E,OAAOD,QAAQ,EAAE;IACzE;IAEA,OAAOtD;AACT,EAAC"}
+{"version":3,"sources":["../../src/mcp/buildMcpServer.ts"],"sourcesContent":["import { McpServer, type ServerContext } from '@modelcontextprotocol/server'\nimport { APIError, entityToStandaloneJSONSchema, type PayloadRequest } from 'payload'\n\nimport type {\n  AuthorizedMCP,\n  JsonSchemaType,\n  MCPResponseOverride,\n  MCPToolResponse,\n  SanitizedMCPPluginConfig,\n} from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\nimport { getLogger } from '../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  getGlobalVirtualFieldNames,\n} from '../utils/getVirtualFieldNames.js'\nimport { removeVirtualFieldsFromSchema } from '../utils/schemaConversion/removeVirtualFieldsFromSchema.js'\nimport { toStandardSchema } from '../utils/toStandardSchema.js'\n\n/** `findPosts`, `updateSiteSettings` — auto-prefixed wire name for collection/global tools. */\nconst wireName = (key: string, slug: string): string => {\n  const camel = toCamelCase(slug)\n  return `${key}${camel.charAt(0).toUpperCase()}${camel.slice(1)}`\n}\n\n/**\n * Transport-agnostic core: registers every authorized MCP item onto a fresh\n * `McpServer` and returns it. The caller is responsible for picking a transport\n * (`WebStandardStreamableHTTPServerTransport`, `StdioServerTransport`, …) and\n * calling `server.connect(transport)`.\n *\n * `req` is the request context handlers see. For HTTP it's the live\n * `PayloadRequest` derived from the incoming HTTP request; for stdio it's a\n * synthesized one built via `createLocalReq`.\n */\nexport const buildMcpServer = ({\n  authorizedMCP,\n  pluginConfig,\n  req,\n}: {\n  authorizedMCP: AuthorizedMCP\n  pluginConfig: SanitizedMCPPluginConfig\n  req: PayloadRequest\n}): McpServer => {\n  const serverOptions = pluginConfig.mcp?.serverOptions || {}\n  const server = new McpServer(\n    { name: 'Payload MCP Server', version: '1.0.0', ...serverOptions.serverInfo },\n    serverOptions.options,\n  )\n\n  const logger = getLogger({ payload: req.payload })\n\n  /**\n   * Wrap a tool handler's response with the tool's `overrideResponse`, then\n   * strip the internal `doc` field so it doesn't leak onto the wire.\n   */\n  const finalizeToolResponse = (\n    response: MCPToolResponse,\n    overrideResponse?: MCPResponseOverride,\n  ): MCPToolResponse => {\n    const overridden = overrideResponse?.(response, response.doc ?? {}, req) ?? response\n    const { doc: _doc, ...rest } = overridden\n    return rest\n  }\n\n  try {\n    for (const item of authorizedMCP.items) {\n      switch (item.type) {\n        case 'collectionTool': {\n          const tool = item.tool\n          const name = wireName(item.key, item.collectionSlug)\n          let inputSchema = tool.input\n          if (typeof inputSchema === 'function') {\n            const collection = req.payload.collections[item.collectionSlug]?.config\n            if (!collection) {\n              throw new APIError(\n                `Collection schema not found for slug: ${item.collectionSlug}`,\n                500,\n              )\n            }\n            const collectionSchema = removeVirtualFieldsFromSchema(\n              entityToStandaloneJSONSchema({\n                config: req.payload.config,\n                defaultIDType: req.payload.db.defaultIDType,\n                entity: collection,\n                i18n: req.i18n,\n              }) as unknown as JsonSchemaType,\n              getCollectionVirtualFieldNames(req.payload.config, item.collectionSlug),\n            )\n            inputSchema = inputSchema({ collectionSchema })\n          }\n          server.registerTool(\n            name,\n            {\n              description: tool.description,\n              inputSchema: inputSchema ? toStandardSchema(inputSchema) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  collectionSlug: item.collectionSlug,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${name} Registered.`)\n          break\n        }\n        case 'globalTool': {\n          const tool = item.tool\n          const name = wireName(item.key, item.globalSlug)\n          let inputSchema = tool.input\n          if (typeof inputSchema === 'function') {\n            const globalEntity = req.payload.config.globals.find(\n              (globalConfig) => globalConfig.slug === item.globalSlug,\n            )\n            if (!globalEntity) {\n              throw new APIError(`Global schema not found for slug: ${item.globalSlug}`, 500)\n            }\n            const globalSchema = removeVirtualFieldsFromSchema(\n              entityToStandaloneJSONSchema({\n                config: req.payload.config,\n                defaultIDType: req.payload.db.defaultIDType,\n                entity: globalEntity,\n                i18n: req.i18n,\n              }) as unknown as JsonSchemaType,\n              getGlobalVirtualFieldNames(req.payload.config, item.globalSlug),\n            )\n\n            inputSchema = inputSchema({ globalSchema })\n          }\n          server.registerTool(\n            name,\n            {\n              description: tool.description,\n              inputSchema: inputSchema ? toStandardSchema(inputSchema) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  globalSlug: item.globalSlug,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${name} Registered.`)\n          break\n        }\n        case 'prompt': {\n          const prompt = item.prompt\n          server.registerPrompt(\n            item.key,\n            {\n              argsSchema: prompt.argsSchema ? toStandardSchema(prompt.argsSchema) : undefined,\n              description: prompt.description,\n              title: prompt.title,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              prompt.handler({\n                input: (input ?? {}) as Record<string, unknown>,\n                req,\n                serverContext: ctx,\n              }),\n          )\n          logger.info(`✅ Prompt: ${prompt.title} Registered.`)\n          break\n        }\n        case 'resource': {\n          const resource = item.resource\n          server.registerResource(\n            item.key,\n            // @ts-expect-error - Overload type ambiguity (string OR ResourceTemplate is valid)\n            resource.uri,\n            {\n              description: resource.description,\n              mimeType: resource.mimeType,\n              title: resource.title,\n            },\n            // Static URIs call (uri, ctx); ResourceTemplates call (uri, params, ctx).\n            // The rest-params shape lets us collect either signature uniformly.\n            async (...sdkArgs: unknown[]) => {\n              const ctx = sdkArgs[sdkArgs.length - 1] as ServerContext\n              const uri = sdkArgs[0] as URL\n              const params = (sdkArgs.length > 2 ? sdkArgs[1] : {}) as Record<string, string>\n              return resource.handler({ params, req, serverContext: ctx, uri })\n            },\n          )\n          logger.info(`✅ Resource: ${resource.title} Registered.`)\n          break\n        }\n        case 'tool': {\n          const tool = item.tool\n          server.registerTool(\n            item.key,\n            {\n              description: tool.description,\n              inputSchema: tool.input ? toStandardSchema(tool.input) : undefined,\n            },\n            async (input: unknown, ctx: ServerContext) =>\n              finalizeToolResponse(\n                await tool.handler({\n                  authorizedMCP,\n                  input: (input ?? {}) as Record<string, unknown>,\n                  req,\n                  serverContext: ctx,\n                }),\n                tool.overrideResponse,\n              ),\n          )\n          logger.info(`✅ Tool: ${item.key} Registered.`)\n          break\n        }\n      }\n    }\n  } catch (error) {\n    throw new APIError(`Error initializing MCP handler: ${String(error)}`, 500)\n  }\n\n  return server\n}\n"],"names":["McpServer","APIError","entityToStandaloneJSONSchema","toCamelCase","getLogger","getCollectionVirtualFieldNames","getGlobalVirtualFieldNames","removeVirtualFieldsFromSchema","toStandardSchema","wireName","key","slug","camel","charAt","toUpperCase","slice","buildMcpServer","authorizedMCP","pluginConfig","req","serverOptions","mcp","server","name","version","serverInfo","options","logger","payload","finalizeToolResponse","response","overrideResponse","overridden","doc","_doc","rest","item","items","type","tool","collectionSlug","inputSchema","input","collection","collections","config","collectionSchema","defaultIDType","db","entity","i18n","registerTool","description","undefined","ctx","handler","serverContext","info","globalSlug","globalEntity","globals","find","globalConfig","globalSchema","prompt","registerPrompt","argsSchema","title","resource","registerResource","uri","mimeType","sdkArgs","length","params","error","String"],"mappings":"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"}

package/dist/mcp/builtin/collections/createTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,oBAAoB,4CAmG/B,CAAA"}
+{"version":3,"file":"createTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,oBAAoB,4CAkG/B,CAAA"}

package/dist/mcp/builtin/collections/createTool.js

@@ -3,18 +3,22 @@ import { defineCollectionTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { getCollectionVirtualFieldNames, stripVirtualFields } from '../../../utils/getVirtualFieldNames.js';
 import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-import { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js';
+import { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js';
+import { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js';
 import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js';
 const DEFAULT_DESCRIPTION = 'Create a document in a collection.';
 export const createCollectionTool = defineCollectionTool({
     description: DEFAULT_DESCRIPTION,
-    input: ({ collectionSchema })=>z.object({
-            data: z.fromJSONSchema(prepareCollectionSchema(collectionSchema)).describe('The document fields to create'),
-            depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in response').optional().default(0),
-            draft: z.boolean().describe('Whether to create the document as a draft').optional().default(false),
-            fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
-            locale: z.string().describe('Optional: locale code to create the document in (e.g., "en", "es"). Defaults to the default locale').optional(),
-            select: z.string().describe('Optional: define exactly which fields you\'d like to create (JSON), e.g., \'{"title": "My Post"}\'').optional()
+    input: ({ collectionSchema })=>buildToolInput({
+            controls: {
+                depth: z.number().int().min(0).max(10).describe('How many levels deep to populate relationships in response').optional().default(0),
+                draft: z.boolean().describe('Whether to create the document as a draft').optional().default(false),
+                fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+                locale: z.string().describe('Optional: locale code to create the document in (e.g., "en", "es"). Defaults to the default locale').optional(),
+                select: z.string().describe('Optional: define exactly which fields you\'d like to create (JSON), e.g., \'{"title": "My Post"}\'').optional()
+            },
+            dataDescription: 'The document fields to create',
+            dataSchema: sanitizeEntitySchema(collectionSchema)
         })
 }).handler(async ({ authorizedMCP, collectionSlug, input, req })=>{
     const payload = req.payload;

package/dist/mcp/builtin/collections/createTool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\n\nconst DEFAULT_DESCRIPTION = 'Create a document in a collection.'\n\nexport const createCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ collectionSchema }) =>\n    z.object({\n      data: z\n        .fromJSONSchema(\n          prepareCollectionSchema(collectionSchema) as unknown as z.core.JSONSchema.JSONSchema,\n        )\n        .describe('The document fields to create'),\n      depth: z\n        .number()\n        .int()\n        .min(0)\n        .max(10)\n        .describe('How many levels deep to populate relationships in response')\n        .optional()\n        .default(0),\n      draft: z\n        .boolean()\n        .describe('Whether to create the document as a draft')\n        .optional()\n        .default(false),\n      fallbackLocale: z\n        .string()\n        .describe('Optional: fallback locale code to use when requested locale is not available')\n        .optional(),\n      locale: z\n        .string()\n        .describe(\n          'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        )\n        .optional(),\n      select: z\n        .string()\n        .describe(\n          'Optional: define exactly which fields you\\'d like to create (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n        )\n        .optional(),\n    }),\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { data, depth, draft, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Creating document in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`,\n  )\n\n  try {\n    let parsedData = transformPointDataToPayload(data as Record<string, unknown>)\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    parsedData = stripVirtualFields(parsedData, virtualFieldNames)\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    const result = await payload.create({\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    })\n\n    logger.info(`Successfully created document in ${collectionSlug} with ID: ${result.id}`)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Document created successfully in collection \"${collectionSlug}\"!\\nCreated document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error creating document in ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error creating document in collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","prepareCollectionSchema","transformPointDataToPayload","DEFAULT_DESCRIPTION","createCollectionTool","description","input","collectionSchema","object","data","fromJSONSchema","describe","depth","number","int","min","max","optional","default","draft","boolean","fallbackLocale","string","locale","select","handler","authorizedMCP","collectionSlug","req","payload","logger","info","parsedData","virtualFieldNames","config","selectClause","JSON","parse","warn","content","type","text","result","create","collection","id","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,oBAAoB,QAAQ,yBAAwB;AAC7D,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SACEC,8BAA8B,EAC9BC,kBAAkB,QACb,yCAAwC;AAC/C,SAASC,gBAAgB,QAAQ,qCAAoC;AACrE,SAASC,uBAAuB,QAAQ,6DAA4D;AACpG,SAASC,2BAA2B,QAAQ,gDAA+C;AAE3F,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,uBAAuBR,qBAAqB;IACvDS,aAAaF;IACbG,OAAO,CAAC,EAAEC,gBAAgB,EAAE,GAC1BZ,EAAEa,MAAM,CAAC;YACPC,MAAMd,EACHe,cAAc,CACbT,wBAAwBM,mBAEzBI,QAAQ,CAAC;YACZC,OAAOjB,EACJkB,MAAM,GACNC,GAAG,GACHC,GAAG,CAAC,GACJC,GAAG,CAAC,IACJL,QAAQ,CAAC,8DACTM,QAAQ,GACRC,OAAO,CAAC;YACXC,OAAOxB,EACJyB,OAAO,GACPT,QAAQ,CAAC,6CACTM,QAAQ,GACRC,OAAO,CAAC;YACXG,gBAAgB1B,EACb2B,MAAM,GACNX,QAAQ,CAAC,gFACTM,QAAQ;YACXM,QAAQ5B,EACL2B,MAAM,GACNX,QAAQ,CACP,sGAEDM,QAAQ;YACXO,QAAQ7B,EACL2B,MAAM,GACNX,QAAQ,CACP,sGAEDM,QAAQ;QACb;AACJ,GAAGQ,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,cAAc,EAAErB,KAAK,EAAEsB,GAAG,EAAE;IAC7D,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASjC,UAAU;QAAEgC;IAAQ;IAEnC,MAAM,EAAEpB,IAAI,EAAEG,KAAK,EAAEO,KAAK,EAAEE,cAAc,EAAEE,MAAM,EAAEC,MAAM,EAAE,GAAGlB;IAE/DwB,OAAOC,IAAI,CACT,CAAC,iCAAiC,EAAEJ,iBAAiBJ,SAAS,CAAC,cAAc,EAAEA,QAAQ,GAAG,IAAI;IAGhG,IAAI;QACF,IAAIS,aAAa9B,4BAA4BO;QAC7C,MAAMwB,oBAAoBnC,+BAA+B+B,QAAQK,MAAM,EAAEP;QACzEK,aAAajC,mBAAmBiC,YAAYC;QAE5C,IAAIE;QACJ,IAAIX,QAAQ;YACV,IAAI;gBACFW,eAAeC,KAAKC,KAAK,CAACb;YAC5B,EAAE,OAAM;gBACNM,OAAOQ,IAAI,CAAC,CAAC,4BAA4B,EAAEd,QAAQ;gBACnD,OAAO;oBAAEe,SAAS;wBAAC;4BAAEC,MAAM;4BAAQC,MAAM;wBAAuC;qBAAE;gBAAC;YACrF;QACF;QAEA,MAAMC,SAAS,MAAMb,QAAQc,MAAM,CAAC;YAClCC,YAAYjB;YACZlB,MAAMuB;YACNpB;YACAO;YACAS;YACA,GAAG5B,iBAAiB0B,cAAc;YAClC,GAAIH,SAAS;gBAAEA;YAAO,IAAI,CAAC,CAAC;YAC5B,GAAIF,iBAAiB;gBAAEA;YAAe,IAAI,CAAC,CAAC;YAC5C,GAAIc,eAAe;gBAAEX,QAAQW;YAAa,IAAI,CAAC,CAAC;QAClD;QAEAL,OAAOC,IAAI,CAAC,CAAC,iCAAiC,EAAEJ,eAAe,UAAU,EAAEe,OAAOG,EAAE,EAAE;QAEtF,OAAO;YACLN,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,6CAA6C,EAAEd,eAAe,mCAAmC,EAAES,KAAKU,SAAS,CAACJ,QAAQ,QAAQ,CAAC;gBAC5I;aACD;YACDK,KAAKL;QACP;IACF,EAAE,OAAOM,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DrB,OAAOkB,KAAK,CAAC,CAAC,2BAA2B,EAAErB,eAAe,EAAE,EAAEsB,cAAc;QAC5E,OAAO;YACLV,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,uCAAuC,EAAEd,eAAe,GAAG,EAAEsB,cAAc;gBACpF;aACD;QACH;IACF;AACF,GAAE"}
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/createTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js'\nimport { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\n\nconst DEFAULT_DESCRIPTION = 'Create a document in a collection.'\n\nexport const createCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ collectionSchema }) =>\n    buildToolInput({\n      controls: {\n        depth: z\n          .number()\n          .int()\n          .min(0)\n          .max(10)\n          .describe('How many levels deep to populate relationships in response')\n          .optional()\n          .default(0),\n        draft: z\n          .boolean()\n          .describe('Whether to create the document as a draft')\n          .optional()\n          .default(false),\n        fallbackLocale: z\n          .string()\n          .describe('Optional: fallback locale code to use when requested locale is not available')\n          .optional(),\n        locale: z\n          .string()\n          .describe(\n            'Optional: locale code to create the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n          )\n          .optional(),\n        select: z\n          .string()\n          .describe(\n            'Optional: define exactly which fields you\\'d like to create (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n          )\n          .optional(),\n      },\n      dataDescription: 'The document fields to create',\n      dataSchema: sanitizeEntitySchema(collectionSchema),\n    }),\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { data, depth, draft, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Creating document in collection: ${collectionSlug}${locale ? ` with locale: ${locale}` : ''}`,\n  )\n\n  try {\n    let parsedData = transformPointDataToPayload(data)\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    parsedData = stripVirtualFields(parsedData, virtualFieldNames)\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    const result = await payload.create({\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    })\n\n    logger.info(`Successfully created document in ${collectionSlug} with ID: ${result.id}`)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Document created successfully in collection \"${collectionSlug}\"!\\nCreated document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error creating document in ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error creating document in collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","buildToolInput","sanitizeEntitySchema","transformPointDataToPayload","DEFAULT_DESCRIPTION","createCollectionTool","description","input","collectionSchema","controls","depth","number","int","min","max","describe","optional","default","draft","boolean","fallbackLocale","string","locale","select","dataDescription","dataSchema","handler","authorizedMCP","collectionSlug","req","payload","logger","data","info","parsedData","virtualFieldNames","config","selectClause","JSON","parse","warn","content","type","text","result","create","collection","id","stringify","doc","error","errorMessage","Error","message"],"mappings":"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"}

package/dist/mcp/builtin/collections/updateTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/updateTool.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,oBAAoB,4CA4L/B,CAAA"}
+{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/updateTool.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,oBAAoB,4CAgM/B,CAAA"}

package/dist/mcp/builtin/collections/updateTool.js

@@ -3,33 +3,37 @@ import { defineCollectionTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { getCollectionVirtualFieldNames, stripVirtualFields } from '../../../utils/getVirtualFieldNames.js';
 import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-import { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js';
+import { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js';
+import { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js';
 import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js';
 const DEFAULT_DESCRIPTION = 'Update documents in a collection by ID or where clause.';
 export const updateCollectionTool = defineCollectionTool({
     description: DEFAULT_DESCRIPTION,
     input: ({ collectionSchema })=>{
-        const partialSchema = prepareCollectionSchema(collectionSchema);
+        const partialSchema = sanitizeEntitySchema(collectionSchema);
         // Collection updates do not require all required fields to be passed => delete .required.
         //
         // Local API equivalent: packages/payload/src/collections/operations/local/update.ts#BaseOptions#data:
         // data: DeepPartial<RequiredDataFromCollectionSlug<TSlug>>
         delete partialSchema.required;
-        return z.object({
-            id: z.union([
-                z.string(),
-                z.number()
-            ]).describe('The ID of the document to update').optional(),
-            data: z.fromJSONSchema(partialSchema).describe('The fields to update'),
-            depth: z.number().describe('How many levels deep to populate relationships').optional().default(0),
-            draft: z.boolean().describe('Whether to update the document as a draft').optional().default(false),
-            fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
-            filePath: z.string().describe('File path for file uploads').optional(),
-            locale: z.string().describe('Optional: locale code to update the document in (e.g., "en", "es"). Defaults to the default locale').optional(),
-            overrideLock: z.boolean().describe('Whether to override document locks').optional().default(true),
-            overwriteExistingFiles: z.boolean().describe('Whether to overwrite existing files').optional().default(false),
-            select: z.string().describe('Optional: define exactly which fields you\'d like to return in the response (JSON), e.g., \'{"title": "My Post"}\'').optional(),
-            where: z.string().describe('JSON string for where clause to update multiple documents').optional()
+        return buildToolInput({
+            controls: {
+                id: z.union([
+                    z.string(),
+                    z.number()
+                ]).describe('The ID of the document to update').optional(),
+                depth: z.number().describe('How many levels deep to populate relationships').optional().default(0),
+                draft: z.boolean().describe('Whether to update the document as a draft').optional().default(false),
+                fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+                filePath: z.string().describe('File path for file uploads').optional(),
+                locale: z.string().describe('Optional: locale code to update the document in (e.g., "en", "es"). Defaults to the default locale').optional(),
+                overrideLock: z.boolean().describe('Whether to override document locks').optional().default(true),
+                overwriteExistingFiles: z.boolean().describe('Whether to overwrite existing files').optional().default(false),
+                select: z.string().describe('Optional: define exactly which fields you\'d like to return in the response (JSON), e.g., \'{"title": "My Post"}\'').optional(),
+                where: z.string().describe('JSON string for where clause to update multiple documents').optional()
+            },
+            dataDescription: 'The fields to update',
+            dataSchema: partialSchema
         });
     }
 }).handler(async ({ authorizedMCP, collectionSlug, input, req })=>{

package/dist/mcp/builtin/collections/updateTool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/updateTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\n\nconst DEFAULT_DESCRIPTION = 'Update documents in a collection by ID or where clause.'\n\nexport const updateCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ collectionSchema }) => {\n    const partialSchema = prepareCollectionSchema(collectionSchema)\n\n    // Collection updates do not require all required fields to be passed => delete .required.\n    //\n    // Local API equivalent: packages/payload/src/collections/operations/local/update.ts#BaseOptions#data:\n    // data: DeepPartial<RequiredDataFromCollectionSlug<TSlug>>\n    delete partialSchema.required\n\n    return z.object({\n      id: z.union([z.string(), z.number()]).describe('The ID of the document to update').optional(),\n      data: z\n        .fromJSONSchema(partialSchema as unknown as z.core.JSONSchema.JSONSchema)\n        .describe('The fields to update'),\n      depth: z\n        .number()\n        .describe('How many levels deep to populate relationships')\n        .optional()\n        .default(0),\n      draft: z\n        .boolean()\n        .describe('Whether to update the document as a draft')\n        .optional()\n        .default(false),\n      fallbackLocale: z\n        .string()\n        .describe('Optional: fallback locale code to use when requested locale is not available')\n        .optional(),\n      filePath: z.string().describe('File path for file uploads').optional(),\n      locale: z\n        .string()\n        .describe(\n          'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n        )\n        .optional(),\n      overrideLock: z\n        .boolean()\n        .describe('Whether to override document locks')\n        .optional()\n        .default(true),\n      overwriteExistingFiles: z\n        .boolean()\n        .describe('Whether to overwrite existing files')\n        .optional()\n        .default(false),\n      select: z\n        .string()\n        .describe(\n          'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n        )\n        .optional(),\n      where: z\n        .string()\n        .describe('JSON string for where clause to update multiple documents')\n        .optional(),\n    })\n  },\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const {\n    id,\n    data,\n    depth,\n    draft,\n    fallbackLocale,\n    filePath,\n    locale,\n    overrideLock,\n    overwriteExistingFiles,\n    select,\n    where,\n  } = input\n\n  logger.info(\n    `Updating document in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    if (!id && !where) {\n      return {\n        content: [{ type: 'text', text: 'Error: Either id or where clause must be provided' }],\n      }\n    }\n\n    let parsedData = transformPointDataToPayload(data as Record<string, unknown>)\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    parsedData = stripVirtualFields(parsedData, virtualFieldNames)\n\n    let whereClause: Record<string, unknown> = {}\n    if (where) {\n      try {\n        whereClause = JSON.parse(where) as Record<string, unknown>\n      } catch {\n        logger.error(`Invalid where clause JSON: ${where}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in where clause' }] }\n      }\n    }\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    if (id) {\n      const updateOptions = {\n        id,\n        collection: collectionSlug,\n        data: parsedData,\n        depth,\n        draft,\n        overrideLock,\n        req,\n        ...localAPIDefaults(authorizedMCP),\n        ...(filePath ? { filePath } : {}),\n        ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),\n        ...(locale ? { locale } : {}),\n        ...(fallbackLocale ? { fallbackLocale } : {}),\n        ...(selectClause ? { select: selectClause } : {}),\n      }\n\n      const result = await payload.update(updateOptions as any)\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Document updated successfully in collection \"${collectionSlug}\"!\\nUpdated document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n          },\n        ],\n        doc: result as Record<string, unknown>,\n      }\n    }\n\n    const updateOptions = {\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      overrideLock,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      where: whereClause,\n      ...(filePath ? { filePath } : {}),\n      ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    }\n\n    const result = await payload.update(updateOptions as any)\n\n    const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n    const docs = bulkResult.docs || []\n    const errors = bulkResult.errors || []\n\n    let responseText = `Multiple documents updated in collection \"${collectionSlug}\"!\\nUpdated: ${docs.length} documents\\nErrors: ${errors.length}\\n---`\n    if (docs.length > 0) {\n      responseText += `\\n\\nUpdated documents:\\n\\`\\`\\`json\\n${JSON.stringify(docs)}\\n\\`\\`\\``\n    }\n    if (errors.length > 0) {\n      responseText += `\\n\\nErrors:\\n\\`\\`\\`json\\n${JSON.stringify(errors)}\\n\\`\\`\\``\n    }\n\n    return {\n      content: [{ type: 'text', text: responseText }],\n      doc: { docs, errors } as unknown as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating document in ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error updating document in collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","prepareCollectionSchema","transformPointDataToPayload","DEFAULT_DESCRIPTION","updateCollectionTool","description","input","collectionSchema","partialSchema","required","object","id","union","string","number","describe","optional","data","fromJSONSchema","depth","default","draft","boolean","fallbackLocale","filePath","locale","overrideLock","overwriteExistingFiles","select","where","handler","authorizedMCP","collectionSlug","req","payload","logger","info","content","type","text","parsedData","virtualFieldNames","config","whereClause","JSON","parse","error","selectClause","warn","updateOptions","collection","result","update","stringify","doc","bulkResult","docs","errors","responseText","length","errorMessage","Error","message"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/builtin/collections/updateTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineCollectionTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getCollectionVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js'\nimport { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\n\nconst DEFAULT_DESCRIPTION = 'Update documents in a collection by ID or where clause.'\n\nexport const updateCollectionTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ collectionSchema }) => {\n    const partialSchema = sanitizeEntitySchema(collectionSchema)\n\n    // Collection updates do not require all required fields to be passed => delete .required.\n    //\n    // Local API equivalent: packages/payload/src/collections/operations/local/update.ts#BaseOptions#data:\n    // data: DeepPartial<RequiredDataFromCollectionSlug<TSlug>>\n    delete partialSchema.required\n\n    return buildToolInput({\n      controls: {\n        id: z\n          .union([z.string(), z.number()])\n          .describe('The ID of the document to update')\n          .optional(),\n        depth: z\n          .number()\n          .describe('How many levels deep to populate relationships')\n          .optional()\n          .default(0),\n        draft: z\n          .boolean()\n          .describe('Whether to update the document as a draft')\n          .optional()\n          .default(false),\n        fallbackLocale: z\n          .string()\n          .describe('Optional: fallback locale code to use when requested locale is not available')\n          .optional(),\n        filePath: z.string().describe('File path for file uploads').optional(),\n        locale: z\n          .string()\n          .describe(\n            'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n          )\n          .optional(),\n        overrideLock: z\n          .boolean()\n          .describe('Whether to override document locks')\n          .optional()\n          .default(true),\n        overwriteExistingFiles: z\n          .boolean()\n          .describe('Whether to overwrite existing files')\n          .optional()\n          .default(false),\n        select: z\n          .string()\n          .describe(\n            'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n          )\n          .optional(),\n        where: z\n          .string()\n          .describe('JSON string for where clause to update multiple documents')\n          .optional(),\n      },\n      dataDescription: 'The fields to update',\n      dataSchema: partialSchema,\n    })\n  },\n}).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const {\n    id,\n    data,\n    depth,\n    draft,\n    fallbackLocale,\n    filePath,\n    locale,\n    overrideLock,\n    overwriteExistingFiles,\n    select,\n    where,\n  } = input\n\n  logger.info(\n    `Updating document in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    if (!id && !where) {\n      return {\n        content: [{ type: 'text', text: 'Error: Either id or where clause must be provided' }],\n      }\n    }\n\n    let parsedData = transformPointDataToPayload(data)\n    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    parsedData = stripVirtualFields(parsedData, virtualFieldNames)\n\n    let whereClause: Record<string, unknown> = {}\n    if (where) {\n      try {\n        whereClause = JSON.parse(where) as Record<string, unknown>\n      } catch {\n        logger.error(`Invalid where clause JSON: ${where}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in where clause' }] }\n      }\n    }\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    if (id) {\n      const updateOptions = {\n        id,\n        collection: collectionSlug,\n        data: parsedData,\n        depth,\n        draft,\n        overrideLock,\n        req,\n        ...localAPIDefaults(authorizedMCP),\n        ...(filePath ? { filePath } : {}),\n        ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),\n        ...(locale ? { locale } : {}),\n        ...(fallbackLocale ? { fallbackLocale } : {}),\n        ...(selectClause ? { select: selectClause } : {}),\n      }\n\n      const result = await payload.update(updateOptions as any)\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Document updated successfully in collection \"${collectionSlug}\"!\\nUpdated document:\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n          },\n        ],\n        doc: result as Record<string, unknown>,\n      }\n    }\n\n    const updateOptions = {\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      overrideLock,\n      req,\n      ...localAPIDefaults(authorizedMCP),\n      where: whereClause,\n      ...(filePath ? { filePath } : {}),\n      ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    }\n\n    const result = await payload.update(updateOptions as any)\n\n    const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n    const docs = bulkResult.docs || []\n    const errors = bulkResult.errors || []\n\n    let responseText = `Multiple documents updated in collection \"${collectionSlug}\"!\\nUpdated: ${docs.length} documents\\nErrors: ${errors.length}\\n---`\n    if (docs.length > 0) {\n      responseText += `\\n\\nUpdated documents:\\n\\`\\`\\`json\\n${JSON.stringify(docs)}\\n\\`\\`\\``\n    }\n    if (errors.length > 0) {\n      responseText += `\\n\\nErrors:\\n\\`\\`\\`json\\n${JSON.stringify(errors)}\\n\\`\\`\\``\n    }\n\n    return {\n      content: [{ type: 'text', text: responseText }],\n      doc: { docs, errors } as unknown as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating document in ${collectionSlug}: ${errorMessage}`)\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error updating document in collection \"${collectionSlug}\": ${errorMessage}`,\n        },\n      ],\n    }\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","buildToolInput","sanitizeEntitySchema","transformPointDataToPayload","DEFAULT_DESCRIPTION","updateCollectionTool","description","input","collectionSchema","partialSchema","required","controls","id","union","string","number","describe","optional","depth","default","draft","boolean","fallbackLocale","filePath","locale","overrideLock","overwriteExistingFiles","select","where","dataDescription","dataSchema","handler","authorizedMCP","collectionSlug","req","payload","logger","data","info","content","type","text","parsedData","virtualFieldNames","config","whereClause","JSON","parse","error","selectClause","warn","updateOptions","collection","result","update","stringify","doc","bulkResult","docs","errors","responseText","length","errorMessage","Error","message"],"mappings":"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"}

package/dist/mcp/builtin/globals/updateTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,gBAAgB,wCAsG3B,CAAA"}
+{"version":3,"file":"updateTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,wCAuG3B,CAAA"}

package/dist/mcp/builtin/globals/updateTool.js

@@ -3,24 +3,28 @@ import { defineGlobalTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { getGlobalVirtualFieldNames, stripVirtualFields } from '../../../utils/getVirtualFieldNames.js';
 import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-import { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js';
+import { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js';
+import { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js';
 const DEFAULT_DESCRIPTION = 'Update a Payload global singleton configuration.';
 export const updateGlobalTool = defineGlobalTool({
     description: DEFAULT_DESCRIPTION,
     input: ({ globalSchema })=>{
-        const partialSchema = prepareCollectionSchema(globalSchema);
+        const partialSchema = sanitizeEntitySchema(globalSchema);
         // Global updates do not require all required fields to be passed => delete .required.
         //
         // Local API equivalent: packages/payload/src/global/operations/local/update.ts#BaseOptions#data:
         // data: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>
         delete partialSchema.required;
-        return z.object({
-            data: z.fromJSONSchema(partialSchema).describe('The fields to update'),
-            depth: z.number().describe('Optional: Depth of relationships to populate').optional().default(0),
-            draft: z.boolean().describe('Optional: Whether to save as draft (default: false)').optional().default(false),
-            fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
-            locale: z.string().describe('Optional: locale code to update data in (e.g., "en", "es"). Use "all" to update all locales for localized fields').optional(),
-            select: z.string().describe('Optional: define exactly which fields you\'d like to return in the response (JSON), e.g., \'{"siteName": "My Site"}\'').optional()
+        return buildToolInput({
+            controls: {
+                depth: z.number().describe('Optional: Depth of relationships to populate').optional().default(0),
+                draft: z.boolean().describe('Optional: Whether to save as draft (default: false)').optional().default(false),
+                fallbackLocale: z.string().describe('Optional: fallback locale code to use when requested locale is not available').optional(),
+                locale: z.string().describe('Optional: locale code to update data in (e.g., "en", "es"). Use "all" to update all locales for localized fields').optional(),
+                select: z.string().describe('Optional: define exactly which fields you\'d like to return in the response (JSON), e.g., \'{"siteName": "My Site"}\'').optional()
+            },
+            dataDescription: 'The fields to update',
+            dataSchema: partialSchema
         });
     }
 }).handler(async ({ authorizedMCP, globalSlug, input, req })=>{

package/dist/mcp/builtin/globals/updateTool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getGlobalVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { prepareCollectionSchema } from '../../../utils/schemaConversion/prepareCollectionSchema.js'\n\nconst DEFAULT_DESCRIPTION = 'Update a Payload global singleton configuration.'\n\nexport const updateGlobalTool = defineGlobalTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ globalSchema }) => {\n    const partialSchema = prepareCollectionSchema(globalSchema)\n    // Global updates do not require all required fields to be passed => delete .required.\n    //\n    // Local API equivalent: packages/payload/src/global/operations/local/update.ts#BaseOptions#data:\n    // data: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>\n    delete partialSchema.required\n\n    return z.object({\n      data: z\n        .fromJSONSchema(partialSchema as unknown as z.core.JSONSchema.JSONSchema)\n        .describe('The fields to update'),\n      depth: z\n        .number()\n        .describe('Optional: Depth of relationships to populate')\n        .optional()\n        .default(0),\n      draft: z\n        .boolean()\n        .describe('Optional: Whether to save as draft (default: false)')\n        .optional()\n        .default(false),\n      fallbackLocale: z\n        .string()\n        .describe('Optional: fallback locale code to use when requested locale is not available')\n        .optional(),\n      locale: z\n        .string()\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        .optional(),\n      select: z\n        .string()\n        .describe(\n          'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"siteName\": \"My Site\"}\\'',\n        )\n        .optional(),\n    })\n  },\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { data, depth, draft, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, globalSlug)\n    const parsedData = stripVirtualFields(data as Record<string, unknown>, virtualFieldNames)\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON for global: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    const updateOptions: Parameters<typeof payload.updateGlobal>[0] = {\n      slug: globalSlug,\n      data: parsedData,\n      depth,\n      draft,\n      ...localAPIDefaults(authorizedMCP),\n    }\n\n    if (locale) {\n      updateOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      updateOptions.fallbackLocale = fallbackLocale\n    }\n    if (selectClause) {\n      updateOptions.select = selectClause\n    }\n\n    const result = await payload.updateGlobal(updateOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\" updated successfully!\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [{ type: 'text', text: `Error updating global \"${globalSlug}\": ${errorMessage}` }],\n    }\n  }\n})\n"],"names":["z","defineGlobalTool","getLogger","getGlobalVirtualFieldNames","stripVirtualFields","localAPIDefaults","prepareCollectionSchema","DEFAULT_DESCRIPTION","updateGlobalTool","description","input","globalSchema","partialSchema","required","object","data","fromJSONSchema","describe","depth","number","optional","default","draft","boolean","fallbackLocale","string","locale","select","handler","authorizedMCP","globalSlug","req","payload","logger","info","virtualFieldNames","config","parsedData","selectClause","JSON","parse","warn","content","type","text","updateOptions","slug","result","updateGlobal","stringify","doc","error","errorMessage","Error","message"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/updateTool.ts"],"sourcesContent":["import type { SelectType } from 'payload'\n\nimport { z } from 'zod'\n\nimport { defineGlobalTool } from '../../../defineTool.js'\nimport { getLogger } from '../../../utils/getLogger.js'\nimport {\n  getGlobalVirtualFieldNames,\n  stripVirtualFields,\n} from '../../../utils/getVirtualFieldNames.js'\nimport { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\nimport { buildToolInput } from '../../../utils/schemaConversion/buildToolInput.js'\nimport { sanitizeEntitySchema } from '../../../utils/schemaConversion/sanitizeEntitySchema.js'\n\nconst DEFAULT_DESCRIPTION = 'Update a Payload global singleton configuration.'\n\nexport const updateGlobalTool = defineGlobalTool({\n  description: DEFAULT_DESCRIPTION,\n  input: ({ globalSchema }) => {\n    const partialSchema = sanitizeEntitySchema(globalSchema)\n    // Global updates do not require all required fields to be passed => delete .required.\n    //\n    // Local API equivalent: packages/payload/src/global/operations/local/update.ts#BaseOptions#data:\n    // data: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>\n    delete partialSchema.required\n\n    return buildToolInput({\n      controls: {\n        depth: z\n          .number()\n          .describe('Optional: Depth of relationships to populate')\n          .optional()\n          .default(0),\n        draft: z\n          .boolean()\n          .describe('Optional: Whether to save as draft (default: false)')\n          .optional()\n          .default(false),\n        fallbackLocale: z\n          .string()\n          .describe('Optional: fallback locale code to use when requested locale is not available')\n          .optional(),\n        locale: z\n          .string()\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          .optional(),\n        select: z\n          .string()\n          .describe(\n            'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"siteName\": \"My Site\"}\\'',\n          )\n          .optional(),\n      },\n      dataDescription: 'The fields to update',\n      dataSchema: partialSchema,\n    })\n  },\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { data, depth, draft, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, globalSlug)\n    const parsedData = stripVirtualFields(data, virtualFieldNames)\n\n    let selectClause: SelectType | undefined\n    if (select) {\n      try {\n        selectClause = JSON.parse(select) as SelectType\n      } catch {\n        logger.warn(`Invalid select clause JSON for global: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    const updateOptions: Parameters<typeof payload.updateGlobal>[0] = {\n      slug: globalSlug,\n      data: parsedData,\n      depth,\n      draft,\n      ...localAPIDefaults(authorizedMCP),\n    }\n\n    if (locale) {\n      updateOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      updateOptions.fallbackLocale = fallbackLocale\n    }\n    if (selectClause) {\n      updateOptions.select = selectClause\n    }\n\n    const result = await payload.updateGlobal(updateOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\" updated successfully!\\n\\`\\`\\`json\\n${JSON.stringify(result)}\\n\\`\\`\\``,\n        },\n      ],\n      doc: result as Record<string, unknown>,\n    }\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n    logger.error(`Error updating global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [{ type: 'text', text: `Error updating global \"${globalSlug}\": ${errorMessage}` }],\n    }\n  }\n})\n"],"names":["z","defineGlobalTool","getLogger","getGlobalVirtualFieldNames","stripVirtualFields","localAPIDefaults","buildToolInput","sanitizeEntitySchema","DEFAULT_DESCRIPTION","updateGlobalTool","description","input","globalSchema","partialSchema","required","controls","depth","number","describe","optional","default","draft","boolean","fallbackLocale","string","locale","select","dataDescription","dataSchema","handler","authorizedMCP","globalSlug","req","payload","logger","data","info","virtualFieldNames","config","parsedData","selectClause","JSON","parse","warn","content","type","text","updateOptions","slug","result","updateGlobal","stringify","doc","error","errorMessage","Error","message"],"mappings":"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"}

package/dist/utils/schemaConversion/buildToolInput.d.ts

@@ -0,0 +1,29 @@
+import type { StandardSchemaWithJSON } from '@modelcontextprotocol/server';
+import { z } from 'zod';
+import type { JsonSchemaType } from '../../types.js';
+/**
+ * Builds a create/update tool's `input`: a `data` field (the document's fields) plus controls like
+ * `depth` and `draft`. Using just `z.fromJSONSchema(ourJSONSchema)` has a few problems which are mitigated
+ * in this function. z.fromJSONSchema is both bigger and lossier (≈40% larger on the lexical schema).
+ * Each example below is `what we publish` => `what a plain zod round-trip would publish instead`.
+ *
+ * @example
+ * Bigger - zod inlines shared defs instead of keeping our `$ref`s (and adds junk integer bounds), so a
+ * reused def is duplicated at every use:
+ * `{ $ref: '#/$defs/author' }` => `{ type: 'object', properties: { id, name }, additionalProperties: false }`
+ *
+ * @example
+ * Lossier - zod drops the `description` on `enum`/`const` fields:
+ * `{ enum: ['draft', 'published'], description: 'Publish state' }` → `{ enum: ['draft', 'published'] }`
+ */
+export declare const buildToolInput: <TControls extends z.ZodRawShape>({ controls, dataDescription, dataSchema, }: {
+    /** Tool options alongside `data` (depth, draft, where, …) as plain zod - inferred into `input`. */
+    controls: TControls;
+    dataDescription: string;
+    dataSchema: JsonSchemaType;
+}) => StandardSchemaWithJSON<{
+    data: Record<string, unknown>;
+} & Omit<z.output<z.ZodObject<{
+    data: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+} & TControls extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>>, "data">>;
+//# sourceMappingURL=buildToolInput.d.ts.map

package/dist/utils/schemaConversion/buildToolInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildToolInput.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaConversion/buildToolInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,SAAS,CAAC,CAAC,WAAW,EAAE,4CAI7D;IACD,mGAAmG;IACnG,QAAQ,EAAE,SAAS,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,cAAc,CAAA;CAC3B,KAkCM,sBAAsB,CACzB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM;;4FAAe,EAAE,MAAM,CAAC,CAE5E,CAAA"}

package/dist/utils/schemaConversion/buildToolInput.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Builds a create/update tool's `input`: a `data` field (the document's fields) plus controls like
+ * `depth` and `draft`. Using just `z.fromJSONSchema(ourJSONSchema)` has a few problems which are mitigated
+ * in this function. z.fromJSONSchema is both bigger and lossier (≈40% larger on the lexical schema).
+ * Each example below is `what we publish` => `what a plain zod round-trip would publish instead`.
+ *
+ * @example
+ * Bigger - zod inlines shared defs instead of keeping our `$ref`s (and adds junk integer bounds), so a
+ * reused def is duplicated at every use:
+ * `{ $ref: '#/$defs/author' }` => `{ type: 'object', properties: { id, name }, additionalProperties: false }`
+ *
+ * @example
+ * Lossier - zod drops the `description` on `enum`/`const` fields:
+ * `{ enum: ['draft', 'published'], description: 'Publish state' }` → `{ enum: ['draft', 'published'] }`
+ */ export const buildToolInput = ({ controls, dataDescription, dataSchema })=>{
+    // `sanitizeEntitySchema` already emits draft 2020-12 with `$defs`, which is what zod's `fromJSONSchema`
+    // and MCP clients both expect. Drop only the root `$schema` keyword, redundant once it's a sub-schema.
+    const { $schema: _schema, ...entitySchema } = dataSchema;
+    const schema = z.object({
+        data: z.fromJSONSchema(entitySchema),
+        ...controls
+    });
+    const standard = schema['~standard'];
+    return {
+        '~standard': {
+            ...standard,
+            jsonSchema: {
+                ...standard.jsonSchema,
+                input: (options)=>{
+                    // Start from zod's JSON Schema for the whole input, then replace its lossy `data` schema with
+                    // the sanitized entity schema. The entity's `$defs` move to the root so the `$ref`s resolve.
+                    const generated = standard.jsonSchema.input(options);
+                    const { $defs, ...entityBody } = entitySchema;
+                    generated.properties.data = {
+                        ...entityBody,
+                        description: dataDescription
+                    };
+                    if ($defs) {
+                        generated.$defs = $defs;
+                    } else {
+                        delete generated.$defs;
+                    }
+                    return generated;
+                }
+            }
+        }
+    };
+};
+
+//# sourceMappingURL=buildToolInput.js.map

package/dist/utils/schemaConversion/buildToolInput.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/schemaConversion/buildToolInput.ts"],"sourcesContent":["import type { StandardSchemaWithJSON } from '@modelcontextprotocol/server'\n\nimport { z } from 'zod'\n\nimport type { JsonSchemaType } from '../../types.js'\n\n/**\n * Builds a create/update tool's `input`: a `data` field (the document's fields) plus controls like\n * `depth` and `draft`. Using just `z.fromJSONSchema(ourJSONSchema)` has a few problems which are mitigated\n * in this function. z.fromJSONSchema is both bigger and lossier (≈40% larger on the lexical schema).\n * Each example below is `what we publish` => `what a plain zod round-trip would publish instead`.\n *\n * @example\n * Bigger - zod inlines shared defs instead of keeping our `$ref`s (and adds junk integer bounds), so a\n * reused def is duplicated at every use:\n * `{ $ref: '#/$defs/author' }` => `{ type: 'object', properties: { id, name }, additionalProperties: false }`\n *\n * @example\n * Lossier - zod drops the `description` on `enum`/`const` fields:\n * `{ enum: ['draft', 'published'], description: 'Publish state' }` → `{ enum: ['draft', 'published'] }`\n */\nexport const buildToolInput = <TControls extends z.ZodRawShape>({\n  controls,\n  dataDescription,\n  dataSchema,\n}: {\n  /** Tool options alongside `data` (depth, draft, where, …) as plain zod - inferred into `input`. */\n  controls: TControls\n  dataDescription: string\n  dataSchema: JsonSchemaType\n}) => {\n  // `sanitizeEntitySchema` already emits draft 2020-12 with `$defs`, which is what zod's `fromJSONSchema`\n  // and MCP clients both expect. Drop only the root `$schema` keyword, redundant once it's a sub-schema.\n  const { $schema: _schema, ...entitySchema } = dataSchema as Record<string, unknown>\n\n  const schema = z.object({\n    data: z.fromJSONSchema(entitySchema as unknown as z.core.JSONSchema.JSONSchema),\n    ...controls,\n  })\n  const standard = (schema as unknown as StandardSchemaWithJSON)['~standard']\n\n  return {\n    '~standard': {\n      ...standard,\n      jsonSchema: {\n        ...standard.jsonSchema,\n        input: (options) => {\n          // Start from zod's JSON Schema for the whole input, then replace its lossy `data` schema with\n          // the sanitized entity schema. The entity's `$defs` move to the root so the `$ref`s resolve.\n          const generated = standard.jsonSchema.input(options)\n          const { $defs, ...entityBody } = entitySchema\n          ;(generated.properties as Record<string, unknown>).data = {\n            ...entityBody,\n            description: dataDescription,\n          }\n          if ($defs) {\n            generated.$defs = $defs as object\n          } else {\n            delete generated.$defs\n          }\n          return generated\n        },\n      },\n    },\n  } as StandardSchemaWithJSON<\n    { data: Record<string, unknown> } & Omit<z.output<typeof schema>, 'data'>\n  >\n}\n"],"names":["z","buildToolInput","controls","dataDescription","dataSchema","$schema","_schema","entitySchema","schema","object","data","fromJSONSchema","standard","jsonSchema","input","options","generated","$defs","entityBody","properties","description"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAIvB;;;;;;;;;;;;;;CAcC,GACD,OAAO,MAAMC,iBAAiB,CAAkC,EAC9DC,QAAQ,EACRC,eAAe,EACfC,UAAU,EAMX;IACC,wGAAwG;IACxG,uGAAuG;IACvG,MAAM,EAAEC,SAASC,OAAO,EAAE,GAAGC,cAAc,GAAGH;IAE9C,MAAMI,SAASR,EAAES,MAAM,CAAC;QACtBC,MAAMV,EAAEW,cAAc,CAACJ;QACvB,GAAGL,QAAQ;IACb;IACA,MAAMU,WAAW,AAACJ,MAA4C,CAAC,YAAY;IAE3E,OAAO;QACL,aAAa;YACX,GAAGI,QAAQ;YACXC,YAAY;gBACV,GAAGD,SAASC,UAAU;gBACtBC,OAAO,CAACC;oBACN,8FAA8F;oBAC9F,6FAA6F;oBAC7F,MAAMC,YAAYJ,SAASC,UAAU,CAACC,KAAK,CAACC;oBAC5C,MAAM,EAAEE,KAAK,EAAE,GAAGC,YAAY,GAAGX;oBAC/BS,UAAUG,UAAU,CAA6BT,IAAI,GAAG;wBACxD,GAAGQ,UAAU;wBACbE,aAAajB;oBACf;oBACA,IAAIc,OAAO;wBACTD,UAAUC,KAAK,GAAGA;oBACpB,OAAO;wBACL,OAAOD,UAAUC,KAAK;oBACxB;oBACA,OAAOD;gBACT;YACF;QACF;IACF;AAGF,EAAC"}