@payloadcms/plugin-mcp 4.0.0-internal.cc18726 → 4.0.0-internal.cd47d20

package/src/stdio.ts

@@ -3,7 +3,7 @@ import type { Config, Plugin, SanitizedConfig } from 'payload'
 /* eslint-disable no-console */
 import { serveStdio } from '@modelcontextprotocol/server/stdio'
 import { fileURLToPath, pathToFileURL } from 'node:url'
-import { createLocalReq, getPayload } from 'payload'
+import { createPayloadRequest, getPayload } from 'payload'
 import { findConfig, loadEnv } from 'payload/node'
 
 import type { SanitizedMCPPluginConfig } from './types.js'
@@ -91,7 +91,7 @@ export const runMcpStdio = async (): Promise<void> => {
     headers.set('Authorization', process.env.PAYLOAD_MCP_AUTHORIZATION)
   }
 
-  const req = await createLocalReq({ req: { headers } }, payload)
+  const req = await createPayloadRequest({ payload, req: { headers } })
   req.payloadAPI = 'MCP' as const
   const authorizedMCP = await getAuthorizedMCP({ overrideAccess, req })
 

package/dist/mcp/builtin/collections/fileInput.spec.js

@@ -1,86 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { fileInputSchema, resolveFile } from './fileInput.js';
-describe('MCP file input', ()=>{
-    it('should reject malformed MIME types', ()=>{
-        const result = fileInputSchema.safeParse({
-            data: 'aGVsbG8=',
-            mimeType: 'text/plain\r\nx-test: value',
-            name: 'hello.txt',
-            source: 'base64'
-        });
-        expect(result.success).toBe(false);
-    });
-    it('should accept a prepared upload', ()=>{
-        const result = fileInputSchema.safeParse({
-            file: {
-                filename: 'image.png',
-                mimeType: 'image/png',
-                size: 123,
-                uploadReference: {
-                    uploadId: 'upload-id'
-                }
-            },
-            source: 'uploadReference'
-        });
-        expect(result.success).toBe(true);
-    });
-    it('should reject oversized base64 files', async ()=>{
-        const req = createRequest({
-            maxFileSize: 4
-        });
-        await expect(resolveFile({
-            slug: 'media',
-            input: {
-                data: Buffer.from('hello').toString('base64'),
-                mimeType: 'text/plain',
-                name: 'hello.txt',
-                source: 'base64'
-            },
-            req
-        })).rejects.toThrow('File exceeds the 4 byte upload limit.');
-    });
-    it('should reject URLs outside the collection allowlist', async ()=>{
-        const req = createRequest({
-            allowList: [
-                {
-                    hostname: 'assets.example.com',
-                    protocol: 'https'
-                }
-            ]
-        });
-        await expect(resolveFile({
-            slug: 'media',
-            input: {
-                source: 'externalURL',
-                url: 'https://example.com/image.png'
-            },
-            req
-        })).rejects.toThrow('The provided file URL is not allowed.');
-    });
-});
-function createRequest({ allowList, maxFileSize }) {
-    return {
-        payload: {
-            collections: {
-                media: {
-                    config: {
-                        upload: allowList ? {
-                            pasteURL: {
-                                allowList
-                            }
-                        } : {}
-                    }
-                }
-            },
-            config: {
-                upload: {
-                    limits: {
-                        fileSize: maxFileSize
-                    }
-                }
-            }
-        }
-    };
-}
-
-//# sourceMappingURL=fileInput.spec.js.map

