npm - @payloadcms/plugin-mcp - Versions diffs - 3.77.0-canary.7 → 3.77.0-internal-debug.98d2e4d - Mend

@payloadcms/plugin-mcp 3.77.0-canary.7 → 3.77.0-internal-debug.98d2e4d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (119) hide show

package/dist/mcp/tools/resource/update.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../src/mcp/tools/resource/update.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, SelectType, 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 { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\nimport { toolSchemas } from '../schemas.js'\nexport const updateResourceTool = (\n server: McpServer,\n req: PayloadRequest,\n user: TypedUser,\n verboseLogs: boolean,\n collectionSlug: string,\n collections: PluginMCPServerConfig['collections'],\n schema: JSONSchema4,\n) => {\n const tool = async (\n data: string,\n id?: number \| string,\n where?: string,\n draft: boolean = false,\n depth: number = 0,\n overrideLock: boolean = true,\n filePath?: string,\n overwriteExistingFiles: boolean = false,\n locale?: string,\n fallbackLocale?: string,\n select?: 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 resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, 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\n // Transform point fields from object format to tuple array\n parsedData = transformPointDataToPayload(parsedData)\n\n if (verboseLogs) {\n payload.logger.info(\n `[payload-mcp] Parsed data for ${collectionSlug}: ${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 (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) \|\|\n response) as {\n content: Array<{\n text: string\n type: 'text'\n }>\n }\n }\n\n // Validate that either id or where is provided\n if (!id && !where) {\n payload.logger.error('[payload-mcp] Either id or where clause must be provided')\n const response = {\n content: [\n { type: 'text' as const, text: 'Error: Either id or where clause must be provided' },\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 // 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.error(`[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 let selectClause: SelectType \| undefined\n if (select) {\n try {\n selectClause = JSON.parse(select) as SelectType\n } catch (_parseError) {\n payload.logger.warn(`[payload-mcp] Invalid select clause JSON: ${select}`)\n const response = {\n content: [{ type: 'text' as const, text: 'Error: Invalid JSON in select 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 // Update by ID or where clause\n if (id) {\n // Single document update\n const updateOptions = {\n id,\n collection: collectionSlug,\n data: parsedData,\n depth,\n draft,\n overrideAccess: false,\n overrideLock,\n req,\n user,\n ...(filePath && { filePath }),\n ...(overwriteExistingFiles && { overwriteExistingFiles }),\n ...(locale && { locale }),\n ...(fallbackLocale && { fallbackLocale }),\n ...(selectClause && { select: selectClause }),\n }\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Updating single document with ID: ${id}`)\n }\n const result = await payload.update({\n ...updateOptions,\n data: parsedData,\n } as any)\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Successfully updated document with ID: ${id}`)\n }\n\n const response = {\n content: [\n {\n type: 'text' as const,\n text: `Document updated successfully in collection \"${collectionSlug}\"!\nUpdated document:\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\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 } else {\n // Multiple documents update\n const updateOptions = {\n collection: collectionSlug,\n data: parsedData,\n depth,\n draft,\n overrideAccess: false,\n overrideLock,\n req,\n user,\n where: whereClause,\n ...(filePath && { filePath }),\n ...(overwriteExistingFiles && { overwriteExistingFiles }),\n ...(locale && { locale }),\n ...(fallbackLocale && { fallbackLocale }),\n ...(selectClause && { select: selectClause }),\n }\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Updating multiple documents with where clause`)\n }\n const result = await payload.update({\n ...updateOptions,\n data: parsedData,\n } as any)\n\n const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n const docs = bulkResult.docs \|\| []\n const errors = bulkResult.errors \|\| []\n\n if (verboseLogs) {\n payload.logger.info(\n `[payload-mcp] Successfully updated ${docs.length} documents, ${errors.length} errors`,\n )\n }\n\n let responseText = `Multiple documents updated in collection \"${collectionSlug}\"!\nUpdated: ${docs.length} documents\nErrors: ${errors.length}\n---`\n\n if (docs.length > 0) {\n responseText += `\\n\\nUpdated documents:\n\\`\\`\\`json\n${JSON.stringify(docs, null, 2)}\n\\`\\`\\``\n }\n\n if (errors.length > 0) {\n responseText += `\\n\\nErrors:\n\\`\\`\\`json\n${JSON.stringify(errors, 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?.(\n response,\n { docs, errors },\n req,\n ) \|\| response) as {\n content: Array<{\n text: string\n type: 'text'\n }>\n }\n }\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n payload.logger.error(\n `[payload-mcp] Error updating resource in ${collectionSlug}: ${errorMessage}`,\n )\n\n const response = {\n content: [\n {\n type: 'text' as const,\n text: `Error updating resource in collection \"${collectionSlug}\": ${errorMessage}`,\n },\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 const convertedFields = convertCollectionSchemaToZod(schema)\n\n // Create a new schema that combines the converted fields with update-specific parameters\n // Use .partial() to make all fields optional for partial updates\n const updateResourceSchema = z.object({\n ...convertedFields.partial().shape,\n id: z.union([z.string(), z.number()]).optional().describe('The ID of the document to update'),\n depth: z\n .number()\n .optional()\n .default(0)\n .describe('How many levels deep to populate relationships'),\n draft: z\n .boolean()\n .optional()\n .default(false)\n .describe('Whether to update the document as a draft'),\n fallbackLocale: z\n .string()\n .optional()\n .describe('Optional: fallback locale code to use when requested locale is not available'),\n filePath: z.string().optional().describe('File path for file uploads'),\n locale: z\n .string()\n .optional()\n .describe(\n 'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n ),\n overrideLock: z\n .boolean()\n .optional()\n .default(true)\n .describe('Whether to override document locks'),\n overwriteExistingFiles: z\n .boolean()\n .optional()\n .default(false)\n .describe('Whether to overwrite existing files'),\n select: z\n .string()\n .optional()\n .describe(\n 'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n ),\n where: z\n .string()\n .optional()\n .describe('JSON string for where clause to update multiple documents'),\n })\n\n server.tool(\n `update${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n `${collections?.[collectionSlug]?.description \|\| toolSchemas.updateResource.description.trim()}`,\n updateResourceSchema.shape,\n async (params: Record<string, unknown>) => {\n const {\n id,\n depth,\n draft,\n fallbackLocale,\n filePath,\n locale,\n overrideLock,\n overwriteExistingFiles,\n select,\n where,\n ...fieldData\n } = params\n // Convert field data back to JSON string format expected by the tool\n const data = JSON.stringify(fieldData)\n return await tool(\n data,\n id as number \| string \| undefined,\n where as string \| undefined,\n draft as boolean,\n depth as number,\n overrideLock as boolean,\n filePath as string \| undefined,\n overwriteExistingFiles as boolean,\n locale as string \| undefined,\n fallbackLocale as string \| undefined,\n select as string \| undefined,\n )\n },\n )\n }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","transformPointDataToPayload","toolSchemas","updateResourceTool","server","req","user","verboseLogs","collectionSlug","collections","schema","tool","data","id","where","draft","depth","overrideLock","filePath","overwriteExistingFiles","locale","fallbackLocale","select","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","response","content","type","text","overrideResponse","whereClause","selectClause","warn","updateOptions","collection","overrideAccess","result","update","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","convertedFields","updateResourceSchema","object","partial","shape","union","string","number","optional","describe","default","boolean","charAt","toUpperCase","slice","description","updateResource","trim","params","fieldData"],"mappings":"AAIA,SAASA,CAAC,QAAQ,MAAK;AAIvB,SAASC,WAAW,QAAQ,8BAA6B;AACzD,SAASC,4BAA4B,QAAQ,iDAAgD;AAC7F,SAASC,2BAA2B,QAAQ,gDAA+C;AAC3F,SAASC,WAAW,QAAQ,gBAAe;AAC3C,OAAO,MAAMC,qBAAqB,CAChCC,QACAC,KACAC,MACAC,aACAC,gBACAC,aACAC;IAEA,MAAMC,OAAO,OACXC,MACAC,IACAC,OACAC,QAAiB,KAAK,EACtBC,QAAgB,CAAC,EACjBC,eAAwB,IAAI,EAC5BC,UACAC,yBAAkC,KAAK,EACvCC,QACAC,gBACAC;QAOA,MAAMC,UAAUlB,IAAIkB,OAAO;QAE3B,IAAIhB,aAAa;YACfgB,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,+CAA+C,EAAEjB,iBAAiBK,KAAK,CAAC,UAAU,EAAEA,IAAI,GAAG,qBAAqB,SAAS,EAAEE,QAAQK,SAAS,CAAC,UAAU,EAAEA,QAAQ,GAAG,IAAI;QAE7K;QAEA,IAAI;YACF,sBAAsB;YACtB,IAAIM;YACJ,IAAI;gBACFA,aAAaC,KAAKC,KAAK,CAAChB;gBAExB,2DAA2D;gBAC3Dc,aAAazB,4BAA4ByB;gBAEzC,IAAInB,aAAa;oBACfgB,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,8BAA8B,EAAEjB,eAAe,EAAE,EAAEmB,KAAKE,SAAS,CAACH,aAAa;gBAEpF;YACF,EAAE,OAAOI,aAAa;gBACpBP,QAAQC,MAAM,CAACO,KAAK,CAAC,CAAC,0CAA0C,EAAEnB,MAAM;gBACxE,MAAMoB,WAAW;oBACfC,SAAS;wBAAC;4BAAEC,MAAM;4BAAiBC,MAAM;wBAAoC;qBAAE;gBACjF;gBACA,OAAQ1B,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAU,CAAC,GAAG3B,QACtE2B;YAMJ;YAEA,+CAA+C;YAC/C,IAAI,CAACnB,MAAM,CAACC,OAAO;gBACjBS,QAAQC,MAAM,CAACO,KAAK,CAAC;gBACrB,MAAMC,WAAW;oBACfC,SAAS;wBACP;4BAAEC,MAAM;4BAAiBC,MAAM;wBAAoD;qBACpF;gBACH;gBACA,OAAQ1B,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAU,CAAC,GAAG3B,QACtE2B;YAMJ;YAEA,iCAAiC;YACjC,IAAIK,cAAc,CAAC;YACnB,IAAIvB,OAAO;gBACT,IAAI;oBACFuB,cAAcV,KAAKC,KAAK,CAACd;oBACzB,IAAIP,aAAa;wBACfgB,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,kCAAkC,EAAEX,OAAO;oBAClE;gBACF,EAAE,OAAOgB,aAAa;oBACpBP,QAAQC,MAAM,CAACO,KAAK,CAAC,CAAC,yCAAyC,EAAEjB,OAAO;oBACxE,MAAMkB,WAAW;wBACfC,SAAS;4BAAC;gCAAEC,MAAM;gCAAiBC,MAAM;4BAAsC;yBAAE;oBACnF;oBACA,OAAQ1B,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAU,CAAC,GAAG3B,QACtE2B;gBAMJ;YACF;YAEA,IAAIM;YACJ,IAAIhB,QAAQ;gBACV,IAAI;oBACFgB,eAAeX,KAAKC,KAAK,CAACN;gBAC5B,EAAE,OAAOQ,aAAa;oBACpBP,QAAQC,MAAM,CAACe,IAAI,CAAC,CAAC,0CAA0C,EAAEjB,QAAQ;oBACzE,MAAMU,WAAW;wBACfC,SAAS;4BAAC;gCAAEC,MAAM;gCAAiBC,MAAM;4BAAuC;yBAAE;oBACpF;oBACA,OAAQ1B,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAU,CAAC,GAAG3B,QACtE2B;gBAMJ;YACF;YAEA,+BAA+B;YAC/B,IAAInB,IAAI;gBACN,yBAAyB;gBACzB,MAAM2B,gBAAgB;oBACpB3B;oBACA4B,YAAYjC;oBACZI,MAAMc;oBACNV;oBACAD;oBACA2B,gBAAgB;oBAChBzB;oBACAZ;oBACAC;oBACA,GAAIY,YAAY;wBAAEA;oBAAS,CAAC;oBAC5B,GAAIC,0BAA0B;wBAAEA;oBAAuB,CAAC;oBACxD,GAAIC,UAAU;wBAAEA;oBAAO,CAAC;oBACxB,GAAIC,kBAAkB;wBAAEA;oBAAe,CAAC;oBACxC,GAAIiB,gBAAgB;wBAAEhB,QAAQgB;oBAAa,CAAC;gBAC9C;gBAEA,IAAI/B,aAAa;oBACfgB,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,gDAAgD,EAAEZ,IAAI;gBAC7E;gBACA,MAAM8B,SAAS,MAAMpB,QAAQqB,MAAM,CAAC;oBAClC,GAAGJ,aAAa;oBAChB5B,MAAMc;gBACR;gBAEA,IAAInB,aAAa;oBACfgB,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,qDAAqD,EAAEZ,IAAI;gBAClF;gBAEA,MAAMmB,WAAW;oBACfC,SAAS;wBACP;4BACEC,MAAM;4BACNC,MAAM,CAAC,6CAA6C,EAAE3B,eAAe;;;AAGnF,EAAEmB,KAAKE,SAAS,CAACc,QAAQ,MAAM,GAAG;MAC5B,CAAC;wBACK;qBACD;gBACH;gBAEA,OAAQlC,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAUW,QAAQtC,QAC1E2B;YAMJ,OAAO;gBACL,4BAA4B;gBAC5B,MAAMQ,gBAAgB;oBACpBC,YAAYjC;oBACZI,MAAMc;oBACNV;oBACAD;oBACA2B,gBAAgB;oBAChBzB;oBACAZ;oBACAC;oBACAQ,OAAOuB;oBACP,GAAInB,YAAY;wBAAEA;oBAAS,CAAC;oBAC5B,GAAIC,0BAA0B;wBAAEA;oBAAuB,CAAC;oBACxD,GAAIC,UAAU;wBAAEA;oBAAO,CAAC;oBACxB,GAAIC,kBAAkB;wBAAEA;oBAAe,CAAC;oBACxC,GAAIiB,gBAAgB;wBAAEhB,QAAQgB;oBAAa,CAAC;gBAC9C;gBAEA,IAAI/B,aAAa;oBACfgB,QAAQC,MAAM,CAACC,IAAI,CAAC,CAAC,2DAA2D,CAAC;gBACnF;gBACA,MAAMkB,SAAS,MAAMpB,QAAQqB,MAAM,CAAC;oBAClC,GAAGJ,aAAa;oBAChB5B,MAAMc;gBACR;gBAEA,MAAMmB,aAAaF;gBACnB,MAAMG,OAAOD,WAAWC,IAAI,IAAI,EAAE;gBAClC,MAAMC,SAASF,WAAWE,MAAM,IAAI,EAAE;gBAEtC,IAAIxC,aAAa;oBACfgB,QAAQC,MAAM,CAACC,IAAI,CACjB,CAAC,mCAAmC,EAAEqB,KAAKE,MAAM,CAAC,YAAY,EAAED,OAAOC,MAAM,CAAC,OAAO,CAAC;gBAE1F;gBAEA,IAAIC,eAAe,CAAC,0CAA0C,EAAEzC,eAAe;SAC9E,EAAEsC,KAAKE,MAAM,CAAC;QACf,EAAED,OAAOC,MAAM,CAAC;GACrB,CAAC;gBAEI,IAAIF,KAAKE,MAAM,GAAG,GAAG;oBACnBC,gBAAgB,CAAC;;AAE3B,EAAEtB,KAAKE,SAAS,CAACiB,MAAM,MAAM,GAAG;MAC1B,CAAC;gBACC;gBAEA,IAAIC,OAAOC,MAAM,GAAG,GAAG;oBACrBC,gBAAgB,CAAC;;AAE3B,EAAEtB,KAAKE,SAAS,CAACkB,QAAQ,MAAM,GAAG;MAC5B,CAAC;gBACC;gBAEA,MAAMf,WAAW;oBACfC,SAAS;wBACP;4BACEC,MAAM;4BACNC,MAAMc;wBACR;qBACD;gBACH;gBAEA,OAAQxC,aAAa,CAACD,eAAe,EAAE4B,mBACrCJ,UACA;oBAAEc;oBAAMC;gBAAO,GACf1C,QACG2B;YAMP;QACF,EAAE,OAAOD,OAAO;YACd,MAAMmB,eAAenB,iBAAiBoB,QAAQpB,MAAMqB,OAAO,GAAG;YAC9D7B,QAAQC,MAAM,CAACO,KAAK,CAClB,CAAC,yCAAyC,EAAEvB,eAAe,EAAE,EAAE0C,cAAc;YAG/E,MAAMlB,WAAW;gBACfC,SAAS;oBACP;wBACEC,MAAM;wBACNC,MAAM,CAAC,uCAAuC,EAAE3B,eAAe,GAAG,EAAE0C,cAAc;oBACpF;iBACD;YACH;YAEA,OAAQzC,aAAa,CAACD,eAAe,EAAE4B,mBAAmBJ,UAAU,CAAC,GAAG3B,QAAQ2B;QAMlF;IACF;IAEA,IAAIvB,aAAa,CAACD,eAAe,EAAE6C,SAAS;QAC1C,MAAMC,kBAAkBtD,6BAA6BU;QAErD,yFAAyF;QACzF,iEAAiE;QACjE,MAAM6C,uBAAuBzD,EAAE0D,MAAM,CAAC;YACpC,GAAGF,gBAAgBG,OAAO,GAAGC,KAAK;YAClC7C,IAAIf,EAAE6D,KAAK,CAAC;gBAAC7D,EAAE8D,MAAM;gBAAI9D,EAAE+D,MAAM;aAAG,EAAEC,QAAQ,GAAGC,QAAQ,CAAC;YAC1D/C,OAAOlB,EACJ+D,MAAM,GACNC,QAAQ,GACRE,OAAO,CAAC,GACRD,QAAQ,CAAC;YACZhD,OAAOjB,EACJmE,OAAO,GACPH,QAAQ,GACRE,OAAO,CAAC,OACRD,QAAQ,CAAC;YACZ1C,gBAAgBvB,EACb8D,MAAM,GACNE,QAAQ,GACRC,QAAQ,CAAC;YACZ7C,UAAUpB,EAAE8D,MAAM,GAAGE,QAAQ,GAAGC,QAAQ,CAAC;YACzC3C,QAAQtB,EACL8D,MAAM,GACNE,QAAQ,GACRC,QAAQ,CACP;YAEJ9C,cAAcnB,EACXmE,OAAO,GACPH,QAAQ,GACRE,OAAO,CAAC,MACRD,QAAQ,CAAC;YACZ5C,wBAAwBrB,EACrBmE,OAAO,GACPH,QAAQ,GACRE,OAAO,CAAC,OACRD,QAAQ,CAAC;YACZzC,QAAQxB,EACL8D,MAAM,GACNE,QAAQ,GACRC,QAAQ,CACP;YAEJjD,OAAOhB,EACJ8D,MAAM,GACNE,QAAQ,GACRC,QAAQ,CAAC;QACd;QAEA3D,OAAOO,IAAI,CACT,CAAC,MAAM,EAAEH,eAAe0D,MAAM,CAAC,GAAGC,WAAW,KAAKpE,YAAYS,gBAAgB4D,KAAK,CAAC,IAAI,EACxF,GAAG3D,aAAa,CAACD,eAAe,EAAE6D,eAAenE,YAAYoE,cAAc,CAACD,WAAW,CAACE,IAAI,IAAI,EAChGhB,qBAAqBG,KAAK,EAC1B,OAAOc;YACL,MAAM,EACJ3D,EAAE,EACFG,KAAK,EACLD,KAAK,EACLM,cAAc,EACdH,QAAQ,EACRE,MAAM,EACNH,YAAY,EACZE,sBAAsB,EACtBG,MAAM,EACNR,KAAK,EACL,GAAG2D,WACJ,GAAGD;YACJ,qEAAqE;YACrE,MAAM5D,OAAOe,KAAKE,SAAS,CAAC4C;YAC5B,OAAO,MAAM9D,KACXC,MACAC,IACAC,OACAC,OACAC,OACAC,cACAC,UACAC,wBACAC,QACAC,gBACAC;QAEJ;IAEJ;AACF,EAAC"}
1	+ {"version":3,"sources":["../../../../src/mcp/tools/resource/update.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { JSONSchema4 } from 'json-schema'\nimport type { PayloadRequest, SelectType, 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/schemaConversion/convertCollectionSchemaToZod.js'\nimport { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'\nimport { toolSchemas } from '../schemas.js'\nexport const updateResourceTool = (\n server: McpServer,\n req: PayloadRequest,\n user: TypedUser,\n verboseLogs: boolean,\n collectionSlug: string,\n collections: PluginMCPServerConfig['collections'],\n schema: JSONSchema4,\n) => {\n const tool = async (\n data: string,\n id?: number \| string,\n where?: string,\n draft: boolean = false,\n depth: number = 0,\n overrideLock: boolean = true,\n filePath?: string,\n overwriteExistingFiles: boolean = false,\n locale?: string,\n fallbackLocale?: string,\n select?: 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 resource in collection: ${collectionSlug}${id ? ` with ID: ${id}` : ' with where clause'}, 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\n // Transform point fields from object format to tuple array\n parsedData = transformPointDataToPayload(parsedData)\n\n if (verboseLogs) {\n payload.logger.info(\n `[payload-mcp] Parsed data for ${collectionSlug}: ${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 (collections?.[collectionSlug]?.overrideResponse?.(response, {}, req) \|\|\n response) as {\n content: Array<{\n text: string\n type: 'text'\n }>\n }\n }\n\n // Validate that either id or where is provided\n if (!id && !where) {\n payload.logger.error('[payload-mcp] Either id or where clause must be provided')\n const response = {\n content: [\n { type: 'text' as const, text: 'Error: Either id or where clause must be provided' },\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 // 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.error(`[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 let selectClause: SelectType \| undefined\n if (select) {\n try {\n selectClause = JSON.parse(select) as SelectType\n } catch (_parseError) {\n payload.logger.warn(`[payload-mcp] Invalid select clause JSON: ${select}`)\n const response = {\n content: [{ type: 'text' as const, text: 'Error: Invalid JSON in select 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 // Update by ID or where clause\n if (id) {\n // Single document update\n const updateOptions = {\n id,\n collection: collectionSlug,\n data: parsedData,\n depth,\n draft,\n overrideAccess: false,\n overrideLock,\n req,\n user,\n ...(filePath && { filePath }),\n ...(overwriteExistingFiles && { overwriteExistingFiles }),\n ...(locale && { locale }),\n ...(fallbackLocale && { fallbackLocale }),\n ...(selectClause && { select: selectClause }),\n }\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Updating single document with ID: ${id}`)\n }\n const result = await payload.update({\n ...updateOptions,\n data: parsedData,\n } as any)\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Successfully updated document with ID: ${id}`)\n }\n\n const response = {\n content: [\n {\n type: 'text' as const,\n text: `Document updated successfully in collection \"${collectionSlug}\"!\nUpdated document:\n\\`\\`\\`json\n${JSON.stringify(result, null, 2)}\n\\`\\`\\``,\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 } else {\n // Multiple documents update\n const updateOptions = {\n collection: collectionSlug,\n data: parsedData,\n depth,\n draft,\n overrideAccess: false,\n overrideLock,\n req,\n user,\n where: whereClause,\n ...(filePath && { filePath }),\n ...(overwriteExistingFiles && { overwriteExistingFiles }),\n ...(locale && { locale }),\n ...(fallbackLocale && { fallbackLocale }),\n ...(selectClause && { select: selectClause }),\n }\n\n if (verboseLogs) {\n payload.logger.info(`[payload-mcp] Updating multiple documents with where clause`)\n }\n const result = await payload.update({\n ...updateOptions,\n data: parsedData,\n } as any)\n\n const bulkResult = result as { docs?: unknown[]; errors?: unknown[] }\n const docs = bulkResult.docs \|\| []\n const errors = bulkResult.errors \|\| []\n\n if (verboseLogs) {\n payload.logger.info(\n `[payload-mcp] Successfully updated ${docs.length} documents, ${errors.length} errors`,\n )\n }\n\n let responseText = `Multiple documents updated in collection \"${collectionSlug}\"!\nUpdated: ${docs.length} documents\nErrors: ${errors.length}\n---`\n\n if (docs.length > 0) {\n responseText += `\\n\\nUpdated documents:\n\\`\\`\\`json\n${JSON.stringify(docs, null, 2)}\n\\`\\`\\``\n }\n\n if (errors.length > 0) {\n responseText += `\\n\\nErrors:\n\\`\\`\\`json\n${JSON.stringify(errors, 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?.(\n response,\n { docs, errors },\n req,\n ) \|\| response) as {\n content: Array<{\n text: string\n type: 'text'\n }>\n }\n }\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n payload.logger.error(\n `[payload-mcp] Error updating resource in ${collectionSlug}: ${errorMessage}`,\n )\n\n const response = {\n content: [\n {\n type: 'text' as const,\n text: `Error updating resource in collection \"${collectionSlug}\": ${errorMessage}`,\n },\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 const convertedFields = convertCollectionSchemaToZod(schema)\n\n // Create a new schema that combines the converted fields with update-specific parameters\n // Use .partial() to make all fields optional for partial updates\n const updateResourceSchema = z.object({\n ...convertedFields.partial().shape,\n id: z.union([z.string(), z.number()]).optional().describe('The ID of the document to update'),\n depth: z\n .number()\n .optional()\n .default(0)\n .describe('How many levels deep to populate relationships'),\n draft: z\n .boolean()\n .optional()\n .default(false)\n .describe('Whether to update the document as a draft'),\n fallbackLocale: z\n .string()\n .optional()\n .describe('Optional: fallback locale code to use when requested locale is not available'),\n filePath: z.string().optional().describe('File path for file uploads'),\n locale: z\n .string()\n .optional()\n .describe(\n 'Optional: locale code to update the document in (e.g., \"en\", \"es\"). Defaults to the default locale',\n ),\n overrideLock: z\n .boolean()\n .optional()\n .default(true)\n .describe('Whether to override document locks'),\n overwriteExistingFiles: z\n .boolean()\n .optional()\n .default(false)\n .describe('Whether to overwrite existing files'),\n select: z\n .string()\n .optional()\n .describe(\n 'Optional: define exactly which fields you\\'d like to return in the response (JSON), e.g., \\'{\"title\": \"My Post\"}\\'',\n ),\n where: z\n .string()\n .optional()\n .describe('JSON string for where clause to update multiple documents'),\n })\n\n server.registerTool(\n `update${collectionSlug.charAt(0).toUpperCase() + toCamelCase(collectionSlug).slice(1)}`,\n {\n description: `${collections?.[collectionSlug]?.description \|\| toolSchemas.updateResource.description.trim()}`,\n inputSchema: updateResourceSchema.shape,\n },\n async (params: Record<string, unknown>) => {\n const {\n id,\n depth,\n draft,\n fallbackLocale,\n filePath,\n locale,\n overrideLock,\n overwriteExistingFiles,\n select,\n where,\n ...fieldData\n } = params\n // Convert field data back to JSON string format expected by the tool\n const data = JSON.stringify(fieldData)\n return await tool(\n data,\n id as number \| string \| undefined,\n where as string \| undefined,\n draft as boolean,\n depth as number,\n overrideLock as boolean,\n filePath as string \| undefined,\n overwriteExistingFiles as boolean,\n locale as string \| undefined,\n fallbackLocale as string \| undefined,\n select as string \| undefined,\n )\n },\n )\n }\n}\n"],"names":["z","toCamelCase","convertCollectionSchemaToZod","transformPointDataToPayload","toolSchemas","updateResourceTool","server","req","user","verboseLogs","collectionSlug","collections","schema","tool","data","id","where","draft","depth","overrideLock","filePath","overwriteExistingFiles","locale","fallbackLocale","select","payload","logger","info","parsedData","JSON","parse","stringify","_parseError","error","response","content","type","text","overrideResponse","whereClause","selectClause","warn","updateOptions","collection","overrideAccess","result","update","bulkResult","docs","errors","length","responseText","errorMessage","Error","message","enabled","convertedFields","updateResourceSchema","object","partial","shape","union","string","number","optional","describe","default","boolean","registerTool","charAt","toUpperCase","slice","description","updateResource","trim","inputSchema","params","fieldData"],"mappings":"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"}

package/dist/types.d.ts CHANGED Viewed

@@ -288,16 +288,26 @@ export type MCPHandlerOptions = {
      * @default /api
      */
     basePath?: string;
+    /**
+     * If true, disables the SSE endpoint. Only Streamable HTTP will be available.
+     * @default true
+     */
+    disableSse?: boolean;
     /**
      * Set the maximum duration of the MCP handler. This is the maximum duration that the MCP handler will run for.
      * @default 60
      */
     maxDuration?: number;
+    /**
+     * Callback function that receives MCP events.
+     * This can be used to track analytics, debug issues, or implement custom behaviors.
+     */
+    onEvent?: (event: unknown) => void;
     /**
      * Set the Redis URL for the MCP handler. This is the URL that will be used to access the Redis server.
      * @default process.env.REDIS_URL
-     * INFO: Disabled until developer clarity is reached for server side streaming and we have an auth pattern for all SSE patterns
      */
+    redisUrl?: string;
     /**
      * Set verbose logging.
      * @default false

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CACnB,MAAM,CACJ,cAAc,EACd;QACE;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB;;WAEG;QACH,OAAO,EACH;YACE,MAAM,CAAC,EAAE,OAAO,CAAA;YAChB,MAAM,CAAC,EAAE,OAAO,CAAA;YAChB,IAAI,CAAC,EAAE,OAAO,CAAA;YACd,MAAM,CAAC,EAAE,OAAO,CAAA;SACjB,GACD,OAAO,CAAA;QAEX;;WAEG;QACH,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK,CAAC;gBACb,IAAI,EAAE,MAAM,CAAA;gBACZ,IAAI,EAAE,MAAM,CAAA;aACb,CAAC,CAAA;SACH,EACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,cAAc,KAChB;YACH,OAAO,EAAE,KAAK,CAAC;gBACb,IAAI,EAAE,MAAM,CAAA;gBACZ,IAAI,EAAE,MAAM,CAAA;aACb,CAAC,CAAA;SACH,CAAA;KACF,CACF,CACF,CAAA;IACD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb;;WAEG;QACH,KAAK,EAAE;YACL;;eAEG;YACH,IAAI,CAAC,EAAE;gBACL;;;mBAGG;gBACH,OAAO,EAAE,OAAO,CAAA;aACjB,CAAA;YACD;;eAEG;YACH,WAAW,CAAC,EAAE;gBACZ;;mBAEG;gBACH,kBAAkB,EAAE,MAAM,CAAA;gBAC1B;;;mBAGG;gBACH,OAAO,EAAE,OAAO,CAAA;aACjB,CAAA;YACD;;eAEG;YACH,MAAM,CAAC,EAAE;gBACP;;mBAEG;gBACH,cAAc,EAAE,MAAM,CAAA;gBACtB;;;mBAGG;gBACH,OAAO,EAAE,OAAO,CAAA;aACjB,CAAA;YACD;;eAEG;YACH,IAAI,CAAC,EAAE;gBACL;;;mBAGG;gBACH,OAAO,EAAE,OAAO,CAAA;gBAChB;;mBAEG;gBACH,WAAW,EAAE,MAAM,CAAA;aACpB,CAAA;SACF,CAAA;KACF,CAAA;IACD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CACf,MAAM,CACJ,UAAU,EACV;QACE;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB;;;WAGG;QACH,OAAO,EACH;YACE,IAAI,CAAC,EAAE,OAAO,CAAA;YACd,MAAM,CAAC,EAAE,OAAO,CAAA;SACjB,GACD,OAAO,CAAA;QAEX;;WAEG;QACH,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK,CAAC;gBACb,IAAI,EAAE,MAAM,CAAA;gBACZ,IAAI,EAAE,MAAM,CAAA;aACb,CAAC,CAAA;SACH,EACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,cAAc,KAChB;YACH,OAAO,EAAE,KAAK,CAAC;gBACb,IAAI,EAAE,MAAM,CAAA;gBACZ,IAAI,EAAE,MAAM,CAAA;aACb,CAAC,CAAA;SACH,CAAA;KACF,CACF,CACF,CAAA;IACD;;OAEG;IACH,GAAG,CAAC,EAAE;QACJ,cAAc,CAAC,EAAE,iBAAiB,CAAA;QAClC;;WAEG;QACH,OAAO,CAAC,EAAE;YACR;;eAEG;YACH,UAAU,EAAE,CAAC,CAAC,WAAW,CAAA;YACzB;;eAEG;YACH,WAAW,EAAE,MAAM,CAAA;YACnB;;eAEG;YACH,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,OAAO,KAEb;gBACE,QAAQ,EAAE,KAAK,CAAC;oBACd,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM,CAAA;wBACZ,IAAI,EAAE,MAAM,CAAA;qBACb,CAAA;oBACD,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;iBAC3B,CAAC,CAAA;aACH,GACD,OAAO,CAAC;gBACN,QAAQ,EAAE,KAAK,CAAC;oBACd,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM,CAAA;wBACZ,IAAI,EAAE,MAAM,CAAA;qBACb,CAAA;oBACD,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;iBAC3B,CAAC,CAAA;aACH,CAAC,CAAA;YACN;;eAEG;YACH,IAAI,EAAE,MAAM,CAAA;YACZ;;eAEG;YACH,KAAK,EAAE,MAAM,CAAA;SACd,EAAE,CAAA;QAEH;;WAEG;QACH,SAAS,CAAC,EAAE;YACV;;;eAGG;YACH,WAAW,EAAE,MAAM,CAAA;YACnB;;;eAGG;YACH,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KACpB;gBACE,QAAQ,EAAE,KAAK,CAAC;oBACd,IAAI,EAAE,MAAM,CAAA;oBACZ,GAAG,EAAE,MAAM,CAAA;iBACZ,CAAC,CAAA;aACH,GACD,OAAO,CAAC;gBACN,QAAQ,EAAE,KAAK,CAAC;oBACd,IAAI,EAAE,MAAM,CAAA;oBACZ,GAAG,EAAE,MAAM,CAAA;iBACZ,CAAC,CAAA;aACH,CAAC,CAAA;YACN;;;eAGG;YACH,QAAQ,EAAE,MAAM,CAAA;YAChB;;;eAGG;YACH,IAAI,EAAE,MAAM,CAAA;YACZ;;;eAGG;YACH,KAAK,EAAE,MAAM,CAAA;YACb;;;eAGG;YACH,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAAA;SAC/B,EAAE,CAAA;QACH,aAAa,CAAC,EAAE,gBAAgB,CAAA;QAChC;;WAEG;QACH,KAAK,CAAC,EAAE;YACN;;eAEG;YACH,WAAW,EAAE,MAAM,CAAA;YACnB;;eAEG;YACH,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,OAAO,KAEb;gBACE,OAAO,EAAE,KAAK,CAAC;oBACb,IAAI,EAAE,MAAM,CAAA;oBACZ,IAAI,EAAE,MAAM,CAAA;iBACb,CAAC,CAAA;gBACF,IAAI,CAAC,EAAE,MAAM,CAAA;aACd,GACD,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK,CAAC;oBACb,IAAI,EAAE,MAAM,CAAA;oBACZ,IAAI,EAAE,MAAM,CAAA;iBACb,CAAC,CAAA;gBACF,IAAI,CAAC,EAAE,MAAM,CAAA;aACd,CAAC,CAAA;YACN;;eAEG;YACH,IAAI,EAAE,MAAM,CAAA;YACZ;;eAEG;YACH,UAAU,EAAE,CAAC,CAAC,WAAW,CAAA;SAC1B,EAAE,CAAA;KACJ,CAAA;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,gBAAgB,CAAA;IAE7E;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,cAAc,EACnB,2BAA2B,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,KACxF,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAEnD;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB~~;;;;OAIG~~;~~IAEH~~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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n CollectionConfig,\n CollectionSlug,\n GlobalSlug,\n PayloadRequest,\n TypedUser,\n} from 'payload'\nimport type { z } from 'zod'\n\nimport { type ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport type PluginMCPServerConfig = {\n /*\n Set the collections that should be available as resources via MCP.\n /\n collections?: Partial<\n Record<\n CollectionSlug,\n {\n /\n Set the description of the collection. This is used by MCP clients to determine when to use the collecton as a resource.\n /\n description?: string\n /\n Set the enabled capabilities of the collection. Admins can then allow or disallow the use of the capability by MCP clients.\n /\n enabled:\n \| {\n create?: boolean\n delete?: boolean\n find?: boolean\n update?: boolean\n }\n \| boolean\n\n /\n Override the response generated by the MCP client. This allows you to modify the response that is sent to the MCP client. This is useful for adding additional data to the response, data normalization, or verifying data.\n /\n overrideResponse?: (\n response: {\n content: Array<{\n text: string\n type: string\n }>\n },\n doc: Record<string, unknown>,\n req: PayloadRequest,\n ) => {\n content: Array<{\n text: string\n type: string\n }>\n }\n }\n >\n >\n /\n Disable the MCP plugin.\n /\n disabled?: boolean\n /\n Experimental features\n * These features are for experimental purposes -- They are Disabled in Production by Default\n /\n experimental?: {\n /\n These are MCP tools that can be used by a client to modify Payload.\n /\n tools: {\n /\n Experimental -- Auth MCP tools allow a client to change authentication priviliages for users. This is for developing ideas that help Admins with authentication tasks.\n /\n auth?: {\n /\n Enable the auth MCP tools. This allows Admins to enable or disable the auth capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Collection MCP tools allow for the creation, modification, and deletion of Payload collections. This is for developing ideas that help Developers with collection tasks.\n /\n collections?: {\n /\n Set the directory path to the collections directory. This can be a directory outside of your default directory, or another Payload project.\n /\n collectionsDirPath: string\n /\n Enable the collection MCP tools. This allows Admins to enable or disable the Collection modification capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Config MCP tools allow for the modification of a Payload Config. This is for developing ideas that help Developers with config tasks.\n /\n config?: {\n /\n Set the directory path to the config directory. This can be a directory outside of your default directory, or another Payload project.\n /\n configFilePath: string\n /\n Enable the config MCP tools. This allows Admins to enable or disable the Payload Config modification capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Jobs MCP tools allow for the modification of Payload jobs. This is for developing ideas that help Developers with job tasks.\n /\n jobs?: {\n /\n Enable the jobs MCP tools. This allows Admins to enable or disable the Job modification capabilities.\n * @default false\n /\n enabled: boolean\n /\n Set the directory path to the jobs directory. This can be a directory outside of your default directory, or another Payload project.\n /\n jobsDirPath: string\n }\n }\n }\n /\n Set the globals that should be available as resources via MCP.\n * Globals are singleton configuration objects (e.g., site settings, navigation).\n * Note: Globals only support find and update operations.\n /\n globals?: Partial<\n Record<\n GlobalSlug,\n {\n /\n Set the description of the global. This is used by MCP clients to determine when to use the global as a resource.\n /\n description?: string\n /\n Set the enabled capabilities of the global. Admins can then allow or disallow the use of the capability by MCP clients.\n * Note: Globals only support find and update operations as they are singletons.\n /\n enabled:\n \| {\n find?: boolean\n update?: boolean\n }\n \| boolean\n\n /\n Override the response generated by the MCP client. This allows you to modify the response that is sent to the MCP client. This is useful for adding additional data to the response, data normalization, or verifying data.\n /\n overrideResponse?: (\n response: {\n content: Array<{\n text: string\n type: string\n }>\n },\n doc: Record<string, unknown>,\n req: PayloadRequest,\n ) => {\n content: Array<{\n text: string\n type: string\n }>\n }\n }\n >\n >\n /\n MCP Server options.\n /\n mcp?: {\n handlerOptions?: MCPHandlerOptions\n /\n Add custom MCP Prompts.\n /\n prompts?: {\n /\n Set the args schema of the prompt. This is the args schema that will be passed to the prompt. This is used by MCP clients to determine the arguments that will be passed to the prompt.\n /\n argsSchema: z.ZodRawShape\n /\n Set the description of the prompt. This is used by MCP clients to determine when to use the prompt.\n /\n description: string\n /\n Set the handler of the prompt. This is the function that will be called when the prompt is used.\n /\n handler: (\n args: Record<string, unknown>,\n req: PayloadRequest,\n _extra: unknown,\n ) =>\n \| {\n messages: Array<{\n content: {\n text: string\n type: 'text'\n }\n role: 'assistant' \| 'user'\n }>\n }\n \| Promise<{\n messages: Array<{\n content: {\n text: string\n type: 'text'\n }\n role: 'assistant' \| 'user'\n }>\n }>\n /\n Set the function name of the prompt.\n /\n name: string\n /\n Set the title of the prompt. LLMs will interperate the title to determine when to use the prompt.\n /\n title: string\n }[]\n\n /\n Add custom MCP Resource.\n /\n resources?: {\n /\n Set the description of the resource. This is used by MCP clients to determine when to use the resource.\n * example: 'Data is a resource that contains special data.'\n /\n description: string\n /\n Set the handler of the resource. This is the function that will be called when the resource is used.\n * The handler can have either 3 arguments (when no args are passed) or 4 arguments (when args are passed).\n /\n handler: (...args: any[]) =>\n \| {\n contents: Array<{\n text: string\n uri: string\n }>\n }\n \| Promise<{\n contents: Array<{\n text: string\n uri: string\n }>\n }>\n /\n Set the mime type of the resource.\n * example: 'text/plain'\n /\n mimeType: string\n /\n Set the function name of the resource.\n * example: 'data'\n /\n name: string\n /\n Set the title of the resource. LLMs will interperate the title to determine when to use the resource.\n * example: 'Data'\n /\n title: string\n /\n Set the uri of the resource.\n * example: 'data://app'\n /\n uri: ResourceTemplate \| string\n }[]\n serverOptions?: MCPServerOptions\n /\n Add custom MCP Tools.\n /\n tools?: {\n /\n Set the description of the tool. This is used by MCP clients to determine when to use the tool.\n /\n description: string\n /\n Set the handler of the tool. This is the function that will be called when the tool is used.\n /\n handler: (\n args: Record<string, unknown>,\n req: PayloadRequest,\n _extra: unknown,\n ) =>\n \| {\n content: Array<{\n text: string\n type: 'text'\n }>\n role?: string\n }\n \| Promise<{\n content: Array<{\n text: string\n type: 'text'\n }>\n role?: string\n }>\n /\n Set the name of the tool. This is the name that will be used to identify the tool. LLMs will interperate the name to determine when to use the tool.\n /\n name: string\n /\n Set the parameters of the tool. This is the parameters that will be passed to the tool.\n /\n parameters: z.ZodRawShape\n }[]\n }\n\n /\n Override the API key collection.\n * This allows you to add fields to the API key collection or modify the collection in any way you want.\n * @param collection - The API key collection.\n * @returns The modified API key collection.\n /\n overrideApiKeyCollection?: (collection: CollectionConfig) => CollectionConfig\n\n /\n Override the authentication method.\n * This allows you to use a custom authentication method instead of the default API key authentication.\n * @param req - The request object.\n * @returns The MCP access settings.\n /\n overrideAuth?: (\n req: PayloadRequest,\n getDefaultMcpAccessSettings: (overrideApiKey?: null \| string) => Promise<MCPAccessSettings>,\n ) => MCPAccessSettings \| Promise<MCPAccessSettings>\n\n /\n Set the users collection that API keys should be associated with.\n /\n userCollection?: CollectionSlug\n}\n\n/\n MCP Handler options.\n /\nexport type MCPHandlerOptions = {\n /\n Set the base path of the MCP handler. This is the path that will be used to access the MCP handler.\n * @default /api\n /\n basePath?: string\n /\n Set the maximum duration of the MCP handler. This is the maximum duration that the MCP handler will run for.\n * @default 60\n /\n maxDuration?: number\n /\n Set the Redis URL for the MCP handler. This is the URL that will be used to access the Redis server.\n * @default process.env.REDIS_URL\n * INFO: Disabled until developer clarity is reached for server side streaming and we have an auth pattern for all SSE patterns\n /\n // redisUrl?: string\n /\n Set verbose logging.\n * @default false\n /\n verboseLogs?: boolean\n}\n\n/\n MCP Server options.\n /\nexport type MCPServerOptions = {\n /\n Set the server info of the MCP server.\n /\n serverInfo?: {\n /\n Set the name of the MCP server.\n * @default 'Payload MCP Server'\n /\n name: string\n /\n Set the version of the MCP server.\n * @default '1.0.0'\n */\n version: string\n }\n}\n\nexport type MCPAccessSettings = {\n auth?: {\n auth?: boolean\n forgotPassword?: boolean\n login?: boolean\n resetPassword?: boolean\n unlock?: boolean\n verify?: boolean\n }\n collections?: {\n create?: boolean\n delete?: boolean\n find?: boolean\n update?: boolean\n }\n config?: {\n find?: boolean\n update?: boolean\n }\n custom?: Record<string, boolean>\n globals?: {\n find?: boolean\n update?: boolean\n }\n jobs?: {\n create?: boolean\n run?: boolean\n update?: boolean\n }\n 'payload-mcp-prompt'?: Record<string, boolean>\n 'payload-mcp-resource'?: Record<string, boolean>\n 'payload-mcp-tool'?: Record<string, boolean>\n user: TypedUser\n} & Record<string, unknown>\n\nexport type EntityConfig = PluginMCPServerConfig['collections'] \| PluginMCPServerConfig['globals']\n\nexport type FieldDefinition = {\n description?: string\n name: string\n options?: { label: string; value: string }[]\n position?: 'main' \| 'sidebar'\n required?: boolean\n type: string\n}\n\nexport type FieldModification = {\n changes: {\n description?: string\n options?: { label: string; value: string }[]\n position?: 'main' \| 'sidebar'\n required?: boolean\n type?: string\n }\n fieldName: string\n}\n\nexport type CollectionConfigUpdates = {\n access?: {\n create?: string\n delete?: string\n read?: string\n update?: string\n }\n description?: string\n slug?: string\n timestamps?: boolean\n versioning?: boolean\n}\n\nexport type AdminConfig = {\n avatar?: string\n css?: string\n dateFormat?: string\n inactivityRoute?: string\n livePreview?: {\n breakpoints?: Array<{\n height: number\n label: string\n name: string\n width: number\n }>\n }\n logoutRoute?: string\n meta?: {\n favicon?: string\n ogImage?: string\n titleSuffix?: string\n }\n user?: string\n}\n\nexport type DatabaseConfig = {\n connectOptions?: string\n type?: 'mongodb' \| 'postgres'\n url?: string\n}\n\nexport type PluginUpdates = {\n add?: string[]\n remove?: string[]\n}\n\nexport type GeneralConfig = {\n cookiePrefix?: string\n cors?: string\n csrf?: string\n graphQL?: {\n disable?: boolean\n schemaOutputFile?: string\n }\n rateLimit?: {\n max?: number\n skip?: string\n window?: number\n }\n secret?: string\n serverURL?: string\n typescript?: {\n declare?: boolean\n outputFile?: string\n }\n}\n\nexport interface SchemaField {\n description?: string\n name: string\n options?: string[]\n required?: boolean\n type: string\n}\n\nexport interface TaskSequenceItem {\n description?: string\n retries?: number\n taskId: string\n taskSlug: string\n timeout?: number\n}\n\nexport interface JobConfigUpdate {\n description?: string\n queue?: string\n retries?: number\n timeout?: number\n}\n"],"names":[],"mappings":"AA2gBA,WAKC"}
1	+ {"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n CollectionConfig,\n CollectionSlug,\n GlobalSlug,\n PayloadRequest,\n TypedUser,\n} from 'payload'\nimport type { z } from 'zod'\n\nimport { type ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport type PluginMCPServerConfig = {\n /*\n Set the collections that should be available as resources via MCP.\n /\n collections?: Partial<\n Record<\n CollectionSlug,\n {\n /\n Set the description of the collection. This is used by MCP clients to determine when to use the collecton as a resource.\n /\n description?: string\n /\n Set the enabled capabilities of the collection. Admins can then allow or disallow the use of the capability by MCP clients.\n /\n enabled:\n \| {\n create?: boolean\n delete?: boolean\n find?: boolean\n update?: boolean\n }\n \| boolean\n\n /\n Override the response generated by the MCP client. This allows you to modify the response that is sent to the MCP client. This is useful for adding additional data to the response, data normalization, or verifying data.\n /\n overrideResponse?: (\n response: {\n content: Array<{\n text: string\n type: string\n }>\n },\n doc: Record<string, unknown>,\n req: PayloadRequest,\n ) => {\n content: Array<{\n text: string\n type: string\n }>\n }\n }\n >\n >\n /\n Disable the MCP plugin.\n /\n disabled?: boolean\n /\n Experimental features\n * These features are for experimental purposes -- They are Disabled in Production by Default\n /\n experimental?: {\n /\n These are MCP tools that can be used by a client to modify Payload.\n /\n tools: {\n /\n Experimental -- Auth MCP tools allow a client to change authentication priviliages for users. This is for developing ideas that help Admins with authentication tasks.\n /\n auth?: {\n /\n Enable the auth MCP tools. This allows Admins to enable or disable the auth capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Collection MCP tools allow for the creation, modification, and deletion of Payload collections. This is for developing ideas that help Developers with collection tasks.\n /\n collections?: {\n /\n Set the directory path to the collections directory. This can be a directory outside of your default directory, or another Payload project.\n /\n collectionsDirPath: string\n /\n Enable the collection MCP tools. This allows Admins to enable or disable the Collection modification capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Config MCP tools allow for the modification of a Payload Config. This is for developing ideas that help Developers with config tasks.\n /\n config?: {\n /\n Set the directory path to the config directory. This can be a directory outside of your default directory, or another Payload project.\n /\n configFilePath: string\n /\n Enable the config MCP tools. This allows Admins to enable or disable the Payload Config modification capabilities.\n * @default false\n /\n enabled: boolean\n }\n /\n Experimental -- Jobs MCP tools allow for the modification of Payload jobs. This is for developing ideas that help Developers with job tasks.\n /\n jobs?: {\n /\n Enable the jobs MCP tools. This allows Admins to enable or disable the Job modification capabilities.\n * @default false\n /\n enabled: boolean\n /\n Set the directory path to the jobs directory. This can be a directory outside of your default directory, or another Payload project.\n /\n jobsDirPath: string\n }\n }\n }\n /\n Set the globals that should be available as resources via MCP.\n * Globals are singleton configuration objects (e.g., site settings, navigation).\n * Note: Globals only support find and update operations.\n /\n globals?: Partial<\n Record<\n GlobalSlug,\n {\n /\n Set the description of the global. This is used by MCP clients to determine when to use the global as a resource.\n /\n description?: string\n /\n Set the enabled capabilities of the global. Admins can then allow or disallow the use of the capability by MCP clients.\n * Note: Globals only support find and update operations as they are singletons.\n /\n enabled:\n \| {\n find?: boolean\n update?: boolean\n }\n \| boolean\n\n /\n Override the response generated by the MCP client. This allows you to modify the response that is sent to the MCP client. This is useful for adding additional data to the response, data normalization, or verifying data.\n /\n overrideResponse?: (\n response: {\n content: Array<{\n text: string\n type: string\n }>\n },\n doc: Record<string, unknown>,\n req: PayloadRequest,\n ) => {\n content: Array<{\n text: string\n type: string\n }>\n }\n }\n >\n >\n /\n MCP Server options.\n /\n mcp?: {\n handlerOptions?: MCPHandlerOptions\n /\n Add custom MCP Prompts.\n /\n prompts?: {\n /\n Set the args schema of the prompt. This is the args schema that will be passed to the prompt. This is used by MCP clients to determine the arguments that will be passed to the prompt.\n /\n argsSchema: z.ZodRawShape\n /\n Set the description of the prompt. This is used by MCP clients to determine when to use the prompt.\n /\n description: string\n /\n Set the handler of the prompt. This is the function that will be called when the prompt is used.\n /\n handler: (\n args: Record<string, unknown>,\n req: PayloadRequest,\n _extra: unknown,\n ) =>\n \| {\n messages: Array<{\n content: {\n text: string\n type: 'text'\n }\n role: 'assistant' \| 'user'\n }>\n }\n \| Promise<{\n messages: Array<{\n content: {\n text: string\n type: 'text'\n }\n role: 'assistant' \| 'user'\n }>\n }>\n /\n Set the function name of the prompt.\n /\n name: string\n /\n Set the title of the prompt. LLMs will interperate the title to determine when to use the prompt.\n /\n title: string\n }[]\n\n /\n Add custom MCP Resource.\n /\n resources?: {\n /\n Set the description of the resource. This is used by MCP clients to determine when to use the resource.\n * example: 'Data is a resource that contains special data.'\n /\n description: string\n /\n Set the handler of the resource. This is the function that will be called when the resource is used.\n * The handler can have either 3 arguments (when no args are passed) or 4 arguments (when args are passed).\n /\n handler: (...args: any[]) =>\n \| {\n contents: Array<{\n text: string\n uri: string\n }>\n }\n \| Promise<{\n contents: Array<{\n text: string\n uri: string\n }>\n }>\n /\n Set the mime type of the resource.\n * example: 'text/plain'\n /\n mimeType: string\n /\n Set the function name of the resource.\n * example: 'data'\n /\n name: string\n /\n Set the title of the resource. LLMs will interperate the title to determine when to use the resource.\n * example: 'Data'\n /\n title: string\n /\n Set the uri of the resource.\n * example: 'data://app'\n /\n uri: ResourceTemplate \| string\n }[]\n serverOptions?: MCPServerOptions\n /\n Add custom MCP Tools.\n /\n tools?: {\n /\n Set the description of the tool. This is used by MCP clients to determine when to use the tool.\n /\n description: string\n /\n Set the handler of the tool. This is the function that will be called when the tool is used.\n /\n handler: (\n args: Record<string, unknown>,\n req: PayloadRequest,\n _extra: unknown,\n ) =>\n \| {\n content: Array<{\n text: string\n type: 'text'\n }>\n role?: string\n }\n \| Promise<{\n content: Array<{\n text: string\n type: 'text'\n }>\n role?: string\n }>\n /\n Set the name of the tool. This is the name that will be used to identify the tool. LLMs will interperate the name to determine when to use the tool.\n /\n name: string\n /\n Set the parameters of the tool. This is the parameters that will be passed to the tool.\n /\n parameters: z.ZodRawShape\n }[]\n }\n\n /\n Override the API key collection.\n * This allows you to add fields to the API key collection or modify the collection in any way you want.\n * @param collection - The API key collection.\n * @returns The modified API key collection.\n /\n overrideApiKeyCollection?: (collection: CollectionConfig) => CollectionConfig\n\n /\n Override the authentication method.\n * This allows you to use a custom authentication method instead of the default API key authentication.\n * @param req - The request object.\n * @returns The MCP access settings.\n /\n overrideAuth?: (\n req: PayloadRequest,\n getDefaultMcpAccessSettings: (overrideApiKey?: null \| string) => Promise<MCPAccessSettings>,\n ) => MCPAccessSettings \| Promise<MCPAccessSettings>\n\n /\n Set the users collection that API keys should be associated with.\n /\n userCollection?: CollectionSlug\n}\n\n/\n MCP Handler options.\n /\nexport type MCPHandlerOptions = {\n /\n Set the base path of the MCP handler. This is the path that will be used to access the MCP handler.\n * @default /api\n /\n basePath?: string\n /\n If true, disables the SSE endpoint. Only Streamable HTTP will be available.\n * @default true\n /\n disableSse?: boolean\n /\n Set the maximum duration of the MCP handler. This is the maximum duration that the MCP handler will run for.\n * @default 60\n /\n maxDuration?: number\n /\n Callback function that receives MCP events.\n * This can be used to track analytics, debug issues, or implement custom behaviors.\n /\n onEvent?: (event: unknown) => void\n /\n Set the Redis URL for the MCP handler. This is the URL that will be used to access the Redis server.\n * @default process.env.REDIS_URL\n /\n redisUrl?: string\n /\n Set verbose logging.\n * @default false\n /\n verboseLogs?: boolean\n}\n\n/\n MCP Server options.\n /\nexport type MCPServerOptions = {\n /\n Set the server info of the MCP server.\n /\n serverInfo?: {\n /\n Set the name of the MCP server.\n * @default 'Payload MCP Server'\n /\n name: string\n /\n Set the version of the MCP server.\n * @default '1.0.0'\n */\n version: string\n }\n}\n\nexport type MCPAccessSettings = {\n auth?: {\n auth?: boolean\n forgotPassword?: boolean\n login?: boolean\n resetPassword?: boolean\n unlock?: boolean\n verify?: boolean\n }\n collections?: {\n create?: boolean\n delete?: boolean\n find?: boolean\n update?: boolean\n }\n config?: {\n find?: boolean\n update?: boolean\n }\n custom?: Record<string, boolean>\n globals?: {\n find?: boolean\n update?: boolean\n }\n jobs?: {\n create?: boolean\n run?: boolean\n update?: boolean\n }\n 'payload-mcp-prompt'?: Record<string, boolean>\n 'payload-mcp-resource'?: Record<string, boolean>\n 'payload-mcp-tool'?: Record<string, boolean>\n user: TypedUser\n} & Record<string, unknown>\n\nexport type EntityConfig = PluginMCPServerConfig['collections'] \| PluginMCPServerConfig['globals']\n\nexport type FieldDefinition = {\n description?: string\n name: string\n options?: { label: string; value: string }[]\n position?: 'main' \| 'sidebar'\n required?: boolean\n type: string\n}\n\nexport type FieldModification = {\n changes: {\n description?: string\n options?: { label: string; value: string }[]\n position?: 'main' \| 'sidebar'\n required?: boolean\n type?: string\n }\n fieldName: string\n}\n\nexport type CollectionConfigUpdates = {\n access?: {\n create?: string\n delete?: string\n read?: string\n update?: string\n }\n description?: string\n slug?: string\n timestamps?: boolean\n versioning?: boolean\n}\n\nexport type AdminConfig = {\n avatar?: string\n css?: string\n dateFormat?: string\n inactivityRoute?: string\n livePreview?: {\n breakpoints?: Array<{\n height: number\n label: string\n name: string\n width: number\n }>\n }\n logoutRoute?: string\n meta?: {\n favicon?: string\n ogImage?: string\n titleSuffix?: string\n }\n user?: string\n}\n\nexport type DatabaseConfig = {\n connectOptions?: string\n type?: 'mongodb' \| 'postgres'\n url?: string\n}\n\nexport type PluginUpdates = {\n add?: string[]\n remove?: string[]\n}\n\nexport type GeneralConfig = {\n cookiePrefix?: string\n cors?: string\n csrf?: string\n graphQL?: {\n disable?: boolean\n schemaOutputFile?: string\n }\n rateLimit?: {\n max?: number\n skip?: string\n window?: number\n }\n secret?: string\n serverURL?: string\n typescript?: {\n declare?: boolean\n outputFile?: string\n }\n}\n\nexport interface SchemaField {\n description?: string\n name: string\n options?: string[]\n required?: boolean\n type: string\n}\n\nexport interface TaskSequenceItem {\n description?: string\n retries?: number\n taskId: string\n taskSlug: string\n timeout?: number\n}\n\nexport interface JobConfigUpdate {\n description?: string\n queue?: string\n retries?: number\n timeout?: number\n}\n"],"names":[],"mappings":"AAohBA,WAKC"}

package/dist/utils/schemaConversion/convertCollectionSchemaToZod.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"convertCollectionSchemaToZod.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaConversion/convertCollectionSchemaToZod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAU9C,eAAO,MAAM,4BAA4B,WAAY,WAAW,QA8B/D,CAAA"}

