@payloadcms/plugin-mcp 4.0.0-internal.5b1e7cd → 4.0.0-internal.688c4d0

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

@@ -0,0 +1,76 @@
+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 any Payload global by passing the global slug.';
+export const findGlobalTool = defineGlobalTool({
+    description: DEFAULT_DESCRIPTION,
+    input: z.object({
+        depth: z.number().int().min(0).max(10).describe('Depth of population for relationships').optional().default(0),
+        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 retrieve data in (e.g., "en", "es"). Use "all" to retrieve 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., '{\"title\": true}'").optional()
+    })
+}).handler(async ({ authorizedMCP, globalSlug, input, req })=>{
+    const payload = req.payload;
+    const logger = getLogger({
+        payload
+    });
+    const { depth, fallbackLocale, locale, select } = input;
+    logger.info(`Reading global: ${globalSlug}, depth: ${depth}${locale ? `, locale: ${locale}` : ''}`);
+    try {
+        const findOptions = {
+            slug: globalSlug,
+            depth,
+            ...localAPIDefaults(authorizedMCP)
+        };
+        let selectClause;
+        if (select) {
+            try {
+                selectClause = JSON.parse(select);
+            } catch  {
+                logger.warn(`Invalid select clause JSON for global: ${select}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Invalid JSON in select clause'
+                        }
+                    ]
+                };
+            }
+        }
+        if (locale) {
+            findOptions.locale = locale;
+        }
+        if (fallbackLocale) {
+            findOptions.fallbackLocale = fallbackLocale;
+        }
+        if (selectClause) {
+            findOptions.select = selectClause;
+        }
+        const result = await payload.findGlobal(findOptions);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${globalSlug}":\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error reading global ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ **Error reading global "${globalSlug}":** ${errorMessage}`
+                }
+            ]
+        };
+    }
+});
+
+//# sourceMappingURL=findTool.js.map

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

@@ -0,0 +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 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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+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 { 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: 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({
+        payload
+    });
+    const { data, depth, draft, fallbackLocale, locale, select } = input;
+    logger.info(`Updating global: ${globalSlug}, draft: ${draft}${locale ? `, locale: ${locale}` : ''}`);
+    try {
+        const virtualFieldNames = getGlobalVirtualFieldNames(payload.config, globalSlug);
+        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 {
+                selectClause = JSON.parse(select);
+            } catch  {
+                logger.warn(`Invalid select clause JSON for global: ${select}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Invalid JSON in select clause'
+                        }
+                    ]
+                };
+            }
+        }
+        const updateOptions = {
+            slug: globalSlug,
+            data: parsedData,
+            depth,
+            draft,
+            ...localAPIDefaults(authorizedMCP)
+        };
+        if (locale) {
+            updateOptions.locale = locale;
+        }
+        if (fallbackLocale) {
+            updateOptions.fallbackLocale = fallbackLocale;
+        }
+        if (selectClause) {
+            updateOptions.select = selectClause;
+        }
+        const result = await payload.updateGlobal(updateOptions);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Global "${globalSlug}" updated successfully!\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``
+                }
+            ],
+            doc: result
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Error updating global ${globalSlug}: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error updating global "${globalSlug}": ${errorMessage}`
+                }
+            ]
+        };
+    }
+});
+
+//# sourceMappingURL=updateTool.js.map

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

