@payloadcms/plugin-mcp 0.0.1-alpha.0

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018-2024 Payload CMS, Inc. <info@payloadcms.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# Payload MCP Plugin
+
+A plugin for [Payload](https://github.com/payloadcms/payload). This plugin adds [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) capabilities.
+
+- [Source code](https://github.com/payloadcms/payload/tree/main/packages/plugin-mcp)
+- [Documentation](https://payloadcms.com/docs/plugins/mcp)
+- [Documentation source](https://github.com/payloadcms/payload/tree/main/docs/plugins/mcp.mdx)

package/dist/collections/createApiKeysCollection.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionConfig } from 'payload';
+import type { PluginMCPServerConfig } from '../types.js';
+export declare const createAPIKeysCollection: (collections: PluginMCPServerConfig["collections"], customTools?: Array<{
+    description: string;
+    name: string;
+}>, experimentalTools?: NonNullable<PluginMCPServerConfig["experimental"]>["tools"]) => CollectionConfig;
+//# sourceMappingURL=createApiKeysCollection.d.ts.map

package/dist/collections/createApiKeysCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApiKeysCollection.d.ts","sourceRoot":"","sources":["../../src/collections/createApiKeysCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAgHxD,eAAO,MAAM,uBAAuB,gBACrB,qBAAqB,CAAC,aAAa,CAAC,gBACpC,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,sBACtC,WAAW,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,KAC7E,gBAkRF,CAAA"}

package/dist/collections/createApiKeysCollection.js

@@ -0,0 +1,315 @@
+import { toCamelCase } from '../utils/camelCase.js';
+const addEnabledCollectionTools = (collections)=>{
+    const enabledCollectionSlugs = Object.keys(collections || {}).filter((collection)=>{
+        const fullyEnabled = typeof collections?.[collection]?.enabled === 'boolean' && collections?.[collection]?.enabled;
+        if (fullyEnabled) {
+            return true;
+        }
+        const partiallyEnabled = typeof collections?.[collection]?.enabled !== 'boolean' && (typeof collections?.[collection]?.enabled?.find === 'boolean' && collections?.[collection]?.enabled?.find === true || typeof collections?.[collection]?.enabled?.create === 'boolean' && collections?.[collection]?.enabled?.create === true || typeof collections?.[collection]?.enabled?.update === 'boolean' && collections?.[collection]?.enabled?.update === true || typeof collections?.[collection]?.enabled?.delete === 'boolean' && collections?.[collection]?.enabled?.delete === true);
+        if (partiallyEnabled) {
+            return true;
+        }
+    });
+    return enabledCollectionSlugs.map((enabledCollectionSlug)=>({
+            type: 'collapsible',
+            admin: {
+                position: 'sidebar'
+            },
+            fields: [
+                {
+                    name: `${toCamelCase(enabledCollectionSlug)}`,
+                    type: 'group',
+                    fields: [
+                        ...collections?.[enabledCollectionSlug]?.enabled === true || typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' && typeof collections?.[enabledCollectionSlug]?.enabled?.find === 'boolean' && collections?.[enabledCollectionSlug]?.enabled?.find === true ? [
+                            {
+                                name: `find`,
+                                type: 'checkbox',
+                                admin: {
+                                    description: `Allow clients to find ${enabledCollectionSlug}.`
+                                },
+                                defaultValue: false,
+                                label: 'Find'
+                            }
+                        ] : [],
+                        ...collections?.[enabledCollectionSlug]?.enabled === true || typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' && typeof collections?.[enabledCollectionSlug]?.enabled?.create === 'boolean' && collections?.[enabledCollectionSlug]?.enabled?.create === true ? [
+                            {
+                                name: `create`,
+                                type: 'checkbox',
+                                admin: {
+                                    description: `Allow clients to create ${enabledCollectionSlug}.`
+                                },
+                                defaultValue: false,
+                                label: 'Create'
+                            }
+                        ] : [],
+                        ...collections?.[enabledCollectionSlug]?.enabled === true || typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' && typeof collections?.[enabledCollectionSlug]?.enabled?.update === 'boolean' && collections?.[enabledCollectionSlug]?.enabled?.update === true ? [
+                            {
+                                name: `update`,
+                                type: 'checkbox',
+                                admin: {
+                                    description: `Allow clients to update ${enabledCollectionSlug}.`
+                                },
+                                defaultValue: false,
+                                label: 'Update'
+                            }
+                        ] : [],
+                        ...collections?.[enabledCollectionSlug]?.enabled === true || typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' && typeof collections?.[enabledCollectionSlug]?.enabled?.delete === 'boolean' && collections?.[enabledCollectionSlug]?.enabled?.delete === true ? [
+                            {
+                                name: `delete`,
+                                type: 'checkbox',
+                                admin: {
+                                    description: `Allow clients to delete ${enabledCollectionSlug}.`
+                                },
+                                defaultValue: false,
+                                label: 'Delete'
+                            }
+                        ] : []
+                    ]
+                }
+            ],
+            label: `${enabledCollectionSlug.charAt(0).toUpperCase() + toCamelCase(enabledCollectionSlug).slice(1)}`
+        }));
+};
+export const createAPIKeysCollection = (collections, customTools = [], experimentalTools = {})=>{
+    const customToolsFields = customTools.map((tool)=>{
+        const camelCasedName = toCamelCase(tool.name);
+        return {
+            name: camelCasedName,
+            type: 'checkbox',
+            admin: {
+                description: tool.description
+            },
+            defaultValue: true,
+            label: camelCasedName
+        };
+    });
+    return {
+        slug: 'payload-mcp-api-keys',
+        admin: {
+            group: 'MCP',
+            useAsTitle: 'label'
+        },
+        auth: {
+            disableLocalStrategy: true,
+            useAPIKey: true
+        },
+        fields: [
+            {
+                name: 'user',
+                type: 'relationship',
+                admin: {
+                    description: 'The user that the API key is associated with.'
+                },
+                relationTo: 'users',
+                required: true
+            },
+            {
+                name: 'label',
+                type: 'text',
+                admin: {
+                    description: 'A useful label for the API key.'
+                }
+            },
+            {
+                name: 'description',
+                type: 'text',
+                admin: {
+                    description: 'The purpose of the API key.'
+                }
+            },
+            ...addEnabledCollectionTools(collections),
+            ...customTools.length > 0 ? [
+                {
+                    type: 'collapsible',
+                    admin: {
+                        position: 'sidebar'
+                    },
+                    fields: [
+                        {
+                            name: 'custom',
+                            type: 'group',
+                            fields: customToolsFields
+                        }
+                    ],
+                    label: 'Custom Tools'
+                }
+            ] : [],
+            // Experimental Tools
+            ...process.env.NODE_ENV === 'development' && (experimentalTools?.collections?.enabled || experimentalTools?.jobs?.enabled || experimentalTools?.config?.enabled || experimentalTools?.auth?.enabled) ? [
+                {
+                    type: 'collapsible',
+                    admin: {
+                        position: 'sidebar'
+                    },
+                    fields: [
+                        ...experimentalTools?.collections?.enabled ? [
+                            {
+                                name: 'collections',
+                                type: 'group',
+                                fields: [
+                                    {
+                                        name: 'find',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to find and list Payload collections with optional content and document counts.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'create',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to create new Payload collections with specified fields and configuration.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'update',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to update existing Payload collections with new fields, modifications, or configuration changes.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'delete',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to delete Payload collections and optionally update the configuration.'
+                                        },
+                                        defaultValue: false
+                                    }
+                                ]
+                            }
+                        ] : [],
+                        ...experimentalTools?.jobs?.enabled ? [
+                            {
+                                name: 'jobs',
+                                type: 'group',
+                                fields: [
+                                    {
+                                        name: 'create',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to create new Payload jobs (tasks and workflows) with custom schemas and configuration.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'run',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to execute Payload jobs with custom input data and queue options.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'update',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to update existing Payload jobs with new schemas, configuration, or handler code.'
+                                        },
+                                        defaultValue: false
+                                    }
+                                ]
+                            }
+                        ] : [],
+                        ...experimentalTools?.config?.enabled ? [
+                            {
+                                name: 'config',
+                                type: 'group',
+                                fields: [
+                                    {
+                                        name: 'find',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to read and display a Payload configuration file.'
+                                        },
+                                        defaultValue: false
+                                    },
+                                    {
+                                        name: 'update',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to update a Payload configuration file with various modifications.'
+                                        },
+                                        defaultValue: false
+                                    }
+                                ]
+                            }
+                        ] : [],
+                        ...experimentalTools?.auth?.enabled ? [
+                            {
+                                name: 'auth',
+                                type: 'group',
+                                fields: [
+                                    {
+                                        name: 'auth',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to check authentication status for a user by setting custom headers. (e.g. {"Authorization": "Bearer <token>"})'
+                                        },
+                                        defaultValue: false,
+                                        label: 'Check Auth Status'
+                                    },
+                                    {
+                                        name: 'login',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to authenticate a user with email and password.'
+                                        },
+                                        defaultValue: false,
+                                        label: 'User Login'
+                                    },
+                                    {
+                                        name: 'verify',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to verify a user email with a verification token.'
+                                        },
+                                        defaultValue: false,
+                                        label: 'Email Verification'
+                                    },
+                                    {
+                                        name: 'resetPassword',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to reset a user password with a reset token.'
+                                        },
+                                        defaultValue: false,
+                                        label: 'Reset Password'
+                                    },
+                                    {
+                                        name: 'forgotPassword',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to send a password reset email to a user.'
+                                        },
+                                        defaultValue: false,
+                                        label: 'Forgot Password'
+                                    },
+                                    {
+                                        name: 'unlock',
+                                        type: 'checkbox',
+                                        admin: {
+                                            description: 'Allow LLMs to unlock a user account that has been locked due to failed login attempts.'
+                                        },
+                                        defaultValue: false,
+                                        label: 'Unlock Account'
+                                    }
+                                ]
+                            }
+                        ] : []
+                    ],
+                    label: 'Experimental Tools'
+                }
+            ] : []
+        ],
+        labels: {
+            plural: 'API Keys',
+            singular: 'API Key'
+        }
+    };
+};
+
+//# sourceMappingURL=createApiKeysCollection.js.map