package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js ADDED Viewed

@@ -0,0 +1,34 @@
+import { jsonSchemaToZod } from 'json-schema-to-zod';
+import * as ts from 'typescript';
+import { z } from 'zod';
+import { sanitizeJsonSchema } from './sanitizeJsonSchema.js';
+import { simplifyRelationshipFields } from './simplifyRelationshipFields.js';
+import { transformPointFieldsForMCP } from './transformPointFields.js';
+export const convertCollectionSchemaToZod = (schema)=>{
+    // Clone to avoid mutating the original schema (used elsewhere for tool listing)
+    const schemaClone = JSON.parse(JSON.stringify(schema));
+    const sanitized = sanitizeJsonSchema(schemaClone);
+    const pointTransformed = transformPointFieldsForMCP(sanitized);
+    const simplifiedSchema = simplifyRelationshipFields(pointTransformed);
+    const zodSchemaAsString = jsonSchemaToZod(simplifiedSchema);
+    // Transpile TypeScript to JavaScript
+    const transpileResult = ts.transpileModule(zodSchemaAsString, {
+        compilerOptions: {
+            module: ts.ModuleKind.CommonJS,
+            removeComments: true,
+            strict: false,
+            target: ts.ScriptTarget.ES2018
+        }
+    });
+    /**
+   * This Function evaluation is safe because:
+   * 1. The input schema comes from Payload's collection configuration, which is controlled by the application developer
+   * 2. The jsonSchemaToZod library converts JSON Schema to Zod schema definitions, producing only type validation code
+   * 3. The transpiled output contains only Zod schema definitions (z.string(), z.number(), etc.) - no executable logic
+   * 4. The resulting Zod schema is used only for parameter validation in MCP tools, not for data processing
+   * 5. No user input or external data is involved in the schema generation process
+   */ // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    return new Function('z', `return ${transpileResult.outputText}`)(z);
+};
+//# sourceMappingURL=convertCollectionSchemaToZod.js.map