@@ -0,0 +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 { 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":"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"}

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"}

package/dist/mcp/builtin/validateEntityData.js

@@ -0,0 +1,82 @@
+import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server';
+import { getCollectionInputSchema, getGlobalInputSchema } from '../../utils/schemaConversion/getEntityInputSchema.js';
+/**
+ * Keep the default `shortcircuit: true` - `false` makes validating nested rich text exponentially slow.
+ */ const validator = new CfWorkerJsonSchemaValidator({
+    shortcircuit: true
+});
+/**
+ * - Caches each entity's schema and validator, so both are only built on the first request.
+ * - Keyed by payload config, then by entity type, slug, partial and language.
+ */ const validatorCache = new WeakMap();
+export const validateCollectionData = ({ collectionSlug, data, partial, req })=>validateData({
+        slug: collectionSlug,
+        buildSchema: ()=>getCollectionInputSchema({
+                collectionSlug,
+                req
+            }),
+        data,
+        entity: 'collection',
+        partial,
+        req
+    });
+export const validateGlobalData = ({ data, globalSlug, req })=>validateData({
+        slug: globalSlug,
+        buildSchema: ()=>getGlobalInputSchema({
+                globalSlug,
+                req
+            }),
+        data,
+        entity: 'global',
+        partial: true,
+        req
+    });
+const validateData = ({ slug, buildSchema, data, entity, partial, req })=>{
+    let cache = validatorCache.get(req.payload.config);
+    if (!cache) {
+        cache = new Map();
+        validatorCache.set(req.payload.config, cache);
+    }
+    const cacheKey = `${entity}:${slug}:${partial ? 'partial' : 'full'}:${req.i18n.language}`;
+    let entityValidator = cache.get(cacheKey);
+    if (!entityValidator) {
+        const schema = buildSchema();
+        if (!schema) {
+            return null;
+        }
+        entityValidator = {
+            schema,
+            validate: validator.getValidator(partial ? withoutRequired(schema) : schema)
+        };
+        cache.set(cacheKey, entityValidator);
+    }
+    const result = entityValidator.validate(data);
+    if (result.valid) {
+        return null;
+    }
+    const { schema } = entityValidator;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Invalid data for ${entity} "${slug}": ${result.errorMessage}\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(schema)}\n\`\`\``
+            }
+        ],
+        isError: true,
+        structuredContent: {
+            [`${entity}Slug`]: slug,
+            errors: [
+                {
+                    message: result.errorMessage
+                }
+            ],
+            schema
+        }
+    };
+};
+/** Updates are partial — drop the schema's top-level `required` before validating. */ const withoutRequired = (schema)=>{
+    const { required: _required, ...rest } = schema;
+    return rest;
+};
+
+//# sourceMappingURL=validateEntityData.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/builtin/validateEntityData.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, PayloadRequest, SanitizedConfig } from 'payload'\n\nimport { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server'\n\nimport type { JsonSchemaType, MCPToolResponse } from '../../types.js'\n\nimport {\n  getCollectionInputSchema,\n  getGlobalInputSchema,\n} from '../../utils/schemaConversion/getEntityInputSchema.js'\n\n/**\n * Keep the default `shortcircuit: true` - `false` makes validating nested rich text exponentially slow.\n */\nconst validator = new CfWorkerJsonSchemaValidator({ shortcircuit: true })\n\ntype EntityValidator = {\n  schema: JsonSchemaType\n  validate: ReturnType<(typeof validator)['getValidator']>\n}\n\n/**\n * - Caches each entity's schema and validator, so both are only built on the first request.\n * - Keyed by payload config, then by entity type, slug, partial and language.\n */\nconst validatorCache = new WeakMap<SanitizedConfig, Map<string, EntityValidator>>()\n\nexport const validateCollectionData = ({\n  collectionSlug,\n  data,\n  partial,\n  req,\n}: {\n  collectionSlug: CollectionSlug\n  data: Record<string, unknown>\n  partial?: boolean\n  req: PayloadRequest\n}): MCPToolResponse | null =>\n  validateData({\n    slug: collectionSlug,\n    buildSchema: () => getCollectionInputSchema({ collectionSlug, req }),\n    data,\n    entity: 'collection',\n    partial,\n    req,\n  })\n\nexport const validateGlobalData = ({\n  data,\n  globalSlug,\n  req,\n}: {\n  data: Record<string, unknown>\n  globalSlug: GlobalSlug\n  req: PayloadRequest\n}): MCPToolResponse | null =>\n  validateData({\n    slug: globalSlug,\n    buildSchema: () => getGlobalInputSchema({ globalSlug, req }),\n    data,\n    entity: 'global',\n    partial: true,\n    req,\n  })\n\nconst validateData = ({\n  slug,\n  buildSchema,\n  data,\n  entity,\n  partial,\n  req,\n}: {\n  buildSchema: () => JsonSchemaType | null\n  data: Record<string, unknown>\n  entity: 'collection' | 'global'\n  partial?: boolean\n  req: PayloadRequest\n  slug: string\n}): MCPToolResponse | null => {\n  let cache = validatorCache.get(req.payload.config)\n  if (!cache) {\n    cache = new Map()\n    validatorCache.set(req.payload.config, cache)\n  }\n\n  const cacheKey = `${entity}:${slug}:${partial ? 'partial' : 'full'}:${req.i18n.language}`\n  let entityValidator = cache.get(cacheKey)\n\n  if (!entityValidator) {\n    const schema = buildSchema()\n\n    if (!schema) {\n      return null\n    }\n\n    entityValidator = {\n      schema,\n      validate: validator.getValidator(partial ? withoutRequired(schema) : schema),\n    }\n    cache.set(cacheKey, entityValidator)\n  }\n\n  const result = entityValidator.validate(data)\n\n  if (result.valid) {\n    return null\n  }\n\n  const { schema } = entityValidator\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Invalid data for ${entity} \"${slug}\": ${result.errorMessage}\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(schema)}\\n\\`\\`\\``,\n      },\n    ],\n    isError: true,\n    structuredContent: {\n      [`${entity}Slug`]: slug,\n      errors: [{ message: result.errorMessage }],\n      schema,\n    },\n  }\n}\n\n/** Updates are partial — drop the schema's top-level `required` before validating. */\nconst withoutRequired = (schema: JsonSchemaType): JsonSchemaType => {\n  const { required: _required, ...rest } = schema\n  return rest\n}\n"],"names":["CfWorkerJsonSchemaValidator","getCollectionInputSchema","getGlobalInputSchema","validator","shortcircuit","validatorCache","WeakMap","validateCollectionData","collectionSlug","data","partial","req","validateData","slug","buildSchema","entity","validateGlobalData","globalSlug","cache","get","payload","config","Map","set","cacheKey","i18n","language","entityValidator","schema","validate","getValidator","withoutRequired","result","valid","content","type","text","errorMessage","JSON","stringify","isError","structuredContent","errors","message","required","_required","rest"],"mappings":"AAEA,SAASA,2BAA2B,QAAQ,+BAA8B;AAI1E,SACEC,wBAAwB,EACxBC,oBAAoB,QACf,uDAAsD;AAE7D;;CAEC,GACD,MAAMC,YAAY,IAAIH,4BAA4B;IAAEI,cAAc;AAAK;AAOvE;;;CAGC,GACD,MAAMC,iBAAiB,IAAIC;AAE3B,OAAO,MAAMC,yBAAyB,CAAC,EACrCC,cAAc,EACdC,IAAI,EACJC,OAAO,EACPC,GAAG,EAMJ,GACCC,aAAa;QACXC,MAAML;QACNM,aAAa,IAAMb,yBAAyB;gBAAEO;gBAAgBG;YAAI;QAClEF;QACAM,QAAQ;QACRL;QACAC;IACF,GAAE;AAEJ,OAAO,MAAMK,qBAAqB,CAAC,EACjCP,IAAI,EACJQ,UAAU,EACVN,GAAG,EAKJ,GACCC,aAAa;QACXC,MAAMI;QACNH,aAAa,IAAMZ,qBAAqB;gBAAEe;gBAAYN;YAAI;QAC1DF;QACAM,QAAQ;QACRL,SAAS;QACTC;IACF,GAAE;AAEJ,MAAMC,eAAe,CAAC,EACpBC,IAAI,EACJC,WAAW,EACXL,IAAI,EACJM,MAAM,EACNL,OAAO,EACPC,GAAG,EAQJ;IACC,IAAIO,QAAQb,eAAec,GAAG,CAACR,IAAIS,OAAO,CAACC,MAAM;IACjD,IAAI,CAACH,OAAO;QACVA,QAAQ,IAAII;QACZjB,eAAekB,GAAG,CAACZ,IAAIS,OAAO,CAACC,MAAM,EAAEH;IACzC;IAEA,MAAMM,WAAW,GAAGT,OAAO,CAAC,EAAEF,KAAK,CAAC,EAAEH,UAAU,YAAY,OAAO,CAAC,EAAEC,IAAIc,IAAI,CAACC,QAAQ,EAAE;IACzF,IAAIC,kBAAkBT,MAAMC,GAAG,CAACK;IAEhC,IAAI,CAACG,iBAAiB;QACpB,MAAMC,SAASd;QAEf,IAAI,CAACc,QAAQ;YACX,OAAO;QACT;QAEAD,kBAAkB;YAChBC;YACAC,UAAU1B,UAAU2B,YAAY,CAACpB,UAAUqB,gBAAgBH,UAAUA;QACvE;QACAV,MAAMK,GAAG,CAACC,UAAUG;IACtB;IAEA,MAAMK,SAASL,gBAAgBE,QAAQ,CAACpB;IAExC,IAAIuB,OAAOC,KAAK,EAAE;QAChB,OAAO;IACT;IAEA,MAAM,EAAEL,MAAM,EAAE,GAAGD;IAEnB,OAAO;QACLO,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,iBAAiB,EAAErB,OAAO,EAAE,EAAEF,KAAK,GAAG,EAAEmB,OAAOK,YAAY,CAAC,2CAA2C,EAAEC,KAAKC,SAAS,CAACX,QAAQ,QAAQ,CAAC;YAClJ;SACD;QACDY,SAAS;QACTC,mBAAmB;YACjB,CAAC,GAAG1B,OAAO,IAAI,CAAC,CAAC,EAAEF;YACnB6B,QAAQ;gBAAC;oBAAEC,SAASX,OAAOK,YAAY;gBAAC;aAAE;YAC1CT;QACF;IACF;AACF;AAEA,oFAAoF,GACpF,MAAMG,kBAAkB,CAACH;IACvB,MAAM,EAAEgB,UAAUC,SAAS,EAAE,GAAGC,MAAM,GAAGlB;IACzC,OAAOkB;AACT"}