package/dist/mcp/builtin/collections/fileInput.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/fileInput.spec.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { describe, expect, it } from 'vitest'\n\nimport { fileInputSchema, resolveFile } from './fileInput.js'\n\ndescribe('MCP file input', () => {\n  it('should reject malformed MIME types', () => {\n    const result = fileInputSchema.safeParse({\n      data: 'aGVsbG8=',\n      mimeType: 'text/plain\\r\\nx-test: value',\n      name: 'hello.txt',\n      source: 'base64',\n    })\n\n    expect(result.success).toBe(false)\n  })\n\n  it('should accept a prepared upload', () => {\n    const result = fileInputSchema.safeParse({\n      file: {\n        filename: 'image.png',\n        mimeType: 'image/png',\n        size: 123,\n        uploadReference: { uploadId: 'upload-id' },\n      },\n      source: 'uploadReference',\n    })\n\n    expect(result.success).toBe(true)\n  })\n\n  it('should reject oversized base64 files', async () => {\n    const req = createRequest({ maxFileSize: 4 })\n\n    await expect(\n      resolveFile({\n        slug: 'media',\n        input: {\n          data: Buffer.from('hello').toString('base64'),\n          mimeType: 'text/plain',\n          name: 'hello.txt',\n          source: 'base64',\n        },\n        req,\n      }),\n    ).rejects.toThrow('File exceeds the 4 byte upload limit.')\n  })\n\n  it('should reject URLs outside the collection allowlist', async () => {\n    const req = createRequest({\n      allowList: [{ hostname: 'assets.example.com', protocol: 'https' }],\n    })\n\n    await expect(\n      resolveFile({\n        slug: 'media',\n        input: {\n          source: 'externalURL',\n          url: 'https://example.com/image.png',\n        },\n        req,\n      }),\n    ).rejects.toThrow('The provided file URL is not allowed.')\n  })\n})\n\nfunction createRequest({\n  allowList,\n  maxFileSize,\n}: {\n  allowList?: Array<{ hostname: string; protocol: 'http' | 'https' }>\n  maxFileSize?: number\n}): PayloadRequest {\n  return {\n    payload: {\n      collections: {\n        media: {\n          config: {\n            upload: allowList ? { pasteURL: { allowList } } : {},\n          },\n        },\n      },\n      config: {\n        upload: {\n          limits: {\n            fileSize: maxFileSize,\n          },\n        },\n      },\n    },\n  } as unknown as PayloadRequest\n}\n"],"names":["describe","expect","it","fileInputSchema","resolveFile","result","safeParse","data","mimeType","name","source","success","toBe","file","filename","size","uploadReference","uploadId","req","createRequest","maxFileSize","slug","input","Buffer","from","toString","rejects","toThrow","allowList","hostname","protocol","url","payload","collections","media","config","upload","pasteURL","limits","fileSize"],"mappings":"AAEA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,eAAe,EAAEC,WAAW,QAAQ,iBAAgB;AAE7DJ,SAAS,kBAAkB;IACzBE,GAAG,sCAAsC;QACvC,MAAMG,SAASF,gBAAgBG,SAAS,CAAC;YACvCC,MAAM;YACNC,UAAU;YACVC,MAAM;YACNC,QAAQ;QACV;QAEAT,OAAOI,OAAOM,OAAO,EAAEC,IAAI,CAAC;IAC9B;IAEAV,GAAG,mCAAmC;QACpC,MAAMG,SAASF,gBAAgBG,SAAS,CAAC;YACvCO,MAAM;gBACJC,UAAU;gBACVN,UAAU;gBACVO,MAAM;gBACNC,iBAAiB;oBAAEC,UAAU;gBAAY;YAC3C;YACAP,QAAQ;QACV;QAEAT,OAAOI,OAAOM,OAAO,EAAEC,IAAI,CAAC;IAC9B;IAEAV,GAAG,wCAAwC;QACzC,MAAMgB,MAAMC,cAAc;YAAEC,aAAa;QAAE;QAE3C,MAAMnB,OACJG,YAAY;YACViB,MAAM;YACNC,OAAO;gBACLf,MAAMgB,OAAOC,IAAI,CAAC,SAASC,QAAQ,CAAC;gBACpCjB,UAAU;gBACVC,MAAM;gBACNC,QAAQ;YACV;YACAQ;QACF,IACAQ,OAAO,CAACC,OAAO,CAAC;IACpB;IAEAzB,GAAG,uDAAuD;QACxD,MAAMgB,MAAMC,cAAc;YACxBS,WAAW;gBAAC;oBAAEC,UAAU;oBAAsBC,UAAU;gBAAQ;aAAE;QACpE;QAEA,MAAM7B,OACJG,YAAY;YACViB,MAAM;YACNC,OAAO;gBACLZ,QAAQ;gBACRqB,KAAK;YACP;YACAb;QACF,IACAQ,OAAO,CAACC,OAAO,CAAC;IACpB;AACF;AAEA,SAASR,cAAc,EACrBS,SAAS,EACTR,WAAW,EAIZ;IACC,OAAO;QACLY,SAAS;YACPC,aAAa;gBACXC,OAAO;oBACLC,QAAQ;wBACNC,QAAQR,YAAY;4BAAES,UAAU;gCAAET;4BAAU;wBAAE,IAAI,CAAC;oBACrD;gBACF;YACF;YACAO,QAAQ;gBACNC,QAAQ;oBACNE,QAAQ;wBACNC,UAAUnB;oBACZ;gBACF;YACF;QACF;IACF;AACF"}