package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../../src/utils/schemaConversion/convertCollectionSchemaToZod.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { jsonSchemaToZod } from 'json-schema-to-zod'\nimport * as ts from 'typescript'\nimport { z } from 'zod'\n\nimport { sanitizeJsonSchema } from './sanitizeJsonSchema.js'\nimport { simplifyRelationshipFields } from './simplifyRelationshipFields.js'\nimport { transformPointFieldsForMCP } from './transformPointFields.js'\n\nexport const convertCollectionSchemaToZod = (schema: JSONSchema4) => {\n // Clone to avoid mutating the original schema (used elsewhere for tool listing)\n const schemaClone = JSON.parse(JSON.stringify(schema)) as JSONSchema4\n\n const sanitized = sanitizeJsonSchema(schemaClone)\n const pointTransformed = transformPointFieldsForMCP(sanitized)\n const simplifiedSchema = simplifyRelationshipFields(pointTransformed)\n\n const zodSchemaAsString = jsonSchemaToZod(simplifiedSchema)\n\n // Transpile TypeScript to JavaScript\n const transpileResult = ts.transpileModule(zodSchemaAsString, {\n compilerOptions: {\n module: ts.ModuleKind.CommonJS,\n removeComments: true,\n strict: false,\n target: ts.ScriptTarget.ES2018,\n },\n })\n\n /**\n * This Function evaluation is safe because:\n * 1. The input schema comes from Payload's collection configuration, which is controlled by the application developer\n * 2. The jsonSchemaToZod library converts JSON Schema to Zod schema definitions, producing only type validation code\n * 3. The transpiled output contains only Zod schema definitions (z.string(), z.number(), etc.) - no executable logic\n * 4. The resulting Zod schema is used only for parameter validation in MCP tools, not for data processing\n * 5. No user input or external data is involved in the schema generation process\n */\n // eslint-disable-next-line @typescript-eslint/no-implied-eval\n return new Function('z', `return ${transpileResult.outputText}`)(z)\n}\n"],"names":["jsonSchemaToZod","ts","z","sanitizeJsonSchema","simplifyRelationshipFields","transformPointFieldsForMCP","convertCollectionSchemaToZod","schema","schemaClone","JSON","parse","stringify","sanitized","pointTransformed","simplifiedSchema","zodSchemaAsString","transpileResult","transpileModule","compilerOptions","module","ModuleKind","CommonJS","removeComments","strict","target","ScriptTarget","ES2018","Function","outputText"],"mappings":"AAEA,SAASA,eAAe,QAAQ,qBAAoB;AACpD,YAAYC,QAAQ,aAAY;AAChC,SAASC,CAAC,QAAQ,MAAK;AAEvB,SAASC,kBAAkB,QAAQ,0BAAyB;AAC5D,SAASC,0BAA0B,QAAQ,kCAAiC;AAC5E,SAASC,0BAA0B,QAAQ,4BAA2B;AAEtE,OAAO,MAAMC,+BAA+B,CAACC;IAC3C,gFAAgF;IAChF,MAAMC,cAAcC,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACJ;IAE9C,MAAMK,YAAYT,mBAAmBK;IACrC,MAAMK,mBAAmBR,2BAA2BO;IACpD,MAAME,mBAAmBV,2BAA2BS;IAEpD,MAAME,oBAAoBf,gBAAgBc;IAE1C,qCAAqC;IACrC,MAAME,kBAAkBf,GAAGgB,eAAe,CAACF,mBAAmB;QAC5DG,iBAAiB;YACfC,QAAQlB,GAAGmB,UAAU,CAACC,QAAQ;YAC9BC,gBAAgB;YAChBC,QAAQ;YACRC,QAAQvB,GAAGwB,YAAY,CAACC,MAAM;QAChC;IACF;IAEA;;;;;;;GAOC,GACD,8DAA8D;IAC9D,OAAO,IAAIC,SAAS,KAAK,CAAC,OAAO,EAAEX,gBAAgBY,UAAU,EAAE,EAAE1B;AACnE,EAAC"}

package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import type { JSONSchema4 } from 'json-schema';
+/**
+ * Removes internal Payload properties (id, createdAt, updatedAt) from a
+ * JSON Schema so they don't appear in the generated Zod validation schema.
+ * Also strips `id` from the `required` array when present.
+ */
+export declare function sanitizeJsonSchema(schema: JSONSchema4): JSONSchema4;
+//# sourceMappingURL=sanitizeJsonSchema.d.ts.map

package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"sanitizeJsonSchema.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaConversion/sanitizeJsonSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAanE"}