package/dist/mcp/builtinTools.d.ts

@@ -0,0 +1,105 @@
+import type { CollectionTool, GlobalTool, Tool } from '../types.js';
+export declare const TOOL_BUILTINS: {
+    getConfigInfo: {
+        label: string;
+        mcpName: string;
+        tool: Tool;
+    };
+};
+/**
+ * The static built-in collection CRUD tools. Keys here are the source of truth
+ * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type
+ * automatically.
+ */
+export declare const COLLECTION_BUILTINS: {
+    create: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    delete: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    find: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    getCollectionSchema: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    update: {
+        mcpName: string;
+        tool: CollectionTool;
+    };
+};
+/**
+ * The static auth tools surfaced under auth-enabled collections. Each entry
+ * carries the admin-UI label alongside the tool. Keys are the source of truth
+ * for `MCPCollectionAuthToolName`.
+ */
+export declare const COLLECTION_AUTH_BUILTINS: {
+    auth: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    forgotPassword: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    login: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    resetPassword: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    unlock: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+    verify: {
+        label: string;
+        mcpName: string;
+        tool: CollectionTool;
+    };
+};
+/**
+ * The static built-in global tools. Keys are the source of truth for
+ * `MCPGlobalBuiltinName`.
+ */
+export declare const GLOBAL_BUILTINS: {
+    find: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+    getGlobalSchema: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+    update: {
+        mcpName: string;
+        tool: GlobalTool;
+    };
+};
+export type MCPCollectionBuiltinName = keyof typeof COLLECTION_BUILTINS;
+export type MCPCollectionAuthToolName = keyof typeof COLLECTION_AUTH_BUILTINS;
+export type MCPGlobalBuiltinName = keyof typeof GLOBAL_BUILTINS;
+export type MCPTopLevelBuiltinName = keyof typeof TOOL_BUILTINS;
+/**
+ * Pre-typed `Object.entries` for each registry. The cast from `string` to the
+ * literal key union lives here once so consumers can iterate without their own
+ * cast — TypeScript's `Object.entries` always widens keys to `string`, which
+ * defeats the narrow type lookups on `MCPCollectionToolsMap`.
+ */
+export declare const TOOL_BUILTIN_ENTRIES: Array<[MCPTopLevelBuiltinName, (typeof TOOL_BUILTINS)[MCPTopLevelBuiltinName]]>;
+export declare const COLLECTION_BUILTIN_ENTRIES: Array<[MCPCollectionBuiltinName, (typeof COLLECTION_BUILTINS)[MCPCollectionBuiltinName]]>;
+export declare const COLLECTION_AUTH_BUILTIN_ENTRIES: Array<[MCPCollectionAuthToolName, (typeof COLLECTION_AUTH_BUILTINS)[MCPCollectionAuthToolName]]>;
+export declare const GLOBAL_BUILTIN_ENTRIES: Array<[MCPGlobalBuiltinName, (typeof GLOBAL_BUILTINS)[MCPGlobalBuiltinName]]>;
+//# sourceMappingURL=builtinTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtinTools.d.ts","sourceRoot":"","sources":["../../src/mcp/builtinTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAoBnE,eAAO,MAAM,aAAa;;;;;;CAEgD,CAAA;AAE1E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CAMqC,CAAA;AAErE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAe+C,CAAA;AAEpF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAIqC,CAAA;AAEjE,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,mBAAmB,CAAA;AAEvE,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,wBAAwB,CAAA;AAE7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,eAAe,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,aAAa,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAoC,KAAK,CACxE,CAAC,sBAAsB,EAAE,CAAC,OAAO,aAAa,EAAE,sBAAsB,CAAC,CAAC,CACzE,CAAA;AAED,eAAO,MAAM,0BAA0B,EAA0C,KAAK,CACpF,CAAC,wBAAwB,EAAE,CAAC,OAAO,mBAAmB,EAAE,wBAAwB,CAAC,CAAC,CACnF,CAAA;AAED,eAAO,MAAM,+BAA+B,EAA+C,KAAK,CAC9F,CAAC,yBAAyB,EAAE,CAAC,OAAO,wBAAwB,EAAE,yBAAyB,CAAC,CAAC,CAC1F,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAsC,KAAK,CAC5E,CAAC,oBAAoB,EAAE,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,CAAC,CACvE,CAAA"}