package/dist/mcp/builtin/collections/formatCollectionError.d.ts

@@ -1,9 +0,0 @@
-import type { CollectionSlug, PayloadRequest } from 'payload';
-import type { MCPToolResponse } from '../../../types.js';
-export declare const formatCollectionError: ({ slug, action, error, req, }: {
-    action: 'creating' | 'duplicating' | 'updating';
-    error: unknown;
-    req: PayloadRequest;
-    slug: CollectionSlug;
-}) => MCPToolResponse;
-//# sourceMappingURL=formatCollectionError.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"formatCollectionError.d.ts","sourceRoot":"","sources":["../../../../src/mcp/builtin/collections/formatCollectionError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAI7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA8BxD,eAAO,MAAM,qBAAqB,kCAK/B;IACD,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAA;IAC/C,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;CACrB,KAAG,eAuCH,CAAA"}

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

@@ -1,60 +0,0 @@
-import { getCollectionInputSchema } from 'payload';
-const getValidationErrors = (error)=>{
-    if (!error || typeof error !== 'object') {
-        return undefined;
-    }
-    const data = 'data' in error ? error.data : undefined;
-    if (!data || typeof data !== 'object' || !('errors' in data) || !Array.isArray(data.errors)) {
-        return undefined;
-    }
-    return data.errors;
-};
-const isSchemaError = (error, message)=>{
-    if (getValidationErrors(error)) {
-        return true;
-    }
-    const name = error && typeof error === 'object' && 'name' in error ? error.name : undefined;
-    return name === 'CastError' || name === 'ValidationError' || message.includes('Cast to ') || message.includes('validation failed');
-};
-export const formatCollectionError = ({ slug, action, error, req })=>{
-    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-    const errors = getValidationErrors(error) ?? [
-        {
-            message: errorMessage
-        }
-    ];
-    if (!isSchemaError(error, errorMessage)) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error ${action} document in collection "${slug}": ${errorMessage}`
-                }
-            ],
-            isError: true
-        };
-    }
-    const schema = getCollectionInputSchema({
-        collectionSlug: slug,
-        req
-    });
-    const schemaText = schema ? `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(schema)}\n\`\`\`` : '';
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `Error ${action} document in collection "${slug}": ${errorMessage}${schemaText}`
-            }
-        ],
-        isError: true,
-        ...schema ? {
-            structuredContent: {
-                slug,
-                errors,
-                schema
-            }
-        } : {}
-    };
-};
-
-//# sourceMappingURL=formatCollectionError.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/mcp/builtin/collections/formatCollectionError.ts"],"sourcesContent":["import type { CollectionSlug, PayloadRequest } from 'payload'\n\nimport { getCollectionInputSchema } from 'payload'\n\nimport type { MCPToolResponse } from '../../../types.js'\n\nconst getValidationErrors = (error: unknown): undefined | unknown[] => {\n  if (!error || typeof error !== 'object') {\n    return undefined\n  }\n\n  const data = 'data' in error ? error.data : undefined\n  if (!data || typeof data !== 'object' || !('errors' in data) || !Array.isArray(data.errors)) {\n    return undefined\n  }\n\n  return data.errors\n}\n\nconst isSchemaError = (error: unknown, message: string): boolean => {\n  if (getValidationErrors(error)) {\n    return true\n  }\n\n  const name = error && typeof error === 'object' && 'name' in error ? error.name : undefined\n\n  return (\n    name === 'CastError' ||\n    name === 'ValidationError' ||\n    message.includes('Cast to ') ||\n    message.includes('validation failed')\n  )\n}\n\nexport const formatCollectionError = ({\n  slug,\n  action,\n  error,\n  req,\n}: {\n  action: 'creating' | 'duplicating' | 'updating'\n  error: unknown\n  req: PayloadRequest\n  slug: CollectionSlug\n}): MCPToolResponse => {\n  const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n  const errors = getValidationErrors(error) ?? [{ message: errorMessage }]\n\n  if (!isSchemaError(error, errorMessage)) {\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Error ${action} document in collection \"${slug}\": ${errorMessage}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n\n  const schema = getCollectionInputSchema({ collectionSlug: slug, req })\n  const schemaText = schema\n    ? `\\n\\nUse this schema for data:\\n\\`\\`\\`json\\n${JSON.stringify(schema)}\\n\\`\\`\\``\n    : ''\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Error ${action} document in collection \"${slug}\": ${errorMessage}${schemaText}`,\n      },\n    ],\n    isError: true,\n    ...(schema\n      ? {\n          structuredContent: {\n            slug,\n            errors,\n            schema,\n          },\n        }\n      : {}),\n  }\n}\n"],"names":["getCollectionInputSchema","getValidationErrors","error","undefined","data","Array","isArray","errors","isSchemaError","message","name","includes","formatCollectionError","slug","action","req","errorMessage","Error","content","type","text","isError","schema","collectionSlug","schemaText","JSON","stringify","structuredContent"],"mappings":"AAEA,SAASA,wBAAwB,QAAQ,UAAS;AAIlD,MAAMC,sBAAsB,CAACC;IAC3B,IAAI,CAACA,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAOC;IACT;IAEA,MAAMC,OAAO,UAAUF,QAAQA,MAAME,IAAI,GAAGD;IAC5C,IAAI,CAACC,QAAQ,OAAOA,SAAS,YAAY,CAAE,CAAA,YAAYA,IAAG,KAAM,CAACC,MAAMC,OAAO,CAACF,KAAKG,MAAM,GAAG;QAC3F,OAAOJ;IACT;IAEA,OAAOC,KAAKG,MAAM;AACpB;AAEA,MAAMC,gBAAgB,CAACN,OAAgBO;IACrC,IAAIR,oBAAoBC,QAAQ;QAC9B,OAAO;IACT;IAEA,MAAMQ,OAAOR,SAAS,OAAOA,UAAU,YAAY,UAAUA,QAAQA,MAAMQ,IAAI,GAAGP;IAElF,OACEO,SAAS,eACTA,SAAS,qBACTD,QAAQE,QAAQ,CAAC,eACjBF,QAAQE,QAAQ,CAAC;AAErB;AAEA,OAAO,MAAMC,wBAAwB,CAAC,EACpCC,IAAI,EACJC,MAAM,EACNZ,KAAK,EACLa,GAAG,EAMJ;IACC,MAAMC,eAAed,iBAAiBe,QAAQf,MAAMO,OAAO,GAAG;IAC9D,MAAMF,SAASN,oBAAoBC,UAAU;QAAC;YAAEO,SAASO;QAAa;KAAE;IAExE,IAAI,CAACR,cAAcN,OAAOc,eAAe;QACvC,OAAO;YACLE,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,MAAM,EAAEN,OAAO,yBAAyB,EAAED,KAAK,GAAG,EAAEG,cAAc;gBAC3E;aACD;YACDK,SAAS;QACX;IACF;IAEA,MAAMC,SAAStB,yBAAyB;QAAEuB,gBAAgBV;QAAME;IAAI;IACpE,MAAMS,aAAaF,SACf,CAAC,2CAA2C,EAAEG,KAAKC,SAAS,CAACJ,QAAQ,QAAQ,CAAC,GAC9E;IAEJ,OAAO;QACLJ,SAAS;YACP;gBACEC,MAAM;gBACNC,MAAM,CAAC,MAAM,EAAEN,OAAO,yBAAyB,EAAED,KAAK,GAAG,EAAEG,eAAeQ,YAAY;YACxF;SACD;QACDH,SAAS;QACT,GAAIC,SACA;YACEK,mBAAmB;gBACjBd;gBACAN;gBACAe;YACF;QACF,IACA,CAAC,CAAC;IACR;AACF,EAAC"}

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

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

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