package/dist/utils/schemaConversion/sanitizeJsonSchema.js ADDED Viewed

@@ -0,0 +1,18 @@
+/**
+ * Removes internal Payload properties (id, createdAt, updatedAt) from a
+ * JSON Schema so they don't appear in the generated Zod validation schema.
+ * Also strips `id` from the `required` array when present.
+ */ export function sanitizeJsonSchema(schema) {
+    delete schema?.properties?.id;
+    delete schema?.properties?.createdAt;
+    delete schema?.properties?.updatedAt;
+    if (Array.isArray(schema.required)) {
+        schema.required = schema.required.filter((field)=>field !== 'id');
+        if (schema.required.length === 0) {
+            delete schema.required;
+        }
+    }
+    return schema;
+}
+//# sourceMappingURL=sanitizeJsonSchema.js.map

package/dist/utils/schemaConversion/sanitizeJsonSchema.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../../src/utils/schemaConversion/sanitizeJsonSchema.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\n/**\n * Removes internal Payload properties (id, createdAt, updatedAt) from a\n * JSON Schema so they don't appear in the generated Zod validation schema.\n * Also strips `id` from the `required` array when present.\n */\nexport function sanitizeJsonSchema(schema: JSONSchema4): JSONSchema4 {\n delete schema?.properties?.id\n delete schema?.properties?.createdAt\n delete schema?.properties?.updatedAt\n\n if (Array.isArray(schema.required)) {\n schema.required = schema.required.filter((field) => field !== 'id')\n if (schema.required.length === 0) {\n delete schema.required\n }\n }\n\n return schema\n}\n"],"names":["sanitizeJsonSchema","schema","properties","id","createdAt","updatedAt","Array","isArray","required","filter","field","length"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,SAASA,mBAAmBC,MAAmB;IACpD,OAAOA,QAAQC,YAAYC;IAC3B,OAAOF,QAAQC,YAAYE;IAC3B,OAAOH,QAAQC,YAAYG;IAE3B,IAAIC,MAAMC,OAAO,CAACN,OAAOO,QAAQ,GAAG;QAClCP,OAAOO,QAAQ,GAAGP,OAAOO,QAAQ,CAACC,MAAM,CAAC,CAACC,QAAUA,UAAU;QAC9D,IAAIT,OAAOO,QAAQ,CAACG,MAAM,KAAK,GAAG;YAChC,OAAOV,OAAOO,QAAQ;QACxB;IACF;IAEA,OAAOP;AACT"}