package/dist/mcp/builtinTools.js

@@ -0,0 +1,107 @@
+import { authCollectionTool, forgotPasswordCollectionTool, loginCollectionTool, resetPasswordCollectionTool, unlockCollectionTool, verifyCollectionTool } from './builtin/collections/authTools.js';
+import { createDocumentTool } from './builtin/collections/createTool.js';
+import { deleteDocumentsTool } from './builtin/collections/deleteTool.js';
+import { findDocumentsTool } from './builtin/collections/findTool.js';
+import { getCollectionSchemaTool } from './builtin/collections/getCollectionSchemaTool.js';
+import { updateDocumentTool } from './builtin/collections/updateTool.js';
+import { getConfigInfoTool } from './builtin/getConfigInfoTool.js';
+import { findGlobalTool } from './builtin/globals/findTool.js';
+import { getGlobalSchemaTool } from './builtin/globals/getGlobalSchemaTool.js';
+import { updateGlobalTool } from './builtin/globals/updateTool.js';
+export const TOOL_BUILTINS = {
+    getConfigInfo: {
+        label: 'Config Info',
+        mcpName: 'getConfigInfo',
+        tool: getConfigInfoTool
+    }
+};
+/**
+ * The static built-in collection CRUD tools. Keys here are the source of truth
+ * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type
+ * automatically.
+ */ export const COLLECTION_BUILTINS = {
+    create: {
+        mcpName: 'createDocument',
+        tool: createDocumentTool
+    },
+    delete: {
+        mcpName: 'deleteDocuments',
+        tool: deleteDocumentsTool
+    },
+    find: {
+        mcpName: 'findDocuments',
+        tool: findDocumentsTool
+    },
+    getCollectionSchema: {
+        mcpName: 'getCollectionSchema',
+        tool: getCollectionSchemaTool
+    },
+    update: {
+        mcpName: 'updateDocument',
+        tool: updateDocumentTool
+    }
+};
+/**
+ * The static auth tools surfaced under auth-enabled collections. Each entry
+ * carries the admin-UI label alongside the tool. Keys are the source of truth
+ * for `MCPCollectionAuthToolName`.
+ */ export const COLLECTION_AUTH_BUILTINS = {
+    auth: {
+        label: 'Check Auth Status',
+        mcpName: 'auth',
+        tool: authCollectionTool
+    },
+    forgotPassword: {
+        label: 'Forgot Password',
+        mcpName: 'forgotPassword',
+        tool: forgotPasswordCollectionTool
+    },
+    login: {
+        label: 'User Login',
+        mcpName: 'login',
+        tool: loginCollectionTool
+    },
+    resetPassword: {
+        label: 'Reset Password',
+        mcpName: 'resetPassword',
+        tool: resetPasswordCollectionTool
+    },
+    unlock: {
+        label: 'Unlock Account',
+        mcpName: 'unlock',
+        tool: unlockCollectionTool
+    },
+    verify: {
+        label: 'Email Verification',
+        mcpName: 'verify',
+        tool: verifyCollectionTool
+    }
+};
+/**
+ * The static built-in global tools. Keys are the source of truth for
+ * `MCPGlobalBuiltinName`.
+ */ export const GLOBAL_BUILTINS = {
+    find: {
+        mcpName: 'findGlobal',
+        tool: findGlobalTool
+    },
+    getGlobalSchema: {
+        mcpName: 'getGlobalSchema',
+        tool: getGlobalSchemaTool
+    },
+    update: {
+        mcpName: 'updateGlobal',
+        tool: updateGlobalTool
+    }
+};
+/**
+ * Pre-typed `Object.entries` for each registry. The cast from `string` to the
+ * literal key union lives here once so consumers can iterate without their own
+ * cast — TypeScript's `Object.entries` always widens keys to `string`, which
+ * defeats the narrow type lookups on `MCPCollectionToolsMap`.
+ */ export const TOOL_BUILTIN_ENTRIES = Object.entries(TOOL_BUILTINS);
+export const COLLECTION_BUILTIN_ENTRIES = Object.entries(COLLECTION_BUILTINS);
+export const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BUILTINS);
+export const GLOBAL_BUILTIN_ENTRIES = Object.entries(GLOBAL_BUILTINS);
+
+//# sourceMappingURL=builtinTools.js.map

