@payloadcms/plugin-mcp 4.0.0-canary.0 → 4.0.0-canary.1

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

@@ -3,35 +3,30 @@ 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 { getCollectionInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js';
 import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js';
-const DEFAULT_DESCRIPTION = 'Update documents in a collection by ID or where clause.';
-export const updateCollectionTool = defineCollectionTool({
+import { whereSchema } from '../../../utils/whereSchema.js';
+import { validateCollectionData } from '../validateEntityData.js';
+import { formatCollectionError } from './formatCollectionError.js';
+const DEFAULT_DESCRIPTION = 'Update documents in any collection by passing the collection slug and data.';
+export const updateDocumentTool = defineCollectionTool({
     description: DEFAULT_DESCRIPTION,
-    input: ({ collectionSchema })=>{
-        const partialSchema = prepareCollectionSchema(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()
-        });
-    }
+    input: z.object({
+        id: z.union([
+            z.string(),
+            z.number()
+        ]).describe('The ID of the document to update').optional(),
+        data: z.record(z.string(), z.unknown()).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\": true}'").optional(),
+        where: whereSchema.describe('Where clause to update multiple documents. Use field names with Payload operators, and/or arrays for grouping. Example: {"title":{"contains":"test"}}').optional()
+    })
 }).handler(async ({ authorizedMCP, collectionSlug, input, req })=>{
     const payload = req.payload;
     const logger = getLogger({
@@ -50,25 +45,19 @@ export const updateCollectionTool = defineCollectionTool({
                 ]
             };
         }
-        let parsedData = transformPointDataToPayload(data);
         const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug);
-        parsedData = stripVirtualFields(parsedData, virtualFieldNames);
-        let whereClause = {};
-        if (where) {
-            try {
-                whereClause = JSON.parse(where);
-            } catch  {
-                logger.error(`Invalid where clause JSON: ${where}`);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'Error: Invalid JSON in where clause'
-                        }
-                    ]
-                };
-            }
+        const inputData = stripVirtualFields(data, virtualFieldNames);
+        const validationError = validateCollectionData({
+            collectionSlug,
+            data: inputData,
+            partial: true,
+            req
+        });
+        if (validationError) {
+            return validationError;
         }
+        const parsedData = transformPointDataToPayload(inputData);
+        const whereClause = where ?? {};
         let selectClause;
         if (select) {
             try {
@@ -86,7 +75,7 @@ export const updateCollectionTool = defineCollectionTool({
             }
         }
         if (id) {
-            const updateOptions = {
+            const result = await payload.update({
                 id,
                 collection: collectionSlug,
                 data: parsedData,
@@ -110,8 +99,7 @@ export const updateCollectionTool = defineCollectionTool({
                 ...selectClause ? {
                     select: selectClause
                 } : {}
-            };
-            const result = await payload.update(updateOptions);
+            });
             return {
                 content: [
                     {
@@ -122,15 +110,15 @@ export const updateCollectionTool = defineCollectionTool({
                 doc: result
             };
         }
-        const updateOptions = {
+        const result = await payload.update({
             collection: collectionSlug,
             data: parsedData,
             depth,
             draft,
             overrideLock,
             req,
-            ...localAPIDefaults(authorizedMCP),
             where: whereClause,
+            ...localAPIDefaults(authorizedMCP),
             ...filePath ? {
                 filePath
             } : {},
@@ -146,17 +134,43 @@ export const updateCollectionTool = defineCollectionTool({
             ...selectClause ? {
                 select: selectClause
             } : {}
-        };
-        const result = await payload.update(updateOptions);
-        const bulkResult = result;
-        const docs = bulkResult.docs || [];
-        const errors = bulkResult.errors || [];
+        });
+        const docs = result.docs || [];
+        const errors = result.errors || [];
         let responseText = `Multiple documents updated in collection "${collectionSlug}"!\nUpdated: ${docs.length} documents\nErrors: ${errors.length}\n---`;
         if (docs.length > 0) {
             responseText += `\n\nUpdated documents:\n\`\`\`json\n${JSON.stringify(docs)}\n\`\`\``;
         }
         if (errors.length > 0) {
             responseText += `\n\nErrors:\n\`\`\`json\n${JSON.stringify(errors)}\n\`\`\``;
+            const errorSchema = getCollectionInputSchema({
+                collectionSlug,
+                req
+            });
+            if (errorSchema) {
+                responseText += `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(errorSchema)}\n\`\`\``;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: responseText
+                    }
+                ],
+                doc: {
+                    docs,
+                    errors
+                },
+                isError: true,
+                ...errorSchema ? {
+                    structuredContent: {
+                        collectionSlug,
+                        docs,
+                        errors,
+                        schema: errorSchema
+                    }
+                } : {}
+            };
         }
         return {
             content: [
@@ -173,14 +187,12 @@ export const updateCollectionTool = defineCollectionTool({
     } catch (error) {
         const errorMessage = error instanceof Error ? error.message : 'Unknown error';
         logger.error(`Error updating document in ${collectionSlug}: ${errorMessage}`);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error updating document in collection "${collectionSlug}": ${errorMessage}`
-                }
-            ]
-        };
+        return formatCollectionError({
+            action: 'updating',
+            collectionSlug,
+            error,
+            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, Where } 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 { getCollectionInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\nimport { whereSchema } from '../../../utils/whereSchema.js'\nimport { validateCollectionData } from '../validateEntityData.js'\nimport { formatCollectionError } from './formatCollectionError.js'\n\nconst DEFAULT_DESCRIPTION =\n  'Update documents in any collection by passing the collection slug and data.'\n\nexport const updateDocumentTool = defineCollectionTool({\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    id: z.union([z.string(), z.number()]).describe('The ID of the document to update').optional(),\n    data: z.record(z.string(), z.unknown()).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\\\": true}'\",\n      )\n      .optional(),\n    where: whereSchema\n      .describe(\n        'Where clause to update multiple documents. Use field names with Payload operators, and/or arrays for grouping. Example: {\"title\":{\"contains\":\"test\"}}',\n      )\n      .optional(),\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    const virtualFieldNames = getCollectionVirtualFieldNames(payload.config, collectionSlug)\n    const inputData = stripVirtualFields(data, virtualFieldNames)\n    const validationError = validateCollectionData({\n      collectionSlug,\n      data: inputData,\n      partial: true,\n      req,\n    })\n\n    if (validationError) {\n      return validationError\n    }\n\n    const parsedData = transformPointDataToPayload(inputData)\n\n    const whereClause: Where = where ?? {}\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 result = await payload.update({\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      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 result = await payload.update({\n      collection: collectionSlug,\n      data: parsedData,\n      depth,\n      draft,\n      overrideLock,\n      req,\n      where: whereClause,\n      ...localAPIDefaults(authorizedMCP),\n      ...(filePath ? { filePath } : {}),\n      ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),\n      ...(locale ? { locale } : {}),\n      ...(fallbackLocale ? { fallbackLocale } : {}),\n      ...(selectClause ? { select: selectClause } : {}),\n    })\n\n    const docs = result.docs || []\n    const errors = result.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      const errorSchema = getCollectionInputSchema({ collectionSlug, req })\n\n      if (errorSchema) {\n        responseText += `\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(errorSchema)}\\n\\`\\`\\``\n      }\n\n      return {\n        content: [{ type: 'text', text: responseText }],\n        doc: { docs, errors } as unknown as Record<string, unknown>,\n        isError: true,\n        ...(errorSchema\n          ? {\n              structuredContent: {\n                collectionSlug,\n                docs,\n                errors,\n                schema: errorSchema,\n              },\n            }\n          : {}),\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 formatCollectionError({ action: 'updating', collectionSlug, error, req })\n  }\n})\n"],"names":["z","defineCollectionTool","getLogger","getCollectionVirtualFieldNames","stripVirtualFields","localAPIDefaults","getCollectionInputSchema","transformPointDataToPayload","whereSchema","validateCollectionData","formatCollectionError","DEFAULT_DESCRIPTION","updateDocumentTool","description","input","object","id","union","string","number","describe","optional","data","record","unknown","depth","default","draft","boolean","fallbackLocale","filePath","locale","overrideLock","overwriteExistingFiles","select","where","handler","authorizedMCP","collectionSlug","req","payload","logger","info","content","type","text","virtualFieldNames","config","inputData","validationError","partial","parsedData","whereClause","selectClause","JSON","parse","warn","result","update","collection","stringify","doc","docs","errors","responseText","length","errorSchema","isError","structuredContent","schema","error","errorMessage","Error","message","action"],"mappings":"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"}

package/dist/mcp/builtin/getConfigInfoTool.d.ts

@@ -0,0 +1,2 @@
+export declare const getConfigInfoTool: import("../../types.js").Tool;
+//# sourceMappingURL=getConfigInfoTool.d.ts.map

package/dist/mcp/builtin/getConfigInfoTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigInfoTool.d.ts","sourceRoot":"","sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,+BAuC5B,CAAA"}

package/dist/mcp/builtin/getConfigInfoTool.js

@@ -0,0 +1,49 @@
+import { getAccessResults, isEntityHidden } from 'payload';
+import { defineTool } from '../../defineTool.js';
+export const getConfigInfoTool = defineTool({
+    description: 'List the Payload collection and global slugs visible to this MCP client.'
+}).handler(async ({ authorizedMCP, req })=>{
+    const user = authorizedMCP.user ?? req.user ?? null;
+    const permissions = user ? await getAccessResults({
+        req: {
+            ...req,
+            user
+        }
+    }) : null;
+    const collections = [];
+    const globals = [];
+    for (const collection of req.payload.config.collections){
+        if (user && isEntityHidden({
+            hidden: collection.admin.hidden,
+            user
+        })) {
+            continue;
+        }
+        if (user && !permissions?.collections?.[collection.slug]?.read) {
+            continue;
+        }
+        collections.push(collection.slug);
+    }
+    for (const global of req.payload.config.globals){
+        if (user && isEntityHidden({
+            hidden: global.admin.hidden,
+            user
+        })) {
+            continue;
+        }
+        if (user && !permissions?.globals?.[global.slug]?.read) {
+            continue;
+        }
+        globals.push(global.slug);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Collections: ${collections.join(', ') || 'none'}\nGlobals: ${globals.join(', ') || 'none'}`
+            }
+        ]
+    };
+});
+
+//# sourceMappingURL=getConfigInfoTool.js.map

package/dist/mcp/builtin/getConfigInfoTool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/builtin/getConfigInfoTool.ts"],"sourcesContent":["import { getAccessResults, isEntityHidden } from 'payload'\n\nimport { defineTool } from '../../defineTool.js'\n\nexport const getConfigInfoTool = defineTool({\n  description: 'List the Payload collection and global slugs visible to this MCP client.',\n}).handler(async ({ authorizedMCP, req }) => {\n  const user = authorizedMCP.user ?? req.user ?? null\n  const permissions = user ? await getAccessResults({ req: { ...req, user } }) : null\n\n  const collections: string[] = []\n  const globals: string[] = []\n\n  for (const collection of req.payload.config.collections) {\n    if (user && isEntityHidden({ hidden: collection.admin.hidden, user })) {\n      continue\n    }\n    if (user && !permissions?.collections?.[collection.slug]?.read) {\n      continue\n    }\n\n    collections.push(collection.slug)\n  }\n\n  for (const global of req.payload.config.globals) {\n    if (user && isEntityHidden({ hidden: global.admin.hidden, user })) {\n      continue\n    }\n    if (user && !permissions?.globals?.[global.slug]?.read) {\n      continue\n    }\n\n    globals.push(global.slug)\n  }\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Collections: ${collections.join(', ') || 'none'}\\nGlobals: ${globals.join(', ') || 'none'}`,\n      },\n    ],\n  }\n})\n"],"names":["getAccessResults","isEntityHidden","defineTool","getConfigInfoTool","description","handler","authorizedMCP","req","user","permissions","collections","globals","collection","payload","config","hidden","admin","slug","read","push","global","content","type","text","join"],"mappings":"AAAA,SAASA,gBAAgB,EAAEC,cAAc,QAAQ,UAAS;AAE1D,SAASC,UAAU,QAAQ,sBAAqB;AAEhD,OAAO,MAAMC,oBAAoBD,WAAW;IAC1CE,aAAa;AACf,GAAGC,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,GAAG,EAAE;IACtC,MAAMC,OAAOF,cAAcE,IAAI,IAAID,IAAIC,IAAI,IAAI;IAC/C,MAAMC,cAAcD,OAAO,MAAMR,iBAAiB;QAAEO,KAAK;YAAE,GAAGA,GAAG;YAAEC;QAAK;IAAE,KAAK;IAE/E,MAAME,cAAwB,EAAE;IAChC,MAAMC,UAAoB,EAAE;IAE5B,KAAK,MAAMC,cAAcL,IAAIM,OAAO,CAACC,MAAM,CAACJ,WAAW,CAAE;QACvD,IAAIF,QAAQP,eAAe;YAAEc,QAAQH,WAAWI,KAAK,CAACD,MAAM;YAAEP;QAAK,IAAI;YACrE;QACF;QACA,IAAIA,QAAQ,CAACC,aAAaC,aAAa,CAACE,WAAWK,IAAI,CAAC,EAAEC,MAAM;YAC9D;QACF;QAEAR,YAAYS,IAAI,CAACP,WAAWK,IAAI;IAClC;IAEA,KAAK,MAAMG,UAAUb,IAAIM,OAAO,CAACC,MAAM,CAACH,OAAO,CAAE;QAC/C,IAAIH,QAAQP,eAAe;YAAEc,QAAQK,OAAOJ,KAAK,CAACD,MAAM;YAAEP;QAAK,IAAI;YACjE;QACF;QACA,IAAIA,QAAQ,CAACC,aAAaE,SAAS,CAACS,OAAOH,IAAI,CAAC,EAAEC,MAAM;YACtD;QACF;QAEAP,QAAQQ,IAAI,CAACC,OAAOH,IAAI;IAC1B;IAEA,OAAO;QACLI,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,aAAa,EAAEb,YAAYc,IAAI,CAAC,SAAS,OAAO,WAAW,EAAEb,QAAQa,IAAI,CAAC,SAAS,QAAQ;YACpG;SACD;IACH;AACF,GAAE"}

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { defineGlobalTool } from '../../../defineTool.js';
 import { getLogger } from '../../../utils/getLogger.js';
 import { localAPIDefaults } from '../../../utils/localAPIDefaults.js';
-const DEFAULT_DESCRIPTION = 'Find a Payload global singleton configuration.';
+const DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.';
 export const findGlobalTool = defineGlobalTool({
     description: DEFAULT_DESCRIPTION,
     input: z.object({

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/globals/findTool.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 { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION = 'Find a Payload global singleton configuration.'\n\nexport const findGlobalTool = defineGlobalTool({\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('Depth of population for relationships')\n      .optional()\n      .default(0),\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 retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve 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., '{\\\"title\\\": true}'\",\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { depth, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n      slug: globalSlug,\n      depth,\n      ...localAPIDefaults(authorizedMCP),\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 for global: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    if (locale) {\n      findOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      findOptions.fallbackLocale = fallbackLocale\n    }\n    if (selectClause) {\n      findOptions.select = selectClause\n    }\n\n    const result = await payload.findGlobal(findOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\":\\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 reading global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        { type: 'text', text: `❌ **Error reading global \"${globalSlug}\":** ${errorMessage}` },\n      ],\n    }\n  }\n})\n"],"names":["z","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","findGlobalTool","description","input","object","depth","number","int","min","max","describe","optional","default","fallbackLocale","string","locale","select","handler","authorizedMCP","globalSlug","req","payload","logger","info","findOptions","slug","selectClause","JSON","parse","warn","content","type","text","result","findGlobal","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,gBAAgB,QAAQ,qCAAoC;AAErE,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,iBAAiBJ,iBAAiB;IAC7CK,aAAaF;IACbG,OAAOP,EAAEQ,MAAM,CAAC;QACdC,OAAOT,EACJU,MAAM,GACNC,GAAG,GACHC,GAAG,CAAC,GACJC,GAAG,CAAC,IACJC,QAAQ,CAAC,yCACTC,QAAQ,GACRC,OAAO,CAAC;QACXC,gBAAgBjB,EACbkB,MAAM,GACNJ,QAAQ,CAAC,gFACTC,QAAQ;QACXI,QAAQnB,EACLkB,MAAM,GACNJ,QAAQ,CACP,wHAEDC,QAAQ;QACXK,QAAQpB,EACLkB,MAAM,GACNJ,QAAQ,CACP,gHAEDC,QAAQ;IACb;AACF,GAAGM,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,UAAU,EAAEhB,KAAK,EAAEiB,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASxB,UAAU;QAAEuB;IAAQ;IAEnC,MAAM,EAAEhB,KAAK,EAAEQ,cAAc,EAAEE,MAAM,EAAEC,MAAM,EAAE,GAAGb;IAElDmB,OAAOC,IAAI,CACT,CAAC,gBAAgB,EAAEJ,WAAW,SAAS,EAAEd,QAAQU,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAGxF,IAAI;QACF,MAAMS,cAAwD;YAC5DC,MAAMN;YACNd;YACA,GAAGN,iBAAiBmB,cAAc;QACpC;QAEA,IAAIQ;QACJ,IAAIV,QAAQ;YACV,IAAI;gBACFU,eAAeC,KAAKC,KAAK,CAACZ;YAC5B,EAAE,OAAM;gBACNM,OAAOO,IAAI,CAAC,CAAC,uCAAuC,EAAEb,QAAQ;gBAC9D,OAAO;oBAAEc,SAAS;wBAAC;4BAAEC,MAAM;4BAAQC,MAAM;wBAAuC;qBAAE;gBAAC;YACrF;QACF;QAEA,IAAIjB,QAAQ;YACVS,YAAYT,MAAM,GAAGA;QACvB;QACA,IAAIF,gBAAgB;YAClBW,YAAYX,cAAc,GAAGA;QAC/B;QACA,IAAIa,cAAc;YAChBF,YAAYR,MAAM,GAAGU;QACvB;QAEA,MAAMO,SAAS,MAAMZ,QAAQa,UAAU,CAACV;QAExC,OAAO;YACLM,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAEb,WAAW,gBAAgB,EAAEQ,KAAKQ,SAAS,CAACF,QAAQ,QAAQ,CAAC;gBAChF;aACD;YACDG,KAAKH;QACP;IACF,EAAE,OAAOI,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DlB,OAAOe,KAAK,CAAC,CAAC,qBAAqB,EAAElB,WAAW,EAAE,EAAEmB,cAAc;QAClE,OAAO;YACLR,SAAS;gBACP;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,0BAA0B,EAAEb,WAAW,KAAK,EAAEmB,cAAc;gBAAC;aACrF;QACH;IACF;AACF,GAAE"}
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/findTool.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 { localAPIDefaults } from '../../../utils/localAPIDefaults.js'\n\nconst DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.'\n\nexport const findGlobalTool = defineGlobalTool({\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    depth: z\n      .number()\n      .int()\n      .min(0)\n      .max(10)\n      .describe('Depth of population for relationships')\n      .optional()\n      .default(0),\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 retrieve data in (e.g., \"en\", \"es\"). Use \"all\" to retrieve 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., '{\\\"title\\\": true}'\",\n      )\n      .optional(),\n  }),\n}).handler(async ({ authorizedMCP, globalSlug, input, req }) => {\n  const payload = req.payload\n  const logger = getLogger({ payload })\n\n  const { depth, fallbackLocale, locale, select } = input\n\n  logger.info(\n    `Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`,\n  )\n\n  try {\n    const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n      slug: globalSlug,\n      depth,\n      ...localAPIDefaults(authorizedMCP),\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 for global: ${select}`)\n        return { content: [{ type: 'text', text: 'Error: Invalid JSON in select clause' }] }\n      }\n    }\n\n    if (locale) {\n      findOptions.locale = locale\n    }\n    if (fallbackLocale) {\n      findOptions.fallbackLocale = fallbackLocale\n    }\n    if (selectClause) {\n      findOptions.select = selectClause\n    }\n\n    const result = await payload.findGlobal(findOptions)\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Global \"${globalSlug}\":\\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 reading global ${globalSlug}: ${errorMessage}`)\n    return {\n      content: [\n        { type: 'text', text: `❌ **Error reading global \"${globalSlug}\":** ${errorMessage}` },\n      ],\n    }\n  }\n})\n"],"names":["z","defineGlobalTool","getLogger","localAPIDefaults","DEFAULT_DESCRIPTION","findGlobalTool","description","input","object","depth","number","int","min","max","describe","optional","default","fallbackLocale","string","locale","select","handler","authorizedMCP","globalSlug","req","payload","logger","info","findOptions","slug","selectClause","JSON","parse","warn","content","type","text","result","findGlobal","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SAASC,gBAAgB,QAAQ,qCAAoC;AAErE,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,iBAAiBJ,iBAAiB;IAC7CK,aAAaF;IACbG,OAAOP,EAAEQ,MAAM,CAAC;QACdC,OAAOT,EACJU,MAAM,GACNC,GAAG,GACHC,GAAG,CAAC,GACJC,GAAG,CAAC,IACJC,QAAQ,CAAC,yCACTC,QAAQ,GACRC,OAAO,CAAC;QACXC,gBAAgBjB,EACbkB,MAAM,GACNJ,QAAQ,CAAC,gFACTC,QAAQ;QACXI,QAAQnB,EACLkB,MAAM,GACNJ,QAAQ,CACP,wHAEDC,QAAQ;QACXK,QAAQpB,EACLkB,MAAM,GACNJ,QAAQ,CACP,gHAEDC,QAAQ;IACb;AACF,GAAGM,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,UAAU,EAAEhB,KAAK,EAAEiB,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAASxB,UAAU;QAAEuB;IAAQ;IAEnC,MAAM,EAAEhB,KAAK,EAAEQ,cAAc,EAAEE,MAAM,EAAEC,MAAM,EAAE,GAAGb;IAElDmB,OAAOC,IAAI,CACT,CAAC,gBAAgB,EAAEJ,WAAW,SAAS,EAAEd,QAAQU,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAGxF,IAAI;QACF,MAAMS,cAAwD;YAC5DC,MAAMN;YACNd;YACA,GAAGN,iBAAiBmB,cAAc;QACpC;QAEA,IAAIQ;QACJ,IAAIV,QAAQ;YACV,IAAI;gBACFU,eAAeC,KAAKC,KAAK,CAACZ;YAC5B,EAAE,OAAM;gBACNM,OAAOO,IAAI,CAAC,CAAC,uCAAuC,EAAEb,QAAQ;gBAC9D,OAAO;oBAAEc,SAAS;wBAAC;4BAAEC,MAAM;4BAAQC,MAAM;wBAAuC;qBAAE;gBAAC;YACrF;QACF;QAEA,IAAIjB,QAAQ;YACVS,YAAYT,MAAM,GAAGA;QACvB;QACA,IAAIF,gBAAgB;YAClBW,YAAYX,cAAc,GAAGA;QAC/B;QACA,IAAIa,cAAc;YAChBF,YAAYR,MAAM,GAAGU;QACvB;QAEA,MAAMO,SAAS,MAAMZ,QAAQa,UAAU,CAACV;QAExC,OAAO;YACLM,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAEb,WAAW,gBAAgB,EAAEQ,KAAKQ,SAAS,CAACF,QAAQ,QAAQ,CAAC;gBAChF;aACD;YACDG,KAAKH;QACP;IACF,EAAE,OAAOI,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DlB,OAAOe,KAAK,CAAC,CAAC,qBAAqB,EAAElB,WAAW,EAAE,EAAEmB,cAAc;QAClE,OAAO;YACLR,SAAS;gBACP;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,0BAA0B,EAAEb,WAAW,KAAK,EAAEmB,cAAc;gBAAC;aACrF;QACH;IACF;AACF,GAAE"}

package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts

@@ -0,0 +1,2 @@
+export declare const getGlobalSchemaTool: import("../../../types.js").GlobalTool;
+//# sourceMappingURL=getGlobalSchemaTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getGlobalSchemaTool.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,wCAwB9B,CAAA"}

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

@@ -0,0 +1,35 @@
+import { defineGlobalTool } from '../../../defineTool.js';
+import { getGlobalInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js';
+export const getGlobalSchemaTool = defineGlobalTool({
+    description: 'Get the input schema for updating a global.'
+}).handler(({ globalSlug, req })=>{
+    const inputSchema = getGlobalInputSchema({
+        globalSlug,
+        req
+    });
+    if (!inputSchema) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: Global "${globalSlug}" not found`
+                }
+            ],
+            isError: true
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Schema for global "${globalSlug}":\n\`\`\`json\n${JSON.stringify(inputSchema)}\n\`\`\``
+            }
+        ],
+        structuredContent: {
+            globalSlug,
+            schema: inputSchema
+        }
+    };
+});
+
+//# sourceMappingURL=getGlobalSchemaTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/builtin/globals/getGlobalSchemaTool.ts"],"sourcesContent":["import { defineGlobalTool } from '../../../defineTool.js'\nimport { getGlobalInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'\n\nexport const getGlobalSchemaTool = defineGlobalTool({\n  description: 'Get the input schema for updating a global.',\n}).handler(({ globalSlug, req }) => {\n  const inputSchema = getGlobalInputSchema({ globalSlug, req })\n\n  if (!inputSchema) {\n    return {\n      content: [{ type: 'text', text: `Error: Global \"${globalSlug}\" not found` }],\n      isError: true,\n    }\n  }\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Schema for global \"${globalSlug}\":\\n\\`\\`\\`json\\n${JSON.stringify(inputSchema)}\\n\\`\\`\\``,\n      },\n    ],\n    structuredContent: {\n      globalSlug,\n      schema: inputSchema,\n    },\n  }\n})\n"],"names":["defineGlobalTool","getGlobalInputSchema","getGlobalSchemaTool","description","handler","globalSlug","req","inputSchema","content","type","text","isError","JSON","stringify","structuredContent","schema"],"mappings":"AAAA,SAASA,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,oBAAoB,QAAQ,0DAAyD;AAE9F,OAAO,MAAMC,sBAAsBF,iBAAiB;IAClDG,aAAa;AACf,GAAGC,OAAO,CAAC,CAAC,EAAEC,UAAU,EAAEC,GAAG,EAAE;IAC7B,MAAMC,cAAcN,qBAAqB;QAAEI;QAAYC;IAAI;IAE3D,IAAI,CAACC,aAAa;QAChB,OAAO;YACLC,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,eAAe,EAAEL,WAAW,WAAW,CAAC;gBAAC;aAAE;YAC5EM,SAAS;QACX;IACF;IAEA,OAAO;QACLH,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,mBAAmB,EAAEL,WAAW,gBAAgB,EAAEO,KAAKC,SAAS,CAACN,aAAa,QAAQ,CAAC;YAChG;SACD;QACDO,mBAAmB;YACjBT;YACAU,QAAQR;QACV;IACF;AACF,GAAE"}

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,wCAkG3B,CAAA"}

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

@@ -3,26 +3,19 @@ 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';
-const DEFAULT_DESCRIPTION = 'Update a Payload global singleton configuration.';
+import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js';
+import { validateGlobalData } from '../validateEntityData.js';
+const DEFAULT_DESCRIPTION = 'Update any Payload global by passing the global slug and data.';
 export const updateGlobalTool = defineGlobalTool({
     description: DEFAULT_DESCRIPTION,
-    input: ({ globalSchema })=>{
-        const partialSchema = prepareCollectionSchema(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()
-        });
-    }
+    input: z.object({
+        data: z.record(z.string(), z.unknown()).describe('The global 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\": true}'").optional()
+    })
 }).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
     const payload = req.payload;
     const logger = getLogger({
@@ -32,7 +25,16 @@ export const updateGlobalTool = defineGlobalTool({
     logger.info(`Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
     try {
         const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, globalSlug);
-        const parsedData = stripVirtualFields(data, virtualFieldNames);
+        const inputData = stripVirtualFields(data, virtualFieldNames);
+        const validationError = validateGlobalData({
+            data: inputData,
+            globalSlug,
+            req
+        });
+        if (validationError) {
+            return validationError;
+        }
+        const parsedData = transformPointDataToPayload(inputData);
         let selectClause;
         if (select) {
             try {

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 { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\nimport { validateGlobalData } from '../validateEntityData.js'\n\nconst DEFAULT_DESCRIPTION = 'Update any Payload global by passing the global slug and data.'\n\nexport const updateGlobalTool = defineGlobalTool({\n  description: DEFAULT_DESCRIPTION,\n  input: z.object({\n    data: z.record(z.string(), z.unknown()).describe('The global 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\\\": true}'\",\n      )\n      .optional(),\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 inputData = stripVirtualFields(data, virtualFieldNames)\n    const validationError = validateGlobalData({ data: inputData, globalSlug, req })\n\n    if (validationError) {\n      return validationError\n    }\n\n    const parsedData = transformPointDataToPayload(inputData)\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","transformPointDataToPayload","validateGlobalData","DEFAULT_DESCRIPTION","updateGlobalTool","description","input","object","data","record","string","unknown","describe","depth","number","optional","default","draft","boolean","fallbackLocale","locale","select","handler","authorizedMCP","globalSlug","req","payload","logger","info","virtualFieldNames","config","inputData","validationError","parsedData","selectClause","JSON","parse","warn","content","type","text","updateOptions","slug","result","updateGlobal","stringify","doc","error","errorMessage","Error","message"],"mappings":"AAEA,SAASA,CAAC,QAAQ,MAAK;AAEvB,SAASC,gBAAgB,QAAQ,yBAAwB;AACzD,SAASC,SAAS,QAAQ,8BAA6B;AACvD,SACEC,0BAA0B,EAC1BC,kBAAkB,QACb,yCAAwC;AAC/C,SAASC,gBAAgB,QAAQ,qCAAoC;AACrE,SAASC,2BAA2B,QAAQ,gDAA+C;AAC3F,SAASC,kBAAkB,QAAQ,2BAA0B;AAE7D,MAAMC,sBAAsB;AAE5B,OAAO,MAAMC,mBAAmBR,iBAAiB;IAC/CS,aAAaF;IACbG,OAAOX,EAAEY,MAAM,CAAC;QACdC,MAAMb,EAAEc,MAAM,CAACd,EAAEe,MAAM,IAAIf,EAAEgB,OAAO,IAAIC,QAAQ,CAAC;QACjDC,OAAOlB,EACJmB,MAAM,GACNF,QAAQ,CAAC,gDACTG,QAAQ,GACRC,OAAO,CAAC;QACXC,OAAOtB,EACJuB,OAAO,GACPN,QAAQ,CAAC,uDACTG,QAAQ,GACRC,OAAO,CAAC;QACXG,gBAAgBxB,EACbe,MAAM,GACNE,QAAQ,CAAC,gFACTG,QAAQ;QACXK,QAAQzB,EACLe,MAAM,GACNE,QAAQ,CACP,oHAEDG,QAAQ;QACXM,QAAQ1B,EACLe,MAAM,GACNE,QAAQ,CACP,mHAEDG,QAAQ;IACb;AACF,GAAGO,OAAO,CAAC,OAAO,EAAEC,aAAa,EAAEC,UAAU,EAAElB,KAAK,EAAEmB,GAAG,EAAE;IACzD,MAAMC,UAAUD,IAAIC,OAAO;IAC3B,MAAMC,SAAS9B,UAAU;QAAE6B;IAAQ;IAEnC,MAAM,EAAElB,IAAI,EAAEK,KAAK,EAAEI,KAAK,EAAEE,cAAc,EAAEC,MAAM,EAAEC,MAAM,EAAE,GAAGf;IAE/DqB,OAAOC,IAAI,CACT,CAAC,iBAAiB,EAAEJ,WAAW,SAAS,EAAEP,QAAQG,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;IAGzF,IAAI;QACF,MAAMS,oBAAoB/B,2BAA2B4B,QAAQI,MAAM,EAAEN;QACrE,MAAMO,YAAYhC,mBAAmBS,MAAMqB;QAC3C,MAAMG,kBAAkB9B,mBAAmB;YAAEM,MAAMuB;YAAWP;YAAYC;QAAI;QAE9E,IAAIO,iBAAiB;YACnB,OAAOA;QACT;QAEA,MAAMC,aAAahC,4BAA4B8B;QAE/C,IAAIG;QACJ,IAAIb,QAAQ;YACV,IAAI;gBACFa,eAAeC,KAAKC,KAAK,CAACf;YAC5B,EAAE,OAAM;gBACNM,OAAOU,IAAI,CAAC,CAAC,uCAAuC,EAAEhB,QAAQ;gBAC9D,OAAO;oBAAEiB,SAAS;wBAAC;4BAAEC,MAAM;4BAAQC,MAAM;wBAAuC;qBAAE;gBAAC;YACrF;QACF;QAEA,MAAMC,gBAA4D;YAChEC,MAAMlB;YACNhB,MAAMyB;YACNpB;YACAI;YACA,GAAGjB,iBAAiBuB,cAAc;QACpC;QAEA,IAAIH,QAAQ;YACVqB,cAAcrB,MAAM,GAAGA;QACzB;QACA,IAAID,gBAAgB;YAClBsB,cAActB,cAAc,GAAGA;QACjC;QACA,IAAIe,cAAc;YAChBO,cAAcpB,MAAM,GAAGa;QACzB;QAEA,MAAMS,SAAS,MAAMjB,QAAQkB,YAAY,CAACH;QAE1C,OAAO;YACLH,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,QAAQ,EAAEhB,WAAW,qCAAqC,EAAEW,KAAKU,SAAS,CAACF,QAAQ,QAAQ,CAAC;gBACrG;aACD;YACDG,KAAKH;QACP;IACF,EAAE,OAAOI,OAAO;QACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;QAC9DvB,OAAOoB,KAAK,CAAC,CAAC,sBAAsB,EAAEvB,WAAW,EAAE,EAAEwB,cAAc;QACnE,OAAO;YACLV,SAAS;gBAAC;oBAAEC,MAAM;oBAAQC,MAAM,CAAC,uBAAuB,EAAEhB,WAAW,GAAG,EAAEwB,cAAc;gBAAC;aAAE;QAC7F;IACF;AACF,GAAE"}

package/dist/mcp/builtin/validateEntityData.d.ts

@@ -0,0 +1,14 @@
+import type { CollectionSlug, GlobalSlug, PayloadRequest } from 'payload';
+import type { MCPToolResponse } from '../../types.js';
+export declare const validateCollectionData: ({ collectionSlug, data, partial, req, }: {
+    collectionSlug: CollectionSlug;
+    data: Record<string, unknown>;
+    partial?: boolean;
+    req: PayloadRequest;
+}) => MCPToolResponse | null;
+export declare const validateGlobalData: ({ data, globalSlug, req, }: {
+    data: Record<string, unknown>;
+    globalSlug: GlobalSlug;
+    req: PayloadRequest;
+}) => MCPToolResponse | null;
+//# sourceMappingURL=validateEntityData.d.ts.map

package/dist/mcp/builtin/validateEntityData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEntityData.d.ts","sourceRoot":"","sources":["../../../src/mcp/builtin/validateEntityData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAA;AAI1F,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAuBrE,eAAO,MAAM,sBAAsB,GAAI,yCAKpC;IACD,cAAc,EAAE,cAAc,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,eAAe,GAAG,IAQlB,CAAA;AAEJ,eAAO,MAAM,kBAAkB,GAAI,4BAIhC;IACD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,eAAe,GAAG,IAQlB,CAAA"}