package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import type { JSONSchema4 } from 'json-schema';
+/**
+ * Recursively processes JSON schema properties to simplify relationship fields
+ * and convert `oneOf` constructs into MCP-friendly schemas.
+ *
+ * For create/update validation we only need to accept IDs (string/number),
+ * not populated objects. `$ref` options pointing to full entity definitions
+ * are removed entirely from `oneOf` unions. When a single option remains the
+ * `oneOf` is unwrapped; otherwise it is converted to `anyOf`.
+ *
+ * This matters because `json-schema-to-zod` converts `oneOf` into a strict
+ * `z.any().superRefine(...)` validator whose base type is `z.any()`, causing
+ * `zodToJsonSchema` to emit `{}` and losing all type information in the MCP
+ * tool input schema. `anyOf` instead produces a clean `z.union([...])`.
+ *
+ * NOTE: This function must operate on a cloned schema to avoid mutating
+ * the original JSON schema used for tool listing.
+ */
+export declare function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4;
+//# sourceMappingURL=simplifyRelationshipFields.d.ts.map

package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"simplifyRelationshipFields.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaConversion/simplifyRelationshipFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CA6C3E"}

package/dist/utils/schemaConversion/simplifyRelationshipFields.js ADDED Viewed

@@ -0,0 +1,53 @@
+/**
+ * Recursively processes JSON schema properties to simplify relationship fields
+ * and convert `oneOf` constructs into MCP-friendly schemas.
+ *
+ * For create/update validation we only need to accept IDs (string/number),
+ * not populated objects. `$ref` options pointing to full entity definitions
+ * are removed entirely from `oneOf` unions. When a single option remains the
+ * `oneOf` is unwrapped; otherwise it is converted to `anyOf`.
+ *
+ * This matters because `json-schema-to-zod` converts `oneOf` into a strict
+ * `z.any().superRefine(...)` validator whose base type is `z.any()`, causing
+ * `zodToJsonSchema` to emit `{}` and losing all type information in the MCP
+ * tool input schema. `anyOf` instead produces a clean `z.union([...])`.
+ *
+ * NOTE: This function must operate on a cloned schema to avoid mutating
+ * the original JSON schema used for tool listing.
+ */ export function simplifyRelationshipFields(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return schema;
+    }
+    const processed = {
+        ...schema
+    };
+    if (Array.isArray(processed.oneOf)) {
+        const hasRef = processed.oneOf.some((option)=>option && typeof option === 'object' && '$ref' in option);
+        if (hasRef) {
+            const nonRefOptions = processed.oneOf.filter((option)=>!(option && typeof option === 'object' && '$ref' in option)).map((option)=>simplifyRelationshipFields(option));
+            if (nonRefOptions.length === 1) {
+                const single = nonRefOptions[0];
+                delete processed.oneOf;
+                Object.assign(processed, single);
+            } else if (nonRefOptions.length > 1) {
+                delete processed.oneOf;
+                processed.anyOf = nonRefOptions;
+            }
+        } else {
+            processed.anyOf = processed.oneOf.map((option)=>simplifyRelationshipFields(option));
+            delete processed.oneOf;
+        }
+    }
+    if (processed.properties && typeof processed.properties === 'object') {
+        processed.properties = Object.fromEntries(Object.entries(processed.properties).map(([key, value])=>[
+                key,
+                simplifyRelationshipFields(value)
+            ]));
+    }
+    if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {
+        processed.items = simplifyRelationshipFields(processed.items);
+    }
+    return processed;
+}
+//# sourceMappingURL=simplifyRelationshipFields.js.map