package/dist/collections/createApiKeysCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/createApiKeysCollection.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nimport type { PluginMCPServerConfig } from '../types.js'\n\nimport { toCamelCase } from '../utils/camelCase.js'\n\nconst addEnabledCollectionTools = (collections: PluginMCPServerConfig['collections']) => {\n  const enabledCollectionSlugs = Object.keys(collections || {}).filter((collection) => {\n    const fullyEnabled =\n      typeof collections?.[collection]?.enabled === 'boolean' && collections?.[collection]?.enabled\n\n    if (fullyEnabled) {\n      return true\n    }\n\n    const partiallyEnabled =\n      typeof collections?.[collection]?.enabled !== 'boolean' &&\n      ((typeof collections?.[collection]?.enabled?.find === 'boolean' &&\n        collections?.[collection]?.enabled?.find === true) ||\n        (typeof collections?.[collection]?.enabled?.create === 'boolean' &&\n          collections?.[collection]?.enabled?.create === true) ||\n        (typeof collections?.[collection]?.enabled?.update === 'boolean' &&\n          collections?.[collection]?.enabled?.update === true) ||\n        (typeof collections?.[collection]?.enabled?.delete === 'boolean' &&\n          collections?.[collection]?.enabled?.delete === true))\n\n    if (partiallyEnabled) {\n      return true\n    }\n  })\n  return enabledCollectionSlugs.map((enabledCollectionSlug) => ({\n    type: 'collapsible' as const,\n    admin: {\n      position: 'sidebar' as const,\n    },\n    fields: [\n      {\n        name: `${toCamelCase(enabledCollectionSlug)}`,\n        type: 'group' as const,\n        fields: [\n          ...(collections?.[enabledCollectionSlug]?.enabled === true ||\n          (typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' &&\n            typeof collections?.[enabledCollectionSlug]?.enabled?.find === 'boolean' &&\n            collections?.[enabledCollectionSlug]?.enabled?.find === true)\n            ? [\n                {\n                  name: `find`,\n                  type: 'checkbox' as const,\n                  admin: {\n                    description: `Allow clients to find ${enabledCollectionSlug}.`,\n                  },\n                  defaultValue: false,\n                  label: 'Find',\n                },\n              ]\n            : []),\n\n          ...(collections?.[enabledCollectionSlug]?.enabled === true ||\n          (typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' &&\n            typeof collections?.[enabledCollectionSlug]?.enabled?.create === 'boolean' &&\n            collections?.[enabledCollectionSlug]?.enabled?.create === true)\n            ? [\n                {\n                  name: `create`,\n                  type: 'checkbox' as const,\n                  admin: {\n                    description: `Allow clients to create ${enabledCollectionSlug}.`,\n                  },\n                  defaultValue: false,\n                  label: 'Create',\n                },\n              ]\n            : []),\n\n          ...(collections?.[enabledCollectionSlug]?.enabled === true ||\n          (typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' &&\n            typeof collections?.[enabledCollectionSlug]?.enabled?.update === 'boolean' &&\n            collections?.[enabledCollectionSlug]?.enabled?.update === true)\n            ? [\n                {\n                  name: `update`,\n                  type: 'checkbox' as const,\n                  admin: {\n                    description: `Allow clients to update ${enabledCollectionSlug}.`,\n                  },\n                  defaultValue: false,\n                  label: 'Update',\n                },\n              ]\n            : []),\n\n          ...(collections?.[enabledCollectionSlug]?.enabled === true ||\n          (typeof collections?.[enabledCollectionSlug]?.enabled !== 'boolean' &&\n            typeof collections?.[enabledCollectionSlug]?.enabled?.delete === 'boolean' &&\n            collections?.[enabledCollectionSlug]?.enabled?.delete === true)\n            ? [\n                {\n                  name: `delete`,\n                  type: 'checkbox' as const,\n                  admin: {\n                    description: `Allow clients to delete ${enabledCollectionSlug}.`,\n                  },\n                  defaultValue: false,\n                  label: 'Delete',\n                },\n              ]\n            : []),\n        ],\n      },\n    ],\n    label: `${enabledCollectionSlug.charAt(0).toUpperCase() + toCamelCase(enabledCollectionSlug).slice(1)}`,\n  }))\n}\n\nexport const createAPIKeysCollection = (\n  collections: PluginMCPServerConfig['collections'],\n  customTools: Array<{ description: string; name: string }> = [],\n  experimentalTools: NonNullable<PluginMCPServerConfig['experimental']>['tools'] = {},\n): CollectionConfig => {\n  const customToolsFields = customTools.map((tool) => {\n    const camelCasedName = toCamelCase(tool.name)\n    return {\n      name: camelCasedName,\n      type: 'checkbox' as const,\n      admin: {\n        description: tool.description,\n      },\n      defaultValue: true,\n      label: camelCasedName,\n    }\n  })\n\n  return {\n    slug: 'payload-mcp-api-keys',\n    admin: {\n      group: 'MCP',\n      useAsTitle: 'label',\n    },\n    auth: {\n      disableLocalStrategy: true,\n      useAPIKey: true,\n    },\n    fields: [\n      {\n        name: 'user',\n        type: 'relationship',\n        admin: {\n          description: 'The user that the API key is associated with.',\n        },\n        relationTo: 'users',\n        required: true,\n      },\n      {\n        name: 'label',\n        type: 'text',\n        admin: {\n          description: 'A useful label for the API key.',\n        },\n      },\n      {\n        name: 'description',\n        type: 'text',\n        admin: {\n          description: 'The purpose of the API key.',\n        },\n      },\n\n      ...addEnabledCollectionTools(collections),\n\n      ...(customTools.length > 0\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                position: 'sidebar' as const,\n              },\n              fields: [\n                {\n                  name: 'custom',\n                  type: 'group' as const,\n                  fields: customToolsFields,\n                },\n              ],\n              label: 'Custom Tools',\n            },\n          ]\n        : []),\n\n      // Experimental Tools\n      ...(process.env.NODE_ENV === 'development' &&\n      (experimentalTools?.collections?.enabled ||\n        experimentalTools?.jobs?.enabled ||\n        experimentalTools?.config?.enabled ||\n        experimentalTools?.auth?.enabled)\n        ? [\n            {\n              type: 'collapsible' as const,\n              admin: {\n                position: 'sidebar' as const,\n              },\n              fields: [\n                ...(experimentalTools?.collections?.enabled\n                  ? [\n                      {\n                        name: 'collections',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'find',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to find and list Payload collections with optional content and document counts.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'create',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to create new Payload collections with specified fields and configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update existing Payload collections with new fields, modifications, or configuration changes.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'delete',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to delete Payload collections and optionally update the configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.jobs?.enabled\n                  ? [\n                      {\n                        name: 'jobs',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'create',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to create new Payload jobs (tasks and workflows) with custom schemas and configuration.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'run',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to execute Payload jobs with custom input data and queue options.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update existing Payload jobs with new schemas, configuration, or handler code.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.config?.enabled\n                  ? [\n                      {\n                        name: 'config',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'find',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to read and display a Payload configuration file.',\n                            },\n                            defaultValue: false,\n                          },\n                          {\n                            name: 'update',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to update a Payload configuration file with various modifications.',\n                            },\n                            defaultValue: false,\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n                ...(experimentalTools?.auth?.enabled\n                  ? [\n                      {\n                        name: 'auth',\n                        type: 'group' as const,\n                        fields: [\n                          {\n                            name: 'auth',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to check authentication status for a user by setting custom headers. (e.g. {\"Authorization\": \"Bearer <token>\"})',\n                            },\n                            defaultValue: false,\n                            label: 'Check Auth Status',\n                          },\n                          {\n                            name: 'login',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to authenticate a user with email and password.',\n                            },\n                            defaultValue: false,\n                            label: 'User Login',\n                          },\n                          {\n                            name: 'verify',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to verify a user email with a verification token.',\n                            },\n                            defaultValue: false,\n                            label: 'Email Verification',\n                          },\n                          {\n                            name: 'resetPassword',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to reset a user password with a reset token.',\n                            },\n                            defaultValue: false,\n                            label: 'Reset Password',\n                          },\n                          {\n                            name: 'forgotPassword',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description: 'Allow LLMs to send a password reset email to a user.',\n                            },\n                            defaultValue: false,\n                            label: 'Forgot Password',\n                          },\n                          {\n                            name: 'unlock',\n                            type: 'checkbox' as const,\n                            admin: {\n                              description:\n                                'Allow LLMs to unlock a user account that has been locked due to failed login attempts.',\n                            },\n                            defaultValue: false,\n                            label: 'Unlock Account',\n                          },\n                        ],\n                      },\n                    ]\n                  : []),\n              ],\n              label: 'Experimental Tools',\n            },\n          ]\n        : []),\n    ],\n    labels: {\n      plural: 'API Keys',\n      singular: 'API Key',\n    },\n  }\n}\n"],"names":["toCamelCase","addEnabledCollectionTools","collections","enabledCollectionSlugs","Object","keys","filter","collection","fullyEnabled","enabled","partiallyEnabled","find","create","update","delete","map","enabledCollectionSlug","type","admin","position","fields","name","description","defaultValue","label","charAt","toUpperCase","slice","createAPIKeysCollection","customTools","experimentalTools","customToolsFields","tool","camelCasedName","slug","group","useAsTitle","auth","disableLocalStrategy","useAPIKey","relationTo","required","length","process","env","NODE_ENV","jobs","config","labels","plural","singular"],"mappings":"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"}

package/dist/endpoints/mcp.d.ts

@@ -0,0 +1,4 @@
+import { type PayloadHandler } from 'payload';
+import type { PluginMCPServerConfig } from '../types.js';
+export declare const initializeMCPHandler: (pluginOptions: PluginMCPServerConfig) => PayloadHandler;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/endpoints/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,cAAc,EAAc,MAAM,SAAS,CAAA;AAEnE,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,aAAa,CAAA;AAKtE,eAAO,MAAM,oBAAoB,kBAAmB,qBAAqB,mBAmDxE,CAAA"}

package/dist/endpoints/mcp.js

@@ -0,0 +1,44 @@
+import crypto from 'crypto';
+import { APIError } from 'payload';
+import { createRequestFromPayloadRequest } from '../mcp/createRequest.js';
+import { getMCPHandler } from '../mcp/getMcpHandler.js';
+export const initializeMCPHandler = (pluginOptions)=>{
+    const mcpHandler = async (req)=>{
+        const { payload } = req;
+        const MCPOptions = pluginOptions.mcp || {};
+        const MCPHandlerOptions = MCPOptions.handlerOptions || {};
+        const useVerboseLogs = MCPHandlerOptions.verboseLogs ?? false;
+        const apiKey = req.headers.get('Authorization')?.startsWith('Bearer ') ? req.headers.get('Authorization')?.replace('Bearer ', '').trim() : null;
+        if (apiKey === null) {
+            throw new APIError('API Key is required', 401);
+        }
+        const sha256APIKeyIndex = crypto.createHmac('sha256', payload.secret).update(apiKey || '').digest('hex');
+        const apiKeyConstraints = [
+            {
+                apiKeyIndex: {
+                    equals: sha256APIKeyIndex
+                }
+            }
+        ];
+        const where = {
+            or: apiKeyConstraints
+        };
+        const { docs } = await payload.find({
+            collection: 'payload-mcp-api-keys',
+            where
+        });
+        if (docs.length === 0) {
+            throw new APIError('API Key is invalid', 401);
+        }
+        const toolSettings = docs[0];
+        if (useVerboseLogs) {
+            payload.logger.info('[payload-mcp] API Key is valid');
+        }
+        const handler = getMCPHandler(pluginOptions, toolSettings, req);
+        const request = createRequestFromPayloadRequest(req);
+        return await handler(request);
+    };
+    return mcpHandler;
+};
+
+//# sourceMappingURL=mcp.js.map

package/dist/endpoints/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/mcp.ts"],"sourcesContent":["import crypto from 'crypto'\nimport { APIError, type PayloadHandler, type Where } from 'payload'\n\nimport type { PluginMCPServerConfig, ToolSettings } from '../types.js'\n\nimport { createRequestFromPayloadRequest } from '../mcp/createRequest.js'\nimport { getMCPHandler } from '../mcp/getMcpHandler.js'\n\nexport const initializeMCPHandler = (pluginOptions: PluginMCPServerConfig) => {\n  const mcpHandler: PayloadHandler = async (req) => {\n    const { payload } = req\n    const MCPOptions = pluginOptions.mcp || {}\n    const MCPHandlerOptions = MCPOptions.handlerOptions || {}\n    const useVerboseLogs = MCPHandlerOptions.verboseLogs ?? false\n\n    const apiKey = req.headers.get('Authorization')?.startsWith('Bearer ')\n      ? req.headers.get('Authorization')?.replace('Bearer ', '').trim()\n      : null\n\n    if (apiKey === null) {\n      throw new APIError('API Key is required', 401)\n    }\n\n    const sha256APIKeyIndex = crypto\n      .createHmac('sha256', payload.secret)\n      .update(apiKey || '')\n      .digest('hex')\n\n    const apiKeyConstraints = [\n      {\n        apiKeyIndex: {\n          equals: sha256APIKeyIndex,\n        },\n      },\n    ]\n    const where: Where = {\n      or: apiKeyConstraints,\n    }\n\n    const { docs } = await payload.find({\n      collection: 'payload-mcp-api-keys',\n      where,\n    })\n\n    if (docs.length === 0) {\n      throw new APIError('API Key is invalid', 401)\n    }\n\n    const toolSettings = docs[0] as ToolSettings\n\n    if (useVerboseLogs) {\n      payload.logger.info('[payload-mcp] API Key is valid')\n    }\n\n    const handler = getMCPHandler(pluginOptions, toolSettings, req)\n    const request = createRequestFromPayloadRequest(req)\n    return await handler(request)\n  }\n  return mcpHandler\n}\n"],"names":["crypto","APIError","createRequestFromPayloadRequest","getMCPHandler","initializeMCPHandler","pluginOptions","mcpHandler","req","payload","MCPOptions","mcp","MCPHandlerOptions","handlerOptions","useVerboseLogs","verboseLogs","apiKey","headers","get","startsWith","replace","trim","sha256APIKeyIndex","createHmac","secret","update","digest","apiKeyConstraints","apiKeyIndex","equals","where","or","docs","find","collection","length","toolSettings","logger","info","handler","request"],"mappings":"AAAA,OAAOA,YAAY,SAAQ;AAC3B,SAASC,QAAQ,QAAyC,UAAS;AAInE,SAASC,+BAA+B,QAAQ,0BAAyB;AACzE,SAASC,aAAa,QAAQ,0BAAyB;AAEvD,OAAO,MAAMC,uBAAuB,CAACC;IACnC,MAAMC,aAA6B,OAAOC;QACxC,MAAM,EAAEC,OAAO,EAAE,GAAGD;QACpB,MAAME,aAAaJ,cAAcK,GAAG,IAAI,CAAC;QACzC,MAAMC,oBAAoBF,WAAWG,cAAc,IAAI,CAAC;QACxD,MAAMC,iBAAiBF,kBAAkBG,WAAW,IAAI;QAExD,MAAMC,SAASR,IAAIS,OAAO,CAACC,GAAG,CAAC,kBAAkBC,WAAW,aACxDX,IAAIS,OAAO,CAACC,GAAG,CAAC,kBAAkBE,QAAQ,WAAW,IAAIC,SACzD;QAEJ,IAAIL,WAAW,MAAM;YACnB,MAAM,IAAId,SAAS,uBAAuB;QAC5C;QAEA,MAAMoB,oBAAoBrB,OACvBsB,UAAU,CAAC,UAAUd,QAAQe,MAAM,EACnCC,MAAM,CAACT,UAAU,IACjBU,MAAM,CAAC;QAEV,MAAMC,oBAAoB;YACxB;gBACEC,aAAa;oBACXC,QAAQP;gBACV;YACF;SACD;QACD,MAAMQ,QAAe;YACnBC,IAAIJ;QACN;QAEA,MAAM,EAAEK,IAAI,EAAE,GAAG,MAAMvB,QAAQwB,IAAI,CAAC;YAClCC,YAAY;YACZJ;QACF;QAEA,IAAIE,KAAKG,MAAM,KAAK,GAAG;YACrB,MAAM,IAAIjC,SAAS,sBAAsB;QAC3C;QAEA,MAAMkC,eAAeJ,IAAI,CAAC,EAAE;QAE5B,IAAIlB,gBAAgB;YAClBL,QAAQ4B,MAAM,CAACC,IAAI,CAAC;QACtB;QAEA,MAAMC,UAAUnC,cAAcE,eAAe8B,cAAc5B;QAC3D,MAAMgC,UAAUrC,gCAAgCK;QAChD,OAAO,MAAM+B,QAAQC;IACvB;IACA,OAAOjC;AACT,EAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from 'payload';
+import type { PluginMCPServerConfig } from './types.js';
+/**
+ * The MCP Plugin for Payload. This plugin allows you to add MCP capabilities to your Payload project.
+ *
+ * @param pluginOptions - The options for the MCP plugin.
+ * @experimental This plugin is experimental and may change in the future.
+ */
+export declare const mcpPlugin: (pluginOptions: PluginMCPServerConfig) => (config: Config) => Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAKvD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,kBACJ,qBAAqB,cAC5B,MAAM,KAAG,MAsEjB,CAAA"}

package/dist/index.js

@@ -0,0 +1,67 @@
+import { createAPIKeysCollection } from './collections/createApiKeysCollection.js';
+import { initializeMCPHandler } from './endpoints/mcp.js';
+/**
+ * The MCP Plugin for Payload. This plugin allows you to add MCP capabilities to your Payload project.
+ *
+ * @param pluginOptions - The options for the MCP plugin.
+ * @experimental This plugin is experimental and may change in the future.
+ */ export const mcpPlugin = (pluginOptions)=>(config)=>{
+        if (!config.collections) {
+            config.collections = [];
+        }
+        // Collections
+        const collections = pluginOptions.collections || {};
+        // Extract custom tools for the global config
+        const customTools = pluginOptions.mcp?.tools?.map((tool)=>({
+                name: tool.name,
+                description: tool.description
+            })) || [];
+        const experimentalTools = pluginOptions?.experimental?.tools || {};
+        /**
+     * API Keys
+     * --------
+     * High resolution control over MCP capabilities is crucial when using Payload with LLMs.
+     *
+     * This API Keys collection has ways for admins to create API keys and allow or disallow the MCP capabilities.
+     * This is useful when Admins want to allow or disallow the use of the MCP capabilities in real time.
+     * For example:
+     *  - If a collection has all of its capabilities enabled, admins can allow or disallow the create, update, delete, and find capabilities on that collection.
+     *  - If a collection only has the find capability enabled, admins can only allow or disallow the find capability on that collection.
+     *  - If a custom tool has gone haywire, admins can disallow that tool.
+     *
+     */ const apiKeyCollection = createAPIKeysCollection(collections, customTools, experimentalTools);
+        if (pluginOptions.overrideApiKeyCollection) {
+            config.collections.push(pluginOptions.overrideApiKeyCollection(apiKeyCollection));
+        } else {
+            config.collections.push(apiKeyCollection);
+        }
+        /**
+     * If the plugin is disabled, we still want to keep added collections/fields so the database schema is consistent which is important for migrations.
+     * If your plugin heavily modifies the database schema, you may want to remove this property.
+     */ if (pluginOptions.disabled) {
+            return config;
+        }
+        if (!config.endpoints) {
+            config.endpoints = [];
+        }
+        /**
+     * This is the primary MCP Server Endpoint.
+     * Payload will automatically add the /api prefix to the path, so the full path is `/api/mcp`
+     * NOTE: This is only transport method until we add full support for SSE which will be another endpoint at `/api/sse`
+     */ config.endpoints.push({
+            handler: initializeMCPHandler(pluginOptions),
+            method: 'post',
+            path: '/mcp'
+        });
+        /**
+     * The GET response is always: {"jsonrpc":"2.0","error":{"code":-32000,"message":"Method not allowed."},"id":null} -- even with an API key
+     * This is expected behavior and MCP clients should always use the POST endpoint.
+     */ config.endpoints.push({
+            handler: initializeMCPHandler(pluginOptions),
+            method: 'get',
+            path: '/mcp'
+        });
+        return config;
+    };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Config } from 'payload'\n\nimport type { PluginMCPServerConfig } from './types.js'\n\nimport { createAPIKeysCollection } from './collections/createApiKeysCollection.js'\nimport { initializeMCPHandler } from './endpoints/mcp.js'\n\n/**\n * The MCP Plugin for Payload. This plugin allows you to add MCP capabilities to your Payload project.\n *\n * @param pluginOptions - The options for the MCP plugin.\n * @experimental This plugin is experimental and may change in the future.\n */\nexport const mcpPlugin =\n  (pluginOptions: PluginMCPServerConfig) =>\n  (config: Config): Config => {\n    if (!config.collections) {\n      config.collections = []\n    }\n\n    // Collections\n    const collections = pluginOptions.collections || {}\n    // Extract custom tools for the global config\n    const customTools =\n      pluginOptions.mcp?.tools?.map((tool) => ({\n        name: tool.name,\n        description: tool.description,\n      })) || []\n\n    const experimentalTools = pluginOptions?.experimental?.tools || {}\n\n    /**\n     * API Keys\n     * --------\n     * High resolution control over MCP capabilities is crucial when using Payload with LLMs.\n     *\n     * This API Keys collection has ways for admins to create API keys and allow or disallow the MCP capabilities.\n     * This is useful when Admins want to allow or disallow the use of the MCP capabilities in real time.\n     * For example:\n     *  - If a collection has all of its capabilities enabled, admins can allow or disallow the create, update, delete, and find capabilities on that collection.\n     *  - If a collection only has the find capability enabled, admins can only allow or disallow the find capability on that collection.\n     *  - If a custom tool has gone haywire, admins can disallow that tool.\n     *\n     */\n    const apiKeyCollection = createAPIKeysCollection(collections, customTools, experimentalTools)\n    if (pluginOptions.overrideApiKeyCollection) {\n      config.collections.push(pluginOptions.overrideApiKeyCollection(apiKeyCollection))\n    } else {\n      config.collections.push(apiKeyCollection)\n    }\n\n    /**\n     * If the plugin is disabled, we still want to keep added collections/fields so the database schema is consistent which is important for migrations.\n     * If your plugin heavily modifies the database schema, you may want to remove this property.\n     */\n    if (pluginOptions.disabled) {\n      return config\n    }\n\n    if (!config.endpoints) {\n      config.endpoints = []\n    }\n\n    /**\n     * This is the primary MCP Server Endpoint.\n     * Payload will automatically add the /api prefix to the path, so the full path is `/api/mcp`\n     * NOTE: This is only transport method until we add full support for SSE which will be another endpoint at `/api/sse`\n     */\n    config.endpoints.push({\n      handler: initializeMCPHandler(pluginOptions),\n      method: 'post',\n      path: '/mcp',\n    })\n\n    /**\n     * The GET response is always: {\"jsonrpc\":\"2.0\",\"error\":{\"code\":-32000,\"message\":\"Method not allowed.\"},\"id\":null} -- even with an API key\n     * This is expected behavior and MCP clients should always use the POST endpoint.\n     */\n    config.endpoints.push({\n      handler: initializeMCPHandler(pluginOptions),\n      method: 'get',\n      path: '/mcp',\n    })\n\n    return config\n  }\n"],"names":["createAPIKeysCollection","initializeMCPHandler","mcpPlugin","pluginOptions","config","collections","customTools","mcp","tools","map","tool","name","description","experimentalTools","experimental","apiKeyCollection","overrideApiKeyCollection","push","disabled","endpoints","handler","method","path"],"mappings":"AAIA,SAASA,uBAAuB,QAAQ,2CAA0C;AAClF,SAASC,oBAAoB,QAAQ,qBAAoB;AAEzD;;;;;CAKC,GACD,OAAO,MAAMC,YACX,CAACC,gBACD,CAACC;QACC,IAAI,CAACA,OAAOC,WAAW,EAAE;YACvBD,OAAOC,WAAW,GAAG,EAAE;QACzB;QAEA,cAAc;QACd,MAAMA,cAAcF,cAAcE,WAAW,IAAI,CAAC;QAClD,6CAA6C;QAC7C,MAAMC,cACJH,cAAcI,GAAG,EAAEC,OAAOC,IAAI,CAACC,OAAU,CAAA;gBACvCC,MAAMD,KAAKC,IAAI;gBACfC,aAAaF,KAAKE,WAAW;YAC/B,CAAA,MAAO,EAAE;QAEX,MAAMC,oBAAoBV,eAAeW,cAAcN,SAAS,CAAC;QAEjE;;;;;;;;;;;;KAYC,GACD,MAAMO,mBAAmBf,wBAAwBK,aAAaC,aAAaO;QAC3E,IAAIV,cAAca,wBAAwB,EAAE;YAC1CZ,OAAOC,WAAW,CAACY,IAAI,CAACd,cAAca,wBAAwB,CAACD;QACjE,OAAO;YACLX,OAAOC,WAAW,CAACY,IAAI,CAACF;QAC1B;QAEA;;;KAGC,GACD,IAAIZ,cAAce,QAAQ,EAAE;YAC1B,OAAOd;QACT;QAEA,IAAI,CAACA,OAAOe,SAAS,EAAE;YACrBf,OAAOe,SAAS,GAAG,EAAE;QACvB;QAEA;;;;KAIC,GACDf,OAAOe,SAAS,CAACF,IAAI,CAAC;YACpBG,SAASnB,qBAAqBE;YAC9BkB,QAAQ;YACRC,MAAM;QACR;QAEA;;;KAGC,GACDlB,OAAOe,SAAS,CAACF,IAAI,CAAC;YACpBG,SAASnB,qBAAqBE;YAC9BkB,QAAQ;YACRC,MAAM;QACR;QAEA,OAAOlB;IACT,EAAC"}

package/dist/mcp/createRequest.d.ts

@@ -0,0 +1,3 @@
+import { type PayloadRequest } from 'payload';
+export declare const createRequestFromPayloadRequest: (req: PayloadRequest) => Request;
+//# sourceMappingURL=createRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRequest.d.ts","sourceRoot":"","sources":["../../src/mcp/createRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAEvD,eAAO,MAAM,+BAA+B,QAAS,cAAc,YAUlE,CAAA"}

package/dist/mcp/createRequest.js

@@ -0,0 +1,14 @@
+import { APIError } from 'payload';
+export const createRequestFromPayloadRequest = (req)=>{
+    if (!req.url) {
+        throw new APIError('Request URL is required', 500);
+    }
+    return new Request(req.url, {
+        body: req.body,
+        duplex: 'half',
+        headers: req.headers,
+        method: req.method
+    });
+};
+
+//# sourceMappingURL=createRequest.js.map

package/dist/mcp/createRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/createRequest.ts"],"sourcesContent":["import { APIError, type PayloadRequest } from 'payload'\n\nexport const createRequestFromPayloadRequest = (req: PayloadRequest) => {\n  if (!req.url) {\n    throw new APIError('Request URL is required', 500)\n  }\n  return new Request(req.url, {\n    body: req.body,\n    duplex: 'half',\n    headers: req.headers,\n    method: req.method,\n  } as { duplex: 'half' } & RequestInit)\n}\n"],"names":["APIError","createRequestFromPayloadRequest","req","url","Request","body","duplex","headers","method"],"mappings":"AAAA,SAASA,QAAQ,QAA6B,UAAS;AAEvD,OAAO,MAAMC,kCAAkC,CAACC;IAC9C,IAAI,CAACA,IAAIC,GAAG,EAAE;QACZ,MAAM,IAAIH,SAAS,2BAA2B;IAChD;IACA,OAAO,IAAII,QAAQF,IAAIC,GAAG,EAAE;QAC1BE,MAAMH,IAAIG,IAAI;QACdC,QAAQ;QACRC,SAASL,IAAIK,OAAO;QACpBC,QAAQN,IAAIM,MAAM;IACpB;AACF,EAAC"}

package/dist/mcp/getMcpHandler.d.ts

@@ -0,0 +1,4 @@
+import { type PayloadRequest } from 'payload';
+import type { PluginMCPServerConfig, ToolSettings } from '../types.js';
+export declare const getMCPHandler: (pluginOptions: PluginMCPServerConfig, toolSettings: ToolSettings, req: PayloadRequest) => (request: Request) => Promise<Response>;
+//# sourceMappingURL=getMcpHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getMcpHandler.d.ts","sourceRoot":"","sources":["../../src/mcp/getMcpHandler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgC,KAAK,cAAc,EAAkB,MAAM,SAAS,CAAA;AAE3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AA4BtE,eAAO,MAAM,aAAa,kBACT,qBAAqB,gBACtB,YAAY,OACrB,cAAc,4CA2YpB,CAAA"}