@payloadcms/plugin-mcp 3.70.0-canary.9 → 3.71.0-canary.2

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

@@ -0,0 +1,59 @@
+import { toCamelCase } from '../../../utils/camelCase.js';
+import { toolSchemas } from '../schemas.js';
+export const findGlobalTool = (server, req, user, verboseLogs, globalSlug, globals)=>{
+    const tool = async (depth = 0, locale, fallbackLocale)=>{
+        const payload = req.payload;
+        if (verboseLogs) {
+            payload.logger.info(`[payload-mcp] Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`);
+        }
+        try {
+            const findOptions = {
+                slug: globalSlug,
+                depth,
+                user
+            };
+            // Add locale parameters if provided
+            if (locale) {
+                findOptions.locale = locale;
+            }
+            if (fallbackLocale) {
+                findOptions.fallbackLocale = fallbackLocale;
+            }
+            const result = await payload.findGlobal(findOptions);
+            if (verboseLogs) {
+                payload.logger.info(`[payload-mcp] Found global: ${globalSlug}`);
+            }
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Global "${globalSlug}":
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+                    }
+                ]
+            };
+            return globals?.[globalSlug]?.overrideResponse?.(response, result, req) || response;
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            payload.logger.error(`[payload-mcp] Error reading global ${globalSlug}: ${errorMessage}`);
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ **Error reading global "${globalSlug}":** ${errorMessage}`
+                    }
+                ]
+            };
+            return globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response;
+        }
+    };
+    if (globals?.[globalSlug]?.enabled) {
+        server.tool(`find${globalSlug.charAt(0).toUpperCase() + toCamelCase(globalSlug).slice(1)}`, `${toolSchemas.findGlobal.description.trim()}\n\n${globals?.[globalSlug]?.description || ''}`, toolSchemas.findGlobal.parameters.shape, async ({ depth, fallbackLocale, locale })=>{
+            return await tool(depth, locale, fallbackLocale);
+        });
+    }
+};
+
+//# sourceMappingURL=find.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/tools/global/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findGlobalTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  globalSlug: string,\n  globals: PluginMCPServerConfig['globals'],\n) => {\n  const tool = async (\n    depth: number = 0,\n    locale?: string,\n    fallbackLocale?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      const findOptions: Parameters<typeof payload.findGlobal>[0] = {\n        slug: globalSlug,\n        depth,\n        user,\n      }\n\n      // Add locale parameters if provided\n      if (locale) {\n        findOptions.locale = locale\n      }\n      if (fallbackLocale) {\n        findOptions.fallbackLocale = fallbackLocale\n      }\n\n      const result = await payload.findGlobal(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(`[payload-mcp] Found global: ${globalSlug}`)\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Global \"${globalSlug}\":\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\n          },\n        ],\n      }\n\n      return (globals?.[globalSlug]?.overrideResponse?.(response, result, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(`[payload-mcp] Error reading global ${globalSlug}: ${errorMessage}`)\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading global \"${globalSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (globals?.[globalSlug]?.enabled) {\n    server.tool(\n      `find${globalSlug.charAt(0).toUpperCase() + toCamelCase(globalSlug).slice(1)}`,\n      `${toolSchemas.findGlobal.description.trim()}\\n\\n${globals?.[globalSlug]?.description || ''}`,\n      toolSchemas.findGlobal.parameters.shape,\n      async ({ depth, fallbackLocale, locale }) => {\n        return await tool(depth, locale, fallbackLocale)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findGlobalTool","server","req","user","verboseLogs","globalSlug","globals","tool","depth","locale","fallbackLocale","payload","logger","info","findOptions","slug","result","findGlobal","response","content","type","text","JSON","stringify","overrideResponse","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","trim","parameters","shape"],"mappings":"AAKA,SAASA,WAAW,QAAQ,8BAA6B;AACzD,SAASC,WAAW,QAAQ,gBAAe;AAE3C,OAAO,MAAMC,iBAAiB,CAC5BC,QACAC,KACAC,MACAC,aACAC,YACAC;IAEA,MAAMC,OAAO,OACXC,QAAgB,CAAC,EACjBC,QACAC;QAOA,MAAMC,UAAUT,IAAIS,OAAO;QAE3B,IAAIP,aAAa;YACfO,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,8BAA8B,EAAER,WAAW,SAAS,EAAEG,QAAQC,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;QAExG;QAEA,IAAI;YACF,MAAMK,cAAwD;gBAC5DC,MAAMV;gBACNG;gBACAL;YACF;YAEA,oCAAoC;YACpC,IAAIM,QAAQ;gBACVK,YAAYL,MAAM,GAAGA;YACvB;YACA,IAAIC,gBAAgB;gBAClBI,YAAYJ,cAAc,GAAGA;YAC/B;YAEA,MAAMM,SAAS,MAAML,QAAQM,UAAU,CAACH;YAExC,IAAIV,aAAa;gBACfO,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,4BAA4B,EAAER,YAAY;YACjE;YAEA,MAAMa,WAAW;gBACfC,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAM,CAAC,QAAQ,EAAEhB,WAAW;;AAExC,EAAEiB,KAAKC,SAAS,CAACP,QAAQ,MAAM,GAAG;MAC5B,CAAC;oBACG;iBACD;YACH;YAEA,OAAQV,SAAS,CAACD,WAAW,EAAEmB,mBAAmBN,UAAUF,QAAQd,QAAQgB;QAM9E,EAAE,OAAOO,OAAO;YACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;YAC9DjB,QAAQC,MAAM,CAACa,KAAK,CAAC,CAAC,mCAAmC,EAAEpB,WAAW,EAAE,EAAEqB,cAAc;YACxF,MAAMR,WAAW;gBACfC,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAM,CAAC,0BAA0B,EAAEhB,WAAW,KAAK,EAAEqB,cAAc;oBACrE;iBACD;YACH;YACA,OAAQpB,SAAS,CAACD,WAAW,EAAEmB,mBAAmBN,UAAU,CAAC,GAAGhB,QAAQgB;QAM1E;IACF;IAEA,IAAIZ,SAAS,CAACD,WAAW,EAAEwB,SAAS;QAClC5B,OAAOM,IAAI,CACT,CAAC,IAAI,EAAEF,WAAWyB,MAAM,CAAC,GAAGC,WAAW,KAAKjC,YAAYO,YAAY2B,KAAK,CAAC,IAAI,EAC9E,GAAGjC,YAAYkB,UAAU,CAACgB,WAAW,CAACC,IAAI,GAAG,IAAI,EAAE5B,SAAS,CAACD,WAAW,EAAE4B,eAAe,IAAI,EAC7FlC,YAAYkB,UAAU,CAACkB,UAAU,CAACC,KAAK,EACvC,OAAO,EAAE5B,KAAK,EAAEE,cAAc,EAAED,MAAM,EAAE;YACtC,OAAO,MAAMF,KAAKC,OAAOC,QAAQC;QACnC;IAEJ;AACF,EAAC"}

package/dist/mcp/tools/global/update.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { JSONSchema4 } from 'json-schema';
+import type { PayloadRequest, TypedUser } from 'payload';
+import type { PluginMCPServerConfig } from '../../../types.js';
+export declare const updateGlobalTool: (server: McpServer, req: PayloadRequest, user: TypedUser, verboseLogs: boolean, globalSlug: string, globals: PluginMCPServerConfig["globals"], schema: JSONSchema4) => void;
+//# sourceMappingURL=update.d.ts.map

package/dist/mcp/tools/global/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/global/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAM9D,eAAO,MAAM,gBAAgB,WACnB,SAAS,OACZ,cAAc,QACb,SAAS,eACF,OAAO,cACR,MAAM,WACT,qBAAqB,CAAC,SAAS,CAAC,UACjC,WAAW,SAoJpB,CAAA"}

package/dist/mcp/tools/global/update.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { toCamelCase } from '../../../utils/camelCase.js';
+import { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js';
+import { toolSchemas } from '../schemas.js';
+export const updateGlobalTool = (server, req, user, verboseLogs, globalSlug, globals, schema)=>{
+    const tool = async (data, draft = false, depth = 0, locale, fallbackLocale)=>{
+        const payload = req.payload;
+        if (verboseLogs) {
+            payload.logger.info(`[payload-mcp] Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
+        }
+        try {
+            // Parse the data JSON
+            let parsedData;
+            try {
+                parsedData = JSON.parse(data);
+                if (verboseLogs) {
+                    payload.logger.info(`[payload-mcp] Parsed data for ${globalSlug}: ${JSON.stringify(parsedData)}`);
+                }
+            } catch (_parseError) {
+                payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`);
+                const response = {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Invalid JSON data provided'
+                        }
+                    ]
+                };
+                return globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response;
+            }
+            const updateOptions = {
+                slug: globalSlug,
+                data: parsedData,
+                depth,
+                draft,
+                user
+            };
+            // Add locale parameters if provided
+            if (locale) {
+                updateOptions.locale = locale;
+            }
+            if (fallbackLocale) {
+                updateOptions.fallbackLocale = fallbackLocale;
+            }
+            const result = await payload.updateGlobal(updateOptions);
+            if (verboseLogs) {
+                payload.logger.info(`[payload-mcp] Successfully updated global: ${globalSlug}`);
+            }
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Global "${globalSlug}" updated successfully!
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+                    }
+                ]
+            };
+            return globals?.[globalSlug]?.overrideResponse?.(response, result, req) || response;
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            payload.logger.error(`[payload-mcp] Error updating global ${globalSlug}: ${errorMessage}`);
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error updating global "${globalSlug}": ${errorMessage}`
+                    }
+                ]
+            };
+            return globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response;
+        }
+    };
+    if (globals?.[globalSlug]?.enabled) {
+        const convertedFields = convertCollectionSchemaToZod(schema);
+        // Make all fields optional for partial updates (PATCH-style)
+        const optionalFields = Object.fromEntries(Object.entries(convertedFields.shape).map(([key, value])=>[
+                key,
+                value.optional()
+            ]));
+        const updateGlobalSchema = z.object({
+            ...optionalFields,
+            depth: z.number().optional().describe('Optional: Depth of relationships to populate'),
+            draft: z.boolean().optional().describe('Optional: Whether to save as draft (default: false)'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
+            locale: z.string().optional().describe('Optional: locale code to update data in (e.g., "en", "es"). Use "all" to update all locales for localized fields')
+        });
+        server.tool(`update${globalSlug.charAt(0).toUpperCase() + toCamelCase(globalSlug).slice(1)}`, `${toolSchemas.updateGlobal.description.trim()}\n\n${globals?.[globalSlug]?.description || ''}`, updateGlobalSchema.shape, async (params)=>{
+            const { depth, draft, fallbackLocale, locale, ...rest } = params;
+            const data = JSON.stringify(rest);
+            return await tool(data, draft, depth, locale, fallbackLocale);
+        });
+    }
+};
+
+//# sourceMappingURL=update.js.map

package/dist/mcp/tools/global/update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/tools/global/update.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport { z } from 'zod'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { convertCollectionSchemaToZod } from '../../../utils/convertCollectionSchemaToZod.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const updateGlobalTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  globalSlug: string,\n  globals: PluginMCPServerConfig['globals'],\n  schema: JSONSchema4,\n) => {\n  const tool = async (\n    data: string,\n    draft: boolean = false,\n    depth: number = 0,\n    locale?: string,\n    fallbackLocale?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse the data JSON\n      let parsedData: Record<string, unknown>\n      try {\n        parsedData = JSON.parse(data)\n        if (verboseLogs) {\n          payload.logger.info(\n            `[payload-mcp] Parsed data for ${globalSlug}: ${JSON.stringify(parsedData)}`,\n          )\n        }\n      } catch (_parseError) {\n        payload.logger.error(`[payload-mcp] Invalid JSON data provided: ${data}`)\n        const response = {\n          content: [{ type: 'text' as const, text: 'Error: Invalid JSON data provided' }],\n        }\n        return (globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response) as {\n          content: Array<{\n            text: string\n            type: 'text'\n          }>\n        }\n      }\n\n      const updateOptions: Parameters<typeof payload.updateGlobal>[0] = {\n        slug: globalSlug,\n        data: parsedData,\n        depth,\n        draft,\n        user,\n      }\n\n      // Add locale parameters if provided\n      if (locale) {\n        updateOptions.locale = locale\n      }\n      if (fallbackLocale) {\n        updateOptions.fallbackLocale = fallbackLocale\n      }\n\n      const result = await payload.updateGlobal(updateOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(`[payload-mcp] Successfully updated global: ${globalSlug}`)\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Global \"${globalSlug}\" updated successfully!\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\n          },\n        ],\n      }\n\n      return (globals?.[globalSlug]?.overrideResponse?.(response, result, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(`[payload-mcp] Error updating global ${globalSlug}: ${errorMessage}`)\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `Error updating global \"${globalSlug}\": ${errorMessage}`,\n          },\n        ],\n      }\n\n      return (globals?.[globalSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (globals?.[globalSlug]?.enabled) {\n    const convertedFields = convertCollectionSchemaToZod(schema)\n\n    // Make all fields optional for partial updates (PATCH-style)\n    const optionalFields = Object.fromEntries(\n      Object.entries(convertedFields.shape).map(([key, value]) => [key, (value as any).optional()]),\n    )\n\n    const updateGlobalSchema = z.object({\n      ...optionalFields,\n      depth: z.number().optional().describe('Optional: Depth of relationships to populate'),\n      draft: z.boolean().optional().describe('Optional: Whether to save as draft (default: false)'),\n      fallbackLocale: z\n        .string()\n        .optional()\n        .describe('Optional: fallback locale code to use when requested locale is not available'),\n      locale: z\n        .string()\n        .optional()\n        .describe(\n          'Optional: locale code to update data in (e.g., \"en\", \"es\"). Use \"all\" to update all locales for localized fields',\n        ),\n    })\n\n    server.tool(\n      `update${globalSlug.charAt(0).toUpperCase() + toCamelCase(globalSlug).slice(1)}`,\n      `${toolSchemas.updateGlobal.description.trim()}\\n\\n${globals?.[globalSlug]?.description || ''}`,\n      updateGlobalSchema.shape,\n      async (params: Record<string, unknown>) => {\n        const { depth, draft, fallbackLocale, locale, ...rest } = params\n        const data = JSON.stringify(rest)\n        return await tool(\n          data,\n          draft as boolean,\n          depth as number,\n          locale as string,\n          fallbackLocale as string,\n        )\n      },\n    )\n  }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","toolSchemas","updateGlobalTool","server","req","user","verboseLogs","globalSlug","globals","schema","tool","data","draft","depth","locale","fallbackLocale","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","response","content","type","text","overrideResponse","updateOptions","slug","result","updateGlobal","errorMessage","Error","message","enabled","convertedFields","optionalFields","Object","fromEntries","entries","shape","map","key","value","optional","updateGlobalSchema","object","number","describe","boolean","string","charAt","toUpperCase","slice","description","trim","params","rest"],"mappings":"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"}

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

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

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

@@ -1,7 +1,7 @@
 import { toCamelCase } from '../../../utils/camelCase.js';
 import { toolSchemas } from '../schemas.js';
 export const findResourceTool = (server, req, user, verboseLogs, collectionSlug, collections)=>{
-    const tool = async (id, limit = 10, page = 1, sort, where, locale, fallbackLocale)=>{
+    const tool = async (id, limit = 10, page = 1, sort, where, locale, fallbackLocale, draft)=>{
         const payload = req.payload;
         if (verboseLogs) {
             payload.logger.info(`[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`);
@@ -42,6 +42,9 @@ export const findResourceTool = (server, req, user, verboseLogs, collectionSlug,
                         },
                         ...fallbackLocale && {
                             fallbackLocale
+                        },
+                        ...draft !== undefined && {
+                            draft
                         }
                     });
                     if (verboseLogs) {
@@ -83,6 +86,9 @@ ${JSON.stringify(doc, null, 2)}`
                 },
                 ...fallbackLocale && {
                     fallbackLocale
+                },
+                ...draft !== undefined && {
+                    draft
                 }
             };
             if (sort) {
@@ -126,8 +132,8 @@ Page: ${result.page} of ${result.totalPages}
         }
     };
     if (collections?.[collectionSlug]?.enabled) {
-        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, fallbackLocale, limit, locale, page, sort, where })=>{
-            return await tool(id, limit, page, sort, where, locale, fallbackLocale);
+        server.tool(`find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`, `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`, toolSchemas.findResources.parameters.shape, async ({ id, draft, fallbackLocale, limit, locale, page, sort, where })=>{
+            return await tool(id, limit, page, sort, where, locale, fallbackLocale, draft);
         });
     }
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/mcp/tools/resource/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n) => {\n  const tool = async (\n    id?: number | string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n    locale?: string,\n    fallbackLocale?: string,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // If ID is provided, use findByID\n      if (id) {\n        try {\n          const doc = await payload.findByID({\n            id,\n            collection: collectionSlug,\n            overrideAccess: false,\n            req,\n            user,\n            ...(locale && { locale }),\n            ...(fallbackLocale && { fallbackLocale }),\n          })\n\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Found document with ID: ${id}`)\n          }\n\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Resource from collection \"${collectionSlug}\":\n${JSON.stringify(doc, null, 2)}`,\n              },\n            ],\n          }\n\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        } catch (_findError) {\n          payload.logger.warn(\n            `[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`,\n          )\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Error: Document with ID \"${id}\" not found in collection \"${collectionSlug}\"`,\n              },\n            ],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Otherwise, use find to get multiple documents\n      const findOptions: Parameters<typeof payload.find>[0] = {\n        collection: collectionSlug,\n        limit,\n        overrideAccess: false,\n        page,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n      }\n\n      if (sort) {\n        findOptions.sort = sort\n      }\n\n      if (Object.keys(whereClause).length > 0) {\n        findOptions.where = whereClause\n      }\n\n      const result = await payload.find(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`,\n        )\n      }\n\n      let responseText = `Collection: \"${collectionSlug}\"\nTotal: ${result.totalDocs} documents\nPage: ${result.page} of ${result.totalPages}\n`\n\n      for (const doc of result.docs) {\n        responseText += `\\n\\`\\`\\`json\\n${JSON.stringify(doc, null, 2)}\\n\\`\\`\\``\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`,\n      )\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading resources from collection \"${collectionSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    server.tool(\n      `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, fallbackLocale, limit, locale, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where, locale, fallbackLocale)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","locale","fallbackLocale","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","overrideAccess","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/mcp/tools/resource/find.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { PayloadRequest, TypedUser } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../../../types.js'\n\nimport { toCamelCase } from '../../../utils/camelCase.js'\nimport { toolSchemas } from '../schemas.js'\n\nexport const findResourceTool = (\n  server: McpServer,\n  req: PayloadRequest,\n  user: TypedUser,\n  verboseLogs: boolean,\n  collectionSlug: string,\n  collections: PluginMCPServerConfig['collections'],\n) => {\n  const tool = async (\n    id?: number | string,\n    limit: number = 10,\n    page: number = 1,\n    sort?: string,\n    where?: string,\n    locale?: string,\n    fallbackLocale?: string,\n    draft?: boolean,\n  ): Promise<{\n    content: Array<{\n      text: string\n      type: 'text'\n    }>\n  }> => {\n    const payload = req.payload\n\n    if (verboseLogs) {\n      payload.logger.info(\n        `[payload-mcp] Reading resource from collection: ${collectionSlug}${id ? ` with ID: ${id}` : ''}, limit: ${limit}, page: ${page}${locale ? `, locale: ${locale}` : ''}`,\n      )\n    }\n\n    try {\n      // Parse where clause if provided\n      let whereClause = {}\n      if (where) {\n        try {\n          whereClause = JSON.parse(where)\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Using where clause: ${where}`)\n          }\n        } catch (_parseError) {\n          payload.logger.warn(`[payload-mcp] Invalid where clause JSON: ${where}`)\n          const response = {\n            content: [{ type: 'text' as const, text: 'Error: Invalid JSON in where clause' }],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // If ID is provided, use findByID\n      if (id) {\n        try {\n          const doc = await payload.findByID({\n            id,\n            collection: collectionSlug,\n            overrideAccess: false,\n            req,\n            user,\n            ...(locale && { locale }),\n            ...(fallbackLocale && { fallbackLocale }),\n            ...(draft !== undefined && { draft }),\n          })\n\n          if (verboseLogs) {\n            payload.logger.info(`[payload-mcp] Found document with ID: ${id}`)\n          }\n\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Resource from collection \"${collectionSlug}\":\n${JSON.stringify(doc, null, 2)}`,\n              },\n            ],\n          }\n\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, doc, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        } catch (_findError) {\n          payload.logger.warn(\n            `[payload-mcp] Document not found with ID: ${id} in collection: ${collectionSlug}`,\n          )\n          const response = {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Error: Document with ID \"${id}\" not found in collection \"${collectionSlug}\"`,\n              },\n            ],\n          }\n          return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) ||\n            response) as {\n            content: Array<{\n              text: string\n              type: 'text'\n            }>\n          }\n        }\n      }\n\n      // Otherwise, use find to get multiple documents\n      const findOptions: Parameters<typeof payload.find>[0] = {\n        collection: collectionSlug,\n        limit,\n        overrideAccess: false,\n        page,\n        req,\n        user,\n        ...(locale && { locale }),\n        ...(fallbackLocale && { fallbackLocale }),\n        ...(draft !== undefined && { draft }),\n      }\n\n      if (sort) {\n        findOptions.sort = sort\n      }\n\n      if (Object.keys(whereClause).length > 0) {\n        findOptions.where = whereClause\n      }\n\n      const result = await payload.find(findOptions)\n\n      if (verboseLogs) {\n        payload.logger.info(\n          `[payload-mcp] Found ${result.docs.length} documents in collection: ${collectionSlug}`,\n        )\n      }\n\n      let responseText = `Collection: \"${collectionSlug}\"\nTotal: ${result.totalDocs} documents\nPage: ${result.page} of ${result.totalPages}\n`\n\n      for (const doc of result.docs) {\n        responseText += `\\n\\`\\`\\`json\\n${JSON.stringify(doc, null, 2)}\\n\\`\\`\\``\n      }\n\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n      }\n\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, result, req) ||\n        response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n      payload.logger.error(\n        `[payload-mcp] Error reading resources from collection ${collectionSlug}: ${errorMessage}`,\n      )\n      const response = {\n        content: [\n          {\n            type: 'text' as const,\n            text: `❌ **Error reading resources from collection \"${collectionSlug}\":** ${errorMessage}`,\n          },\n        ],\n      }\n      return (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) || response) as {\n        content: Array<{\n          text: string\n          type: 'text'\n        }>\n      }\n    }\n  }\n\n  if (collections?.[collectionSlug]?.enabled) {\n    server.tool(\n      `find${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n      `${collections?.[collectionSlug]?.description || toolSchemas.findResources.description.trim()}`,\n      toolSchemas.findResources.parameters.shape,\n      async ({ id, draft, fallbackLocale, limit, locale, page, sort, where }) => {\n        return await tool(id, limit, page, sort, where, locale, fallbackLocale, draft)\n      },\n    )\n  }\n}\n"],"names":["toCamelCase","toolSchemas","findResourceTool","server","req","user","verboseLogs","collectionSlug","collections","tool","id","limit","page","sort","where","locale","fallbackLocale","draft","payload","logger","info","whereClause","JSON","parse","_parseError","warn","response","content","type","text","overrideResponse","doc","findByID","collection","overrideAccess","undefined","stringify","_findError","findOptions","Object","keys","length","result","find","docs","responseText","totalDocs","totalPages","error","errorMessage","Error","message","enabled","charAt","toUpperCase","slice","description","findResources","trim","parameters","shape"],"mappings":"AAKA,SAASA,WAAW,QAAQ,8BAA6B;AACzD,SAASC,WAAW,QAAQ,gBAAe;AAE3C,OAAO,MAAMC,mBAAmB,CAC9BC,QACAC,KACAC,MACAC,aACAC,gBACAC;IAEA,MAAMC,OAAO,OACXC,IACAC,QAAgB,EAAE,EAClBC,OAAe,CAAC,EAChBC,MACAC,OACAC,QACAC,gBACAC;QAOA,MAAMC,UAAUd,IAAIc,OAAO;QAE3B,IAAIZ,aAAa;YACfY,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,gDAAgD,EAAEb,iBAAiBG,KAAK,CAAC,UAAU,EAAEA,IAAI,GAAG,GAAG,SAAS,EAAEC,MAAM,QAAQ,EAAEC,OAAOG,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;QAE3K;QAEA,IAAI;YACF,iCAAiC;YACjC,IAAIM,cAAc,CAAC;YACnB,IAAIP,OAAO;gBACT,IAAI;oBACFO,cAAcC,KAAKC,KAAK,CAACT;oBACzB,IAAIR,aAAa;wBACfY,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,kCAAkC,EAAEN,OAAO;oBAClE;gBACF,EAAE,OAAOU,aAAa;oBACpBN,QAAQC,MAAM,CAACM,IAAI,CAAC,CAAC,yCAAyC,EAAEX,OAAO;oBACvE,MAAMY,WAAW;wBACfC,SAAS;4BAAC;gCAAEC,MAAM;gCAAiBC,MAAM;4BAAsC;yBAAE;oBACnF;oBACA,OAAQrB,aAAa,CAACD,eAAe,EAAEuB,mBAAmBJ,UAAU,CAAC,GAAGtB,QACtEsB;gBAMJ;YACF;YAEA,kCAAkC;YAClC,IAAIhB,IAAI;gBACN,IAAI;oBACF,MAAMqB,MAAM,MAAMb,QAAQc,QAAQ,CAAC;wBACjCtB;wBACAuB,YAAY1B;wBACZ2B,gBAAgB;wBAChB9B;wBACAC;wBACA,GAAIU,UAAU;4BAAEA;wBAAO,CAAC;wBACxB,GAAIC,kBAAkB;4BAAEA;wBAAe,CAAC;wBACxC,GAAIC,UAAUkB,aAAa;4BAAElB;wBAAM,CAAC;oBACtC;oBAEA,IAAIX,aAAa;wBACfY,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,sCAAsC,EAAEV,IAAI;oBACnE;oBAEA,MAAMgB,WAAW;wBACfC,SAAS;4BACP;gCACEC,MAAM;gCACNC,MAAM,CAAC,0BAA0B,EAAEtB,eAAe;AAClE,EAAEe,KAAKc,SAAS,CAACL,KAAK,MAAM,IAAI;4BAClB;yBACD;oBACH;oBAEA,OAAQvB,aAAa,CAACD,eAAe,EAAEuB,mBAAmBJ,UAAUK,KAAK3B,QACvEsB;gBAMJ,EAAE,OAAOW,YAAY;oBACnBnB,QAAQC,MAAM,CAACM,IAAI,CACjB,CAAC,0CAA0C,EAAEf,GAAG,gBAAgB,EAAEH,gBAAgB;oBAEpF,MAAMmB,WAAW;wBACfC,SAAS;4BACP;gCACEC,MAAM;gCACNC,MAAM,CAAC,yBAAyB,EAAEnB,GAAG,2BAA2B,EAAEH,eAAe,CAAC,CAAC;4BACrF;yBACD;oBACH;oBACA,OAAQC,aAAa,CAACD,eAAe,EAAEuB,mBAAmBJ,UAAU,CAAC,GAAGtB,QACtEsB;gBAMJ;YACF;YAEA,gDAAgD;YAChD,MAAMY,cAAkD;gBACtDL,YAAY1B;gBACZI;gBACAuB,gBAAgB;gBAChBtB;gBACAR;gBACAC;gBACA,GAAIU,UAAU;oBAAEA;gBAAO,CAAC;gBACxB,GAAIC,kBAAkB;oBAAEA;gBAAe,CAAC;gBACxC,GAAIC,UAAUkB,aAAa;oBAAElB;gBAAM,CAAC;YACtC;YAEA,IAAIJ,MAAM;gBACRyB,YAAYzB,IAAI,GAAGA;YACrB;YAEA,IAAI0B,OAAOC,IAAI,CAACnB,aAAaoB,MAAM,GAAG,GAAG;gBACvCH,YAAYxB,KAAK,GAAGO;YACtB;YAEA,MAAMqB,SAAS,MAAMxB,QAAQyB,IAAI,CAACL;YAElC,IAAIhC,aAAa;gBACfY,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,oBAAoB,EAAEsB,OAAOE,IAAI,CAACH,MAAM,CAAC,0BAA0B,EAAElC,gBAAgB;YAE1F;YAEA,IAAIsC,eAAe,CAAC,aAAa,EAAEtC,eAAe;OACjD,EAAEmC,OAAOI,SAAS,CAAC;MACpB,EAAEJ,OAAO9B,IAAI,CAAC,IAAI,EAAE8B,OAAOK,UAAU,CAAC;AAC5C,CAAC;YAEK,KAAK,MAAMhB,OAAOW,OAAOE,IAAI,CAAE;gBAC7BC,gBAAgB,CAAC,cAAc,EAAEvB,KAAKc,SAAS,CAACL,KAAK,MAAM,GAAG,QAAQ,CAAC;YACzE;YAEA,MAAML,WAAW;gBACfC,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAMgB;oBACR;iBACD;YACH;YAEA,OAAQrC,aAAa,CAACD,eAAe,EAAEuB,mBAAmBJ,UAAUgB,QAAQtC,QAC1EsB;QAMJ,EAAE,OAAOsB,OAAO;YACd,MAAMC,eAAeD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;YAC9DjC,QAAQC,MAAM,CAAC6B,KAAK,CAClB,CAAC,sDAAsD,EAAEzC,eAAe,EAAE,EAAE0C,cAAc;YAE5F,MAAMvB,WAAW;gBACfC,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAM,CAAC,6CAA6C,EAAEtB,eAAe,KAAK,EAAE0C,cAAc;oBAC5F;iBACD;YACH;YACA,OAAQzC,aAAa,CAACD,eAAe,EAAEuB,mBAAmBJ,UAAU,CAAC,GAAGtB,QAAQsB;QAMlF;IACF;IAEA,IAAIlB,aAAa,CAACD,eAAe,EAAE6C,SAAS;QAC1CjD,OAAOM,IAAI,CACT,CAAC,IAAI,EAAEF,eAAe8C,MAAM,CAAC,GAAGC,WAAW,KAAKtD,YAAYO,gBAAgBgD,KAAK,CAAC,IAAI,EACtF,GAAG/C,aAAa,CAACD,eAAe,EAAEiD,eAAevD,YAAYwD,aAAa,CAACD,WAAW,CAACE,IAAI,IAAI,EAC/FzD,YAAYwD,aAAa,CAACE,UAAU,CAACC,KAAK,EAC1C,OAAO,EAAElD,EAAE,EAAEO,KAAK,EAAED,cAAc,EAAEL,KAAK,EAAEI,MAAM,EAAEH,IAAI,EAAEC,IAAI,EAAEC,KAAK,EAAE;YACpE,OAAO,MAAML,KAAKC,IAAIC,OAAOC,MAAMC,MAAMC,OAAOC,QAAQC,gBAAgBC;QAC1E;IAEJ;AACF,EAAC"}

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

@@ -1,9 +1,26 @@
 import { z } from 'zod';
 export declare const toolSchemas: {
+    findGlobal: {
+        description: string;
+        parameters: z.ZodObject<{
+            depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
+            locale: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            depth: number;
+            locale?: string | undefined;
+            fallbackLocale?: string | undefined;
+        }, {
+            depth?: number | undefined;
+            locale?: string | undefined;
+            fallbackLocale?: string | undefined;
+        }>;
+    };
     findResources: {
         description: string;
         parameters: z.ZodObject<{
             id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            draft: z.ZodOptional<z.ZodBoolean>;
             fallbackLocale: z.ZodOptional<z.ZodString>;
             limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             locale: z.ZodOptional<z.ZodString>;
@@ -13,19 +30,21 @@ export declare const toolSchemas: {
         }, "strip", z.ZodTypeAny, {
             limit: number;
             page: number;
-            sort?: string | undefined;
             locale?: string | undefined;
+            sort?: string | undefined;
+            draft?: boolean | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
-            where?: string | undefined;
         }, {
-            sort?: string | undefined;
             locale?: string | undefined;
+            sort?: string | undefined;
+            draft?: boolean | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
             limit?: number | undefined;
             page?: number | undefined;
-            where?: string | undefined;
         }>;
     };
     createResource: {
@@ -67,18 +86,18 @@ export declare const toolSchemas: {
             overrideLock: boolean;
             overwriteExistingFiles: boolean;
             locale?: string | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
-            where?: string | undefined;
             filePath?: string | undefined;
         }, {
             data: string;
             depth?: number | undefined;
             locale?: string | undefined;
             draft?: boolean | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
-            where?: string | undefined;
             filePath?: string | undefined;
             overrideLock?: boolean | undefined;
             overwriteExistingFiles?: boolean | undefined;
@@ -95,15 +114,37 @@ export declare const toolSchemas: {
         }, "strip", z.ZodTypeAny, {
             depth: number;
             locale?: string | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
-            where?: string | undefined;
         }, {
             depth?: number | undefined;
             locale?: string | undefined;
+            where?: string | undefined;
             id?: string | number | undefined;
             fallbackLocale?: string | undefined;
-            where?: string | undefined;
+        }>;
+    };
+    updateGlobal: {
+        description: string;
+        parameters: z.ZodObject<{
+            data: z.ZodString;
+            depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            fallbackLocale: z.ZodOptional<z.ZodString>;
+            locale: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            depth: number;
+            draft: boolean;
+            data: string;
+            locale?: string | undefined;
+            fallbackLocale?: string | undefined;
+        }, {
+            data: string;
+            depth?: number | undefined;
+            locale?: string | undefined;
+            draft?: boolean | undefined;
+            fallbackLocale?: string | undefined;
         }>;
     };
     createCollection: {
@@ -243,16 +284,16 @@ export declare const toolSchemas: {
             password: z.ZodString;
             showHiddenFields: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, "strip", z.ZodTypeAny, {
-            email: string;
+            collection: string;
             depth: number;
+            email: string;
             password: string;
-            collection: string;
             overrideAccess: boolean;
             showHiddenFields: boolean;
         }, {
+            collection: string;
             email: string;
             password: string;
-            collection: string;
             depth?: number | undefined;
             overrideAccess?: boolean | undefined;
             showHiddenFields?: boolean | undefined;
@@ -278,12 +319,12 @@ export declare const toolSchemas: {
             password: z.ZodString;
             token: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            password: string;
             collection: string;
+            password: string;
             token: string;
         }, {
-            password: string;
             collection: string;
+            password: string;
             token: string;
         }>;
     };
@@ -294,12 +335,12 @@ export declare const toolSchemas: {
             disableEmail: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             email: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            email: string;
             collection: string;
+            email: string;
             disableEmail: boolean;
         }, {
-            email: string;
             collection: string;
+            email: string;
             disableEmail?: boolean | undefined;
         }>;
     };
@@ -309,11 +350,11 @@ export declare const toolSchemas: {
             collection: z.ZodString;
             email: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            email: string;
             collection: string;
-        }, {
             email: string;
+        }, {
             collection: string;
+            email: string;
         }>;
     };
     createJob: {

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

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

package/dist/mcp/tools/schemas.js

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 export const toolSchemas = {
+    findGlobal: {
+        description: 'Find a Payload global singleton configuration.',
+        parameters: z.object({
+            depth: z.number().int().min(0).max(10).optional().default(0).describe('Depth of population for relationships'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
+            locale: z.string().optional().describe('Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields')
+        })
+    },
     findResources: {
         description: 'Find documents in a collection by ID or where clause using Find or FindByID.',
         parameters: z.object({
@@ -7,6 +15,7 @@ export const toolSchemas = {
                 z.string(),
                 z.number()
             ]).optional().describe('Optional: specific document ID to retrieve. If not provided, returns all documents'),
+            draft: z.boolean().optional().describe('Optional: Whether the document should be queried from the versions table/collection or not.'),
             fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
             limit: z.number().int().min(1, 'Limit must be at least 1').max(100, 'Limit cannot exceed 100').optional().default(10).describe('Maximum number of documents to return (default: 10, max: 100)'),
             locale: z.string().optional().describe('Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields'),
@@ -55,6 +64,16 @@ export const toolSchemas = {
             where: z.string().optional().describe('Optional: JSON string for where clause to delete multiple documents')
         })
     },
+    updateGlobal: {
+        description: 'Update a Payload global singleton configuration.',
+        parameters: z.object({
+            data: z.string().describe('JSON string containing the data to update'),
+            depth: z.number().int().min(0).max(10).optional().default(0).describe('Depth of population for relationships'),
+            draft: z.boolean().optional().default(false).describe('Whether to update as a draft'),
+            fallbackLocale: z.string().optional().describe('Optional: fallback locale code to use when requested locale is not available'),
+            locale: z.string().optional().describe('Optional: locale code to update data in (e.g., "en", "es"). Use "all" to update all locales for localized fields')
+        })
+    },
     // Experimental Below This Line
     createCollection: {
         description: 'Creates a new collection with specified fields and configuration.',