@@ -1 +0,0 @@
-{"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;AAK1F,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAkBrE,eAAO,MAAM,sBAAsB,kCAKhC;IACD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;CACrB,KAAG,eAAe,GAAG,IASlB,CAAA;AAEJ,eAAO,MAAM,kBAAkB,yBAI5B;IACD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,GAAG,EAAE,cAAc,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;CACjB,KAAG,eAAe,GAAG,IAQlB,CAAA"}

package/dist/mcp/builtin/validateEntityData.js

@@ -1,82 +0,0 @@
-import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server/validators/cf-worker';
-import { getCollectionInputSchema, getGlobalInputSchema } from 'payload';
-/**
- * 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 = ({ slug, data, partial, req })=>validateData({
-        slug,
-        buildSchema: ()=>getCollectionInputSchema({
-                collectionSlug: slug,
-                req
-            }),
-        data,
-        entity: 'collection',
-        partial,
-        req
-    });
-export const validateGlobalData = ({ slug, data, req })=>validateData({
-        slug,
-        buildSchema: ()=>getGlobalInputSchema({
-                globalSlug: slug,
-                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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/mcp/builtin/validateEntityData.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, PayloadRequest, SanitizedConfig } from 'payload'\n\nimport { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server/validators/cf-worker'\nimport { getCollectionInputSchema, getGlobalInputSchema } from 'payload'\n\nimport type { JsonSchemaType, MCPToolResponse } from '../../types.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  slug,\n  data,\n  partial,\n  req,\n}: {\n  data: Record<string, unknown>\n  partial?: boolean\n  req: PayloadRequest\n  slug: CollectionSlug\n}): MCPToolResponse | null =>\n  validateData({\n    slug,\n    buildSchema: () =>\n      getCollectionInputSchema({ collectionSlug: slug, req }) as JsonSchemaType | null,\n    data,\n    entity: 'collection',\n    partial,\n    req,\n  })\n\nexport const validateGlobalData = ({\n  slug,\n  data,\n  req,\n}: {\n  data: Record<string, unknown>\n  req: PayloadRequest\n  slug: GlobalSlug\n}): MCPToolResponse | null =>\n  validateData({\n    slug,\n    buildSchema: () => getGlobalInputSchema({ globalSlug: slug, req }) as JsonSchemaType | null,\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","slug","data","partial","req","validateData","buildSchema","collectionSlug","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,oDAAmD;AAC/F,SAASC,wBAAwB,EAAEC,oBAAoB,QAAQ,UAAS;AAIxE;;CAEC,GACD,MAAMC,YAAY,IAAIH,4BAA4B;IAAEI,cAAc;AAAK;AAOvE;;;CAGC,GACD,MAAMC,iBAAiB,IAAIC;AAE3B,OAAO,MAAMC,yBAAyB,CAAC,EACrCC,IAAI,EACJC,IAAI,EACJC,OAAO,EACPC,GAAG,EAMJ,GACCC,aAAa;QACXJ;QACAK,aAAa,IACXZ,yBAAyB;gBAAEa,gBAAgBN;gBAAMG;YAAI;QACvDF;QACAM,QAAQ;QACRL;QACAC;IACF,GAAE;AAEJ,OAAO,MAAMK,qBAAqB,CAAC,EACjCR,IAAI,EACJC,IAAI,EACJE,GAAG,EAKJ,GACCC,aAAa;QACXJ;QACAK,aAAa,IAAMX,qBAAqB;gBAAEe,YAAYT;gBAAMG;YAAI;QAChEF;QACAM,QAAQ;QACRL,SAAS;QACTC;IACF,GAAE;AAEJ,MAAMC,eAAe,CAAC,EACpBJ,IAAI,EACJK,WAAW,EACXJ,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,EAAEP,KAAK,CAAC,EAAEE,UAAU,YAAY,OAAO,CAAC,EAAEC,IAAIc,IAAI,CAACC,QAAQ,EAAE;IACzF,IAAIC,kBAAkBT,MAAMC,GAAG,CAACK;IAEhC,IAAI,CAACG,iBAAiB;QACpB,MAAMC,SAASf;QAEf,IAAI,CAACe,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,EAAEP,KAAK,GAAG,EAAEwB,OAAOK,YAAY,CAAC,2CAA2C,EAAEC,KAAKC,SAAS,CAACX,QAAQ,QAAQ,CAAC;YAClJ;SACD;QACDY,SAAS;QACTC,mBAAmB;YACjB,CAAC,GAAG1B,OAAO,IAAI,CAAC,CAAC,EAAEP;YACnBkC,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/src/mcp/builtin/collections/formatCollectionError.ts

@@ -1,84 +0,0 @@
-import type { CollectionSlug, PayloadRequest } from 'payload'
-
-import { getCollectionInputSchema } from 'payload'
-
-import type { MCPToolResponse } from '../../../types.js'
-
-const getValidationErrors = (error: unknown): undefined | unknown[] => {
-  if (!error || typeof error !== 'object') {
-    return undefined
-  }
-
-  const data = 'data' in error ? error.data : undefined
-  if (!data || typeof data !== 'object' || !('errors' in data) || !Array.isArray(data.errors)) {
-    return undefined
-  }
-
-  return data.errors
-}
-
-const isSchemaError = (error: unknown, message: string): boolean => {
-  if (getValidationErrors(error)) {
-    return true
-  }
-
-  const name = error && typeof error === 'object' && 'name' in error ? error.name : undefined
-
-  return (
-    name === 'CastError' ||
-    name === 'ValidationError' ||
-    message.includes('Cast to ') ||
-    message.includes('validation failed')
-  )
-}
-
-export const formatCollectionError = ({
-  slug,
-  action,
-  error,
-  req,
-}: {
-  action: 'creating' | 'duplicating' | 'updating'
-  error: unknown
-  req: PayloadRequest
-  slug: CollectionSlug
-}): MCPToolResponse => {
-  const errorMessage = error instanceof Error ? error.message : 'Unknown error'
-  const errors = getValidationErrors(error) ?? [{ message: errorMessage }]
-
-  if (!isSchemaError(error, errorMessage)) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `Error ${action} document in collection "${slug}": ${errorMessage}`,
-        },
-      ],
-      isError: true,
-    }
-  }
-
-  const schema = getCollectionInputSchema({ collectionSlug: slug, req })
-  const schemaText = schema
-    ? `\n\nUse this schema for data:\n\`\`\`json\n${JSON.stringify(schema)}\n\`\`\``
-    : ''
-
-  return {
-    content: [
-      {
-        type: 'text',
-        text: `Error ${action} document in collection "${slug}": ${errorMessage}${schemaText}`,
-      },
-    ],
-    isError: true,
-    ...(schema
-      ? {
-          structuredContent: {
-            slug,
-            errors,
-            schema,
-          },
-        }
-      : {}),
-  }
-}

package/src/mcp/builtin/validateEntityData.ts

@@ -1,129 +0,0 @@
-import type { CollectionSlug, GlobalSlug, PayloadRequest, SanitizedConfig } from 'payload'
-
-import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server/validators/cf-worker'
-import { getCollectionInputSchema, getGlobalInputSchema } from 'payload'
-
-import type { JsonSchemaType, MCPToolResponse } from '../../types.js'
-
-/**
- * Keep the default `shortcircuit: true` - `false` makes validating nested rich text exponentially slow.
- */
-const validator = new CfWorkerJsonSchemaValidator({ shortcircuit: true })
-
-type EntityValidator = {
-  schema: JsonSchemaType
-  validate: ReturnType<(typeof validator)['getValidator']>
-}
-
-/**
- * - 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<SanitizedConfig, Map<string, EntityValidator>>()
-
-export const validateCollectionData = ({
-  slug,
-  data,
-  partial,
-  req,
-}: {
-  data: Record<string, unknown>
-  partial?: boolean
-  req: PayloadRequest
-  slug: CollectionSlug
-}): MCPToolResponse | null =>
-  validateData({
-    slug,
-    buildSchema: () =>
-      getCollectionInputSchema({ collectionSlug: slug, req }) as JsonSchemaType | null,
-    data,
-    entity: 'collection',
-    partial,
-    req,
-  })
-
-export const validateGlobalData = ({
-  slug,
-  data,
-  req,
-}: {
-  data: Record<string, unknown>
-  req: PayloadRequest
-  slug: GlobalSlug
-}): MCPToolResponse | null =>
-  validateData({
-    slug,
-    buildSchema: () => getGlobalInputSchema({ globalSlug: slug, req }) as JsonSchemaType | null,
-    data,
-    entity: 'global',
-    partial: true,
-    req,
-  })
-
-const validateData = ({
-  slug,
-  buildSchema,
-  data,
-  entity,
-  partial,
-  req,
-}: {
-  buildSchema: () => JsonSchemaType | null
-  data: Record<string, unknown>
-  entity: 'collection' | 'global'
-  partial?: boolean
-  req: PayloadRequest
-  slug: string
-}): MCPToolResponse | null => {
-  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: JsonSchemaType): JsonSchemaType => {
-  const { required: _required, ...rest } = schema
-  return rest
-}