package/dist/utils/schemaConversion/simplifyRelationshipFields.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../../src/utils/schemaConversion/simplifyRelationshipFields.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\n/**\n * Recursively processes JSON schema properties to simplify relationship fields\n * and convert `oneOf` constructs into MCP-friendly schemas.\n *\n * For create/update validation we only need to accept IDs (string/number),\n * not populated objects. `$ref` options pointing to full entity definitions\n * are removed entirely from `oneOf` unions. When a single option remains the\n * `oneOf` is unwrapped; otherwise it is converted to `anyOf`.\n *\n * This matters because `json-schema-to-zod` converts `oneOf` into a strict\n * `z.any().superRefine(...)` validator whose base type is `z.any()`, causing\n * `zodToJsonSchema` to emit `{}` and losing all type information in the MCP\n * tool input schema. `anyOf` instead produces a clean `z.union([...])`.\n *\n * NOTE: This function must operate on a cloned schema to avoid mutating\n * the original JSON schema used for tool listing.\n */\nexport function simplifyRelationshipFields(schema: JSONSchema4): JSONSchema4 {\n if (!schema || typeof schema !== 'object') {\n return schema\n }\n\n const processed = { ...schema }\n\n if (Array.isArray(processed.oneOf)) {\n const hasRef = processed.oneOf.some(\n (option) => option && typeof option === 'object' && '$ref' in option,\n )\n\n if (hasRef) {\n const nonRefOptions = processed.oneOf\n .filter((option) => !(option && typeof option === 'object' && '$ref' in option))\n .map((option) => simplifyRelationshipFields(option))\n\n if (nonRefOptions.length === 1) {\n const single = nonRefOptions[0]!\n delete processed.oneOf\n Object.assign(processed, single)\n } else if (nonRefOptions.length > 1) {\n delete processed.oneOf\n processed.anyOf = nonRefOptions\n }\n } else {\n processed.anyOf = processed.oneOf.map((option) => simplifyRelationshipFields(option))\n delete processed.oneOf\n }\n }\n\n if (processed.properties && typeof processed.properties === 'object') {\n processed.properties = Object.fromEntries(\n Object.entries(processed.properties).map(([key, value]) => [\n key,\n simplifyRelationshipFields(value),\n ]),\n )\n }\n\n if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {\n processed.items = simplifyRelationshipFields(processed.items)\n }\n\n return processed\n}\n"],"names":["simplifyRelationshipFields","schema","processed","Array","isArray","oneOf","hasRef","some","option","nonRefOptions","filter","map","length","single","Object","assign","anyOf","properties","fromEntries","entries","key","value","items"],"mappings":"AAEA;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASA,2BAA2BC,MAAmB;IAC5D,IAAI,CAACA,UAAU,OAAOA,WAAW,UAAU;QACzC,OAAOA;IACT;IAEA,MAAMC,YAAY;QAAE,GAAGD,MAAM;IAAC;IAE9B,IAAIE,MAAMC,OAAO,CAACF,UAAUG,KAAK,GAAG;QAClC,MAAMC,SAASJ,UAAUG,KAAK,CAACE,IAAI,CACjC,CAACC,SAAWA,UAAU,OAAOA,WAAW,YAAY,UAAUA;QAGhE,IAAIF,QAAQ;YACV,MAAMG,gBAAgBP,UAAUG,KAAK,CAClCK,MAAM,CAAC,CAACF,SAAW,CAAEA,CAAAA,UAAU,OAAOA,WAAW,YAAY,UAAUA,MAAK,GAC5EG,GAAG,CAAC,CAACH,SAAWR,2BAA2BQ;YAE9C,IAAIC,cAAcG,MAAM,KAAK,GAAG;gBAC9B,MAAMC,SAASJ,aAAa,CAAC,EAAE;gBAC/B,OAAOP,UAAUG,KAAK;gBACtBS,OAAOC,MAAM,CAACb,WAAWW;YAC3B,OAAO,IAAIJ,cAAcG,MAAM,GAAG,GAAG;gBACnC,OAAOV,UAAUG,KAAK;gBACtBH,UAAUc,KAAK,GAAGP;YACpB;QACF,OAAO;YACLP,UAAUc,KAAK,GAAGd,UAAUG,KAAK,CAACM,GAAG,CAAC,CAACH,SAAWR,2BAA2BQ;YAC7E,OAAON,UAAUG,KAAK;QACxB;IACF;IAEA,IAAIH,UAAUe,UAAU,IAAI,OAAOf,UAAUe,UAAU,KAAK,UAAU;QACpEf,UAAUe,UAAU,GAAGH,OAAOI,WAAW,CACvCJ,OAAOK,OAAO,CAACjB,UAAUe,UAAU,EAAEN,GAAG,CAAC,CAAC,CAACS,KAAKC,MAAM,GAAK;gBACzDD;gBACApB,2BAA2BqB;aAC5B;IAEL;IAEA,IAAInB,UAAUoB,KAAK,IAAI,OAAOpB,UAAUoB,KAAK,KAAK,YAAY,CAACnB,MAAMC,OAAO,CAACF,UAAUoB,KAAK,GAAG;QAC7FpB,UAAUoB,KAAK,GAAGtB,2BAA2BE,UAAUoB,KAAK;IAC9D;IAEA,OAAOpB;AACT"}

package/dist/utils/schemaConversion/transformPointFields.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"transformPointFields.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaConversion/transformPointFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAoD3E"}

package/dist/utils/schemaConversion/transformPointFields.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../../src/utils/schemaConversion/transformPointFields.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nexport function transformPointFieldsForMCP(schema: JSONSchema4): JSONSchema4 {\n if (!schema || typeof schema !== 'object') {\n return schema\n }\n\n const transformed = { ...schema }\n\n if (transformed.properties && typeof transformed.properties === 'object') {\n transformed.properties = Object.fromEntries(\n Object.entries(transformed.properties).map(([key, value]) => {\n const isArrayType =\n value.type === 'array' || (Array.isArray(value.type) && value.type.includes('array'))\n\n if (\n value &&\n typeof value === 'object' &&\n isArrayType &&\n Array.isArray(value.items) &&\n value.items.length === 2 &&\n value.items.every((item: JSONSchema4) => item?.type === 'number')\n ) {\n // Transform to object format\n const isNullable = Array.isArray(value.type) && value.type.includes('null')\n\n return [\n key,\n {\n type: isNullable ? ['object', 'null'] : 'object',\n description: value.description || 'Geographic coordinates (longitude, latitude)',\n properties: {\n latitude: { type: 'number', description: 'Latitude coordinate' },\n longitude: { type: 'number', description: 'Longitude coordinate' },\n },\n required: ['longitude', 'latitude'],\n },\n ]\n }\n\n return [key, transformPointFieldsForMCP(value)]\n }),\n )\n }\n\n if (\n transformed.items &&\n typeof transformed.items === 'object' &&\n !Array.isArray(transformed.items)\n ) {\n transformed.items = transformPointFieldsForMCP(transformed.items)\n }\n\n return transformed\n}\n"],"names":["transformPointFieldsForMCP","schema","transformed","properties","Object","fromEntries","entries","map","key","value","isArrayType","type","Array","isArray","includes","items","length","every","item","isNullable","description","latitude","longitude","required"],"mappings":"AAEA,OAAO,SAASA,2BAA2BC,MAAmB;IAC5D,IAAI,CAACA,UAAU,OAAOA,WAAW,UAAU;QACzC,OAAOA;IACT;IAEA,MAAMC,cAAc;QAAE,GAAGD,MAAM;IAAC;IAEhC,IAAIC,YAAYC,UAAU,IAAI,OAAOD,YAAYC,UAAU,KAAK,UAAU;QACxED,YAAYC,UAAU,GAAGC,OAAOC,WAAW,CACzCD,OAAOE,OAAO,CAACJ,YAAYC,UAAU,EAAEI,GAAG,CAAC,CAAC,CAACC,KAAKC,MAAM;YACtD,MAAMC,cACJD,MAAME,IAAI,KAAK,WAAYC,MAAMC,OAAO,CAACJ,MAAME,IAAI,KAAKF,MAAME,IAAI,CAACG,QAAQ,CAAC;YAE9E,IACEL,SACA,OAAOA,UAAU,YACjBC,eACAE,MAAMC,OAAO,CAACJ,MAAMM,KAAK,KACzBN,MAAMM,KAAK,CAACC,MAAM,KAAK,KACvBP,MAAMM,KAAK,CAACE,KAAK,CAAC,CAACC,OAAsBA,MAAMP,SAAS,WACxD;gBACA,6BAA6B;gBAC7B,MAAMQ,aAAaP,MAAMC,OAAO,CAACJ,MAAME,IAAI,KAAKF,MAAME,IAAI,CAACG,QAAQ,CAAC;gBAEpE,OAAO;oBACLN;oBACA;wBACEG,MAAMQ,aAAa;4BAAC;4BAAU;yBAAO,GAAG;wBACxCC,aAAaX,MAAMW,WAAW,IAAI;wBAClCjB,YAAY;4BACVkB,UAAU;gCAAEV,MAAM;gCAAUS,aAAa;4BAAsB;4BAC/DE,WAAW;gCAAEX,MAAM;gCAAUS,aAAa;4BAAuB;wBACnE;wBACAG,UAAU;4BAAC;4BAAa;yBAAW;oBACrC;iBACD;YACH;YAEA,OAAO;gBAACf;gBAAKR,2BAA2BS;aAAO;QACjD;IAEJ;IAEA,IACEP,YAAYa,KAAK,IACjB,OAAOb,YAAYa,KAAK,KAAK,YAC7B,CAACH,MAAMC,OAAO,CAACX,YAAYa,KAAK,GAChC;QACAb,YAAYa,KAAK,GAAGf,2BAA2BE,YAAYa,KAAK;IAClE;IAEA,OAAOb;AACT"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/plugin-mcp",
-  "version": "3.77.0-canary.7",
+  "version": "3.77.0-internal-debug.98d2e4d",
   "description": "MCP (Model Context Protocol) capabilities with Payload",
   "keywords": [
     "plugin",
@@ -37,18 +37,18 @@
     "dist"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "~1.24.0",
+    "@modelcontextprotocol/sdk": "1.25.2",
     "@types/json-schema": "7.0.15",
-    "@vercel/mcp-adapter": "^1.0.0",
     "json-schema-to-zod": "2.6.1",
+    "mcp-handler": "^1.0.7",
     "zod": "^3.25.50"
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "3.28.0",
-    "payload": "3.77.0-canary.7"
+    "payload": "3.77.0-internal-debug.98d2e4d"
   },
   "peerDependencies": {
-    "payload": "3.77.0-canary.7"
+    "payload": "3.77.0-internal-debug.98d2e4d"
   },
   "homepage:": "https://payloadcms.com",
   "scripts": {

package/src/mcp/getMcpHandler.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import type { JSONSchema4 } from 'json-schema'
-import { createMcpHandler } from '@vercel/mcp-adapter'
+import { createMcpHandler } from 'mcp-handler'
 import { join } from 'path'
 import { APIError, configToJSONSchema, type PayloadRequest, type TypedUser } from 'payload'
@@ -260,10 +260,12 @@ export const getMCPHandler = (
             isToolEnabled,
             tool.name,
             () =>
-              server.tool(
+              server.registerTool(
                 tool.name,
-                tool.description,
-                tool.parameters,
+                {
+                  description: tool.description,
+                  inputSchema: tool.parameters,
+                },
                 payloadToolHandler(tool.handler),
               ),
             payload,
@@ -507,9 +509,10 @@ export const getMCPHandler = (
       },
       {
         basePath: MCPHandlerOptions.basePath || payload.config.routes?.api || '/api',
+        disableSse: MCPHandlerOptions.disableSse ?? true,
         maxDuration: MCPHandlerOptions.maxDuration || 60,
-        // INFO: Disabled until developer clarity is reached for server side streaming and we have an auth pattern for all SSE patterns
-        // redisUrl: MCPHandlerOptions.redisUrl || process.env.REDIS_URL,
+        onEvent: MCPHandlerOptions.onEvent,
+        redisUrl: MCPHandlerOptions.redisUrl,
         verboseLogs: useVerboseLogs,
       },
     )

package/src/mcp/tools/auth/auth.ts CHANGED Viewed

@@ -58,10 +58,12 @@ export const authTool = (server: McpServer, req: PayloadRequest, verboseLogs: bo
     }
   }
-  server.tool(
+  server.registerTool(
     'auth',
-    toolSchemas.auth.description,
-    toolSchemas.auth.parameters.shape,
+    {
+      description: toolSchemas.auth.description,
+      inputSchema: toolSchemas.auth.parameters.shape,
+    },
     async ({ headers }) => {
       return await tool(headers)
     },

package/src/mcp/tools/auth/forgotPassword.ts CHANGED Viewed

@@ -57,10 +57,12 @@ export const forgotPasswordTool = (
     }
   }
-  server.tool(
+  server.registerTool(
     'forgotPassword',
-    toolSchemas.forgotPassword.description,
-    toolSchemas.forgotPassword.parameters.shape,
+    {
+      description: toolSchemas.forgotPassword.description,
+      inputSchema: toolSchemas.forgotPassword.parameters.shape,
+    },
     async ({ collection, disableEmail, email }) => {
       return await tool(collection, email, disableEmail)
     },

package/src/mcp/tools/auth/login.ts CHANGED Viewed

@@ -59,10 +59,12 @@ export const loginTool = (server: McpServer, req: PayloadRequest, verboseLogs: b
     }
   }
-  server.tool(
+  server.registerTool(
     'login',
-    toolSchemas.login.description,
-    toolSchemas.login.parameters.shape,
+    {
+      description: toolSchemas.login.description,
+      inputSchema: toolSchemas.login.parameters.shape,
+    },
     async ({ collection, depth, email, overrideAccess, password, showHiddenFields }) => {
       return await tool(collection, email, password, depth, overrideAccess, showHiddenFields)
     },

package/src/mcp/tools/auth/resetPassword.ts CHANGED Viewed

@@ -48,10 +48,12 @@ export const resetPasswordTool = (server: McpServer, req: PayloadRequest, verbos
     }
   }
-  server.tool(
+  server.registerTool(
     'resetPassword',
-    toolSchemas.resetPassword.description,
-    toolSchemas.resetPassword.parameters.shape,
+    {
+      description: toolSchemas.resetPassword.description,
+      inputSchema: toolSchemas.resetPassword.parameters.shape,
+    },
     async ({ collection, password, token }) => {
       return await tool(collection, token, password)
     },

package/src/mcp/tools/auth/unlock.ts CHANGED Viewed

@@ -51,10 +51,12 @@ export const unlockTool = (server: McpServer, req: PayloadRequest, verboseLogs:
     }
   }
-  server.tool(
+  server.registerTool(
     'unlock',
-    toolSchemas.unlock.description,
-    toolSchemas.unlock.parameters.shape,
+    {
+      description: toolSchemas.unlock.description,
+      inputSchema: toolSchemas.unlock.parameters.shape,
+    },
     async ({ collection, email }) => {
       return await tool(collection, email)
     },

package/src/mcp/tools/auth/verify.ts CHANGED Viewed

@@ -44,10 +44,12 @@ export const verifyTool = (server: McpServer, req: PayloadRequest, verboseLogs:
     }
   }
-  server.tool(
+  server.registerTool(
     'verify',
-    toolSchemas.verify.description,
-    toolSchemas.verify.parameters.shape,
+    {
+      description: toolSchemas.verify.description,
+      inputSchema: toolSchemas.verify.parameters.shape,
+    },
     async ({ collection, token }) => {
       return await tool(collection, token)
     },