package/dist/mcp/builtinTools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/builtinTools.ts"],"sourcesContent":["import type { CollectionTool, GlobalTool, Tool } from '../types.js'\n\nimport {\n  authCollectionTool,\n  forgotPasswordCollectionTool,\n  loginCollectionTool,\n  resetPasswordCollectionTool,\n  unlockCollectionTool,\n  verifyCollectionTool,\n} from './builtin/collections/authTools.js'\nimport { createDocumentTool } from './builtin/collections/createTool.js'\nimport { deleteDocumentsTool } from './builtin/collections/deleteTool.js'\nimport { findDocumentsTool } from './builtin/collections/findTool.js'\nimport { getCollectionSchemaTool } from './builtin/collections/getCollectionSchemaTool.js'\nimport { updateDocumentTool } from './builtin/collections/updateTool.js'\nimport { getConfigInfoTool } from './builtin/getConfigInfoTool.js'\nimport { findGlobalTool } from './builtin/globals/findTool.js'\nimport { getGlobalSchemaTool } from './builtin/globals/getGlobalSchemaTool.js'\nimport { updateGlobalTool } from './builtin/globals/updateTool.js'\n\nexport const TOOL_BUILTINS = {\n  getConfigInfo: { label: 'Config Info', mcpName: 'getConfigInfo', tool: getConfigInfoTool },\n} satisfies Record<string, { label: string; mcpName: string; tool: Tool }>\n\n/**\n * The static built-in collection CRUD tools. Keys here are the source of truth\n * for `MCPCollectionBuiltinName` — adding/removing an entry updates the type\n * automatically.\n */\nexport const COLLECTION_BUILTINS = {\n  create: { mcpName: 'createDocument', tool: createDocumentTool },\n  delete: { mcpName: 'deleteDocuments', tool: deleteDocumentsTool },\n  find: { mcpName: 'findDocuments', tool: findDocumentsTool },\n  getCollectionSchema: { mcpName: 'getCollectionSchema', tool: getCollectionSchemaTool },\n  update: { mcpName: 'updateDocument', tool: updateDocumentTool },\n} satisfies Record<string, { mcpName: string; tool: CollectionTool }>\n\n/**\n * The static auth tools surfaced under auth-enabled collections. Each entry\n * carries the admin-UI label alongside the tool. Keys are the source of truth\n * for `MCPCollectionAuthToolName`.\n */\nexport const COLLECTION_AUTH_BUILTINS = {\n  auth: { label: 'Check Auth Status', mcpName: 'auth', tool: authCollectionTool },\n  forgotPassword: {\n    label: 'Forgot Password',\n    mcpName: 'forgotPassword',\n    tool: forgotPasswordCollectionTool,\n  },\n  login: { label: 'User Login', mcpName: 'login', tool: loginCollectionTool },\n  resetPassword: {\n    label: 'Reset Password',\n    mcpName: 'resetPassword',\n    tool: resetPasswordCollectionTool,\n  },\n  unlock: { label: 'Unlock Account', mcpName: 'unlock', tool: unlockCollectionTool },\n  verify: { label: 'Email Verification', mcpName: 'verify', tool: verifyCollectionTool },\n} satisfies Record<string, { label: string; mcpName: string; tool: CollectionTool }>\n\n/**\n * The static built-in global tools. Keys are the source of truth for\n * `MCPGlobalBuiltinName`.\n */\nexport const GLOBAL_BUILTINS = {\n  find: { mcpName: 'findGlobal', tool: findGlobalTool },\n  getGlobalSchema: { mcpName: 'getGlobalSchema', tool: getGlobalSchemaTool },\n  update: { mcpName: 'updateGlobal', tool: updateGlobalTool },\n} satisfies Record<string, { mcpName: string; tool: GlobalTool }>\n\nexport type MCPCollectionBuiltinName = keyof typeof COLLECTION_BUILTINS\n\nexport type MCPCollectionAuthToolName = keyof typeof COLLECTION_AUTH_BUILTINS\n\nexport type MCPGlobalBuiltinName = keyof typeof GLOBAL_BUILTINS\n\nexport type MCPTopLevelBuiltinName = keyof typeof TOOL_BUILTINS\n\n/**\n * Pre-typed `Object.entries` for each registry. The cast from `string` to the\n * literal key union lives here once so consumers can iterate without their own\n * cast — TypeScript's `Object.entries` always widens keys to `string`, which\n * defeats the narrow type lookups on `MCPCollectionToolsMap`.\n */\nexport const TOOL_BUILTIN_ENTRIES = Object.entries(TOOL_BUILTINS) as Array<\n  [MCPTopLevelBuiltinName, (typeof TOOL_BUILTINS)[MCPTopLevelBuiltinName]]\n>\n\nexport const COLLECTION_BUILTIN_ENTRIES = Object.entries(COLLECTION_BUILTINS) as Array<\n  [MCPCollectionBuiltinName, (typeof COLLECTION_BUILTINS)[MCPCollectionBuiltinName]]\n>\n\nexport const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BUILTINS) as Array<\n  [MCPCollectionAuthToolName, (typeof COLLECTION_AUTH_BUILTINS)[MCPCollectionAuthToolName]]\n>\n\nexport const GLOBAL_BUILTIN_ENTRIES = Object.entries(GLOBAL_BUILTINS) as Array<\n  [MCPGlobalBuiltinName, (typeof GLOBAL_BUILTINS)[MCPGlobalBuiltinName]]\n>\n"],"names":["authCollectionTool","forgotPasswordCollectionTool","loginCollectionTool","resetPasswordCollectionTool","unlockCollectionTool","verifyCollectionTool","createDocumentTool","deleteDocumentsTool","findDocumentsTool","getCollectionSchemaTool","updateDocumentTool","getConfigInfoTool","findGlobalTool","getGlobalSchemaTool","updateGlobalTool","TOOL_BUILTINS","getConfigInfo","label","mcpName","tool","COLLECTION_BUILTINS","create","delete","find","getCollectionSchema","update","COLLECTION_AUTH_BUILTINS","auth","forgotPassword","login","resetPassword","unlock","verify","GLOBAL_BUILTINS","getGlobalSchema","TOOL_BUILTIN_ENTRIES","Object","entries","COLLECTION_BUILTIN_ENTRIES","COLLECTION_AUTH_BUILTIN_ENTRIES","GLOBAL_BUILTIN_ENTRIES"],"mappings":"AAEA,SACEA,kBAAkB,EAClBC,4BAA4B,EAC5BC,mBAAmB,EACnBC,2BAA2B,EAC3BC,oBAAoB,EACpBC,oBAAoB,QACf,qCAAoC;AAC3C,SAASC,kBAAkB,QAAQ,sCAAqC;AACxE,SAASC,mBAAmB,QAAQ,sCAAqC;AACzE,SAASC,iBAAiB,QAAQ,oCAAmC;AACrE,SAASC,uBAAuB,QAAQ,mDAAkD;AAC1F,SAASC,kBAAkB,QAAQ,sCAAqC;AACxE,SAASC,iBAAiB,QAAQ,iCAAgC;AAClE,SAASC,cAAc,QAAQ,gCAA+B;AAC9D,SAASC,mBAAmB,QAAQ,2CAA0C;AAC9E,SAASC,gBAAgB,QAAQ,kCAAiC;AAElE,OAAO,MAAMC,gBAAgB;IAC3BC,eAAe;QAAEC,OAAO;QAAeC,SAAS;QAAiBC,MAAMR;IAAkB;AAC3F,EAA0E;AAE1E;;;;CAIC,GACD,OAAO,MAAMS,sBAAsB;IACjCC,QAAQ;QAAEH,SAAS;QAAkBC,MAAMb;IAAmB;IAC9DgB,QAAQ;QAAEJ,SAAS;QAAmBC,MAAMZ;IAAoB;IAChEgB,MAAM;QAAEL,SAAS;QAAiBC,MAAMX;IAAkB;IAC1DgB,qBAAqB;QAAEN,SAAS;QAAuBC,MAAMV;IAAwB;IACrFgB,QAAQ;QAAEP,SAAS;QAAkBC,MAAMT;IAAmB;AAChE,EAAqE;AAErE;;;;CAIC,GACD,OAAO,MAAMgB,2BAA2B;IACtCC,MAAM;QAAEV,OAAO;QAAqBC,SAAS;QAAQC,MAAMnB;IAAmB;IAC9E4B,gBAAgB;QACdX,OAAO;QACPC,SAAS;QACTC,MAAMlB;IACR;IACA4B,OAAO;QAAEZ,OAAO;QAAcC,SAAS;QAASC,MAAMjB;IAAoB;IAC1E4B,eAAe;QACbb,OAAO;QACPC,SAAS;QACTC,MAAMhB;IACR;IACA4B,QAAQ;QAAEd,OAAO;QAAkBC,SAAS;QAAUC,MAAMf;IAAqB;IACjF4B,QAAQ;QAAEf,OAAO;QAAsBC,SAAS;QAAUC,MAAMd;IAAqB;AACvF,EAAoF;AAEpF;;;CAGC,GACD,OAAO,MAAM4B,kBAAkB;IAC7BV,MAAM;QAAEL,SAAS;QAAcC,MAAMP;IAAe;IACpDsB,iBAAiB;QAAEhB,SAAS;QAAmBC,MAAMN;IAAoB;IACzEY,QAAQ;QAAEP,SAAS;QAAgBC,MAAML;IAAiB;AAC5D,EAAiE;AAUjE;;;;;CAKC,GACD,OAAO,MAAMqB,uBAAuBC,OAAOC,OAAO,CAACtB,eAElD;AAED,OAAO,MAAMuB,6BAA6BF,OAAOC,OAAO,CAACjB,qBAExD;AAED,OAAO,MAAMmB,kCAAkCH,OAAOC,OAAO,CAACX,0BAE7D;AAED,OAAO,MAAMc,yBAAyBJ,OAAOC,OAAO,CAACJ,iBAEpD"}

package/dist/mcp/sanitizeMCPConfig.d.ts

@@ -0,0 +1,17 @@
+import type { Config, SanitizedConfig } from 'payload';
+import type { MCPPluginConfig, SanitizedMCPPluginConfig } from '../types.js';
+/**
+ * Converts the user-configured `MCPPluginConfig` into a `SanitizedMCPPluginConfig`:
+ *  - Flattens `tools` / `prompts` / `resources` / per-collection / per-global
+ *    tool maps into a single `items` array.
+ *  - Applies built-in tools for collections and globals, respecting opt-out user overrides.
+ *  - Applies the `userCollection` default
+ *
+ * Called once during plugin init. After that, `plugins['@payloadcms/plugin-mcp']
+ * ?.options` holds the sanitized result
+ */
+export declare const sanitizeMCPConfig: ({ config, pluginConfig, }: {
+    config: Config | SanitizedConfig;
+    pluginConfig: MCPPluginConfig;
+}) => SanitizedMCPPluginConfig;
+//# sourceMappingURL=sanitizeMCPConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeMCPConfig.d.ts","sourceRoot":"","sources":["../../src/mcp/sanitizeMCPConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,MAAM,EAGN,eAAe,EAEhB,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAMV,eAAe,EACf,wBAAwB,EACzB,MAAM,aAAa,CAAA;AAapB;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,2BAG/B;IACD,MAAM,EAAE,MAAM,GAAG,eAAe,CAAA;IAChC,YAAY,EAAE,eAAe,CAAA;CAC9B,KAAG,wBAkEH,CAAA"}