@payloadcms/plugin-mcp 3.70.0 → 3.71.0-internal.27e1e08

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionConfig, CollectionSlug, PayloadRequest, TypedUser } 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   * 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?: CollectionConfig | string\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  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 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":"AAidA,WAKC"}
+{"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?: CollectionConfig | string\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"}

package/dist/utils/adminEntitySettings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Defines the default admin entity settings for Collections and Globals.
+ * This is used to create the MCP API key permission fields for the API Keys collection.
+ */
+export declare const adminEntitySettings: {
+    collection: {
+        name: string;
+        description: (slug: string) => string;
+        label: string;
+    }[];
+    global: {
+        name: string;
+        description: (slug: string) => string;
+        label: string;
+    }[];
+};
+//# sourceMappingURL=adminEntitySettings.d.ts.map

package/dist/utils/adminEntitySettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminEntitySettings.d.ts","sourceRoot":"","sources":["../../src/utils/adminEntitySettings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;4BAIN,MAAM;;;;;4BAsBN,MAAM;;;CAS/B,CAAA"}

package/dist/utils/adminEntitySettings.js

@@ -0,0 +1,41 @@
+/**
+ * Defines the default admin entity settings for Collections and Globals.
+ * This is used to create the MCP API key permission fields for the API Keys collection.
+ */ export const adminEntitySettings = {
+    collection: [
+        {
+            name: 'find',
+            description: (slug)=>`Allow clients to find ${slug}.`,
+            label: 'Find'
+        },
+        {
+            name: 'create',
+            description: (slug)=>`Allow clients to create ${slug}.`,
+            label: 'Create'
+        },
+        {
+            name: 'update',
+            description: (slug)=>`Allow clients to update ${slug}.`,
+            label: 'Update'
+        },
+        {
+            name: 'delete',
+            description: (slug)=>`Allow clients to delete ${slug}.`,
+            label: 'Delete'
+        }
+    ],
+    global: [
+        {
+            name: 'find',
+            description: (slug)=>`Allow clients to find ${slug} global.`,
+            label: 'Find'
+        },
+        {
+            name: 'update',
+            description: (slug)=>`Allow clients to update ${slug} global.`,
+            label: 'Update'
+        }
+    ]
+};
+
+//# sourceMappingURL=adminEntitySettings.js.map

package/dist/utils/adminEntitySettings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/adminEntitySettings.ts"],"sourcesContent":["/**\n * Defines the default admin entity settings for Collections and Globals.\n * This is used to create the MCP API key permission fields for the API Keys collection.\n */\nexport const adminEntitySettings = {\n  collection: [\n    {\n      name: 'find',\n      description: (slug: string) => `Allow clients to find ${slug}.`,\n      label: 'Find',\n    },\n    {\n      name: 'create',\n      description: (slug: string) => `Allow clients to create ${slug}.`,\n      label: 'Create',\n    },\n    {\n      name: 'update',\n      description: (slug: string) => `Allow clients to update ${slug}.`,\n      label: 'Update',\n    },\n    {\n      name: 'delete',\n      description: (slug: string) => `Allow clients to delete ${slug}.`,\n      label: 'Delete',\n    },\n  ],\n  global: [\n    {\n      name: 'find',\n      description: (slug: string) => `Allow clients to find ${slug} global.`,\n      label: 'Find',\n    },\n    {\n      name: 'update',\n      description: (slug: string) => `Allow clients to update ${slug} global.`,\n      label: 'Update',\n    },\n  ],\n}\n"],"names":["adminEntitySettings","collection","name","description","slug","label","global"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,sBAAsB;IACjCC,YAAY;QACV;YACEC,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,sBAAsB,EAAEA,KAAK,CAAC,CAAC;YAC/DC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,wBAAwB,EAAEA,KAAK,CAAC,CAAC;YACjEC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,wBAAwB,EAAEA,KAAK,CAAC,CAAC;YACjEC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,wBAAwB,EAAEA,KAAK,CAAC,CAAC;YACjEC,OAAO;QACT;KACD;IACDC,QAAQ;QACN;YACEJ,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,sBAAsB,EAAEA,KAAK,QAAQ,CAAC;YACtEC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,aAAa,CAACC,OAAiB,CAAC,wBAAwB,EAAEA,KAAK,QAAQ,CAAC;YACxEC,OAAO;QACT;KACD;AACH,EAAC"}

package/dist/utils/createApiKeyFields.d.ts

@@ -0,0 +1,15 @@
+import type { Field } from 'payload';
+import type { EntityConfig } from '../types.js';
+/**
+ * Creates MCP API key permission fields using collections or globals.
+ * Generates collapsible field groups with checkboxes for each enabled operation.
+ *
+ * @param config - The collections or globals configuration object
+ * @param configType - The type of configuration ('collection' or 'global')
+ * @returns Array of fields for the MCP API Keys collection
+ */
+export declare const createApiKeyFields: ({ config, configType, }: {
+    config: EntityConfig | undefined;
+    configType: "collection" | "global";
+}) => Field[];
+//# sourceMappingURL=createApiKeyFields.d.ts.map

package/dist/utils/createApiKeyFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApiKeyFields.d.ts","sourceRoot":"","sources":["../../src/utils/createApiKeyFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK/C;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,4BAG5B;IACD,MAAM,EAAE,YAAY,GAAG,SAAS,CAAA;IAChC,UAAU,EAAE,YAAY,GAAG,QAAQ,CAAA;CACpC,KAAG,KAAK,EAkDR,CAAA"}

package/dist/utils/createApiKeyFields.js

@@ -0,0 +1,57 @@
+import { adminEntitySettings } from './adminEntitySettings.js';
+import { toCamelCase } from './camelCase.js';
+import { getEnabledSlugs } from './getEnabledSlugs.js';
+/**
+ * Creates MCP API key permission fields using collections or globals.
+ * Generates collapsible field groups with checkboxes for each enabled operation.
+ *
+ * @param config - The collections or globals configuration object
+ * @param configType - The type of configuration ('collection' or 'global')
+ * @returns Array of fields for the MCP API Keys collection
+ */ export const createApiKeyFields = ({ config, configType })=>{
+    const operations = adminEntitySettings[configType];
+    const enabledSlugs = getEnabledSlugs(config, configType);
+    return enabledSlugs.map((slug)=>{
+        const entityConfig = config?.[slug];
+        const enabledOperations = operations.filter((operation)=>{
+            // If fully enabled, all operations are available
+            if (entityConfig?.enabled === true) {
+                return true;
+            }
+            // If partially enabled, check if this specific operation is enabled
+            const enabled = entityConfig?.enabled;
+            if (typeof enabled !== 'boolean' && enabled) {
+                const operationEnabled = enabled[operation.name];
+                return typeof operationEnabled === 'boolean' && operationEnabled === true;
+            }
+            return false;
+        });
+        // Generate checkbox fields for each enabled operation
+        const operationFields = enabledOperations.map((operation)=>({
+                name: operation.name,
+                type: 'checkbox',
+                admin: {
+                    description: operation.description(slug)
+                },
+                defaultValue: false,
+                label: operation.label
+            }));
+        return {
+            type: 'collapsible',
+            admin: {
+                position: 'sidebar'
+            },
+            fields: [
+                {
+                    name: toCamelCase(slug),
+                    type: 'group',
+                    fields: operationFields,
+                    label: configType
+                }
+            ],
+            label: `${slug.charAt(0).toUpperCase() + toCamelCase(slug).slice(1)}`
+        };
+    });
+};
+
+//# sourceMappingURL=createApiKeyFields.js.map

package/dist/utils/createApiKeyFields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/createApiKeyFields.ts"],"sourcesContent":["import type { Field } from 'payload'\n\nimport type { EntityConfig } from '../types.js'\n\nimport { adminEntitySettings } from './adminEntitySettings.js'\nimport { toCamelCase } from './camelCase.js'\nimport { getEnabledSlugs } from './getEnabledSlugs.js'\n/**\n * Creates MCP API key permission fields using collections or globals.\n * Generates collapsible field groups with checkboxes for each enabled operation.\n *\n * @param config - The collections or globals configuration object\n * @param configType - The type of configuration ('collection' or 'global')\n * @returns Array of fields for the MCP API Keys collection\n */\nexport const createApiKeyFields = ({\n  config,\n  configType,\n}: {\n  config: EntityConfig | undefined\n  configType: 'collection' | 'global'\n}): Field[] => {\n  const operations = adminEntitySettings[configType]\n  const enabledSlugs = getEnabledSlugs(config, configType)\n\n  return enabledSlugs.map((slug) => {\n    const entityConfig = config?.[slug]\n\n    const enabledOperations = operations.filter((operation) => {\n      // If fully enabled, all operations are available\n      if (entityConfig?.enabled === true) {\n        return true\n      }\n\n      // If partially enabled, check if this specific operation is enabled\n      const enabled = entityConfig?.enabled\n      if (typeof enabled !== 'boolean' && enabled) {\n        const operationEnabled = enabled[operation.name as keyof typeof enabled]\n        return typeof operationEnabled === 'boolean' && operationEnabled === true\n      }\n\n      return false\n    })\n\n    // Generate checkbox fields for each enabled operation\n    const operationFields = enabledOperations.map((operation) => ({\n      name: operation.name,\n      type: 'checkbox' as const,\n      admin: {\n        description: operation.description(slug),\n      },\n      defaultValue: false,\n      label: operation.label,\n    }))\n\n    return {\n      type: 'collapsible' as const,\n      admin: {\n        position: 'sidebar' as const,\n      },\n      fields: [\n        {\n          name: toCamelCase(slug),\n          type: 'group' as const,\n          fields: operationFields,\n          label: configType,\n        },\n      ],\n      label: `${slug.charAt(0).toUpperCase() + toCamelCase(slug).slice(1)}`,\n    }\n  })\n}\n"],"names":["adminEntitySettings","toCamelCase","getEnabledSlugs","createApiKeyFields","config","configType","operations","enabledSlugs","map","slug","entityConfig","enabledOperations","filter","operation","enabled","operationEnabled","name","operationFields","type","admin","description","defaultValue","label","position","fields","charAt","toUpperCase","slice"],"mappings":"AAIA,SAASA,mBAAmB,QAAQ,2BAA0B;AAC9D,SAASC,WAAW,QAAQ,iBAAgB;AAC5C,SAASC,eAAe,QAAQ,uBAAsB;AACtD;;;;;;;CAOC,GACD,OAAO,MAAMC,qBAAqB,CAAC,EACjCC,MAAM,EACNC,UAAU,EAIX;IACC,MAAMC,aAAaN,mBAAmB,CAACK,WAAW;IAClD,MAAME,eAAeL,gBAAgBE,QAAQC;IAE7C,OAAOE,aAAaC,GAAG,CAAC,CAACC;QACvB,MAAMC,eAAeN,QAAQ,CAACK,KAAK;QAEnC,MAAME,oBAAoBL,WAAWM,MAAM,CAAC,CAACC;YAC3C,iDAAiD;YACjD,IAAIH,cAAcI,YAAY,MAAM;gBAClC,OAAO;YACT;YAEA,oEAAoE;YACpE,MAAMA,UAAUJ,cAAcI;YAC9B,IAAI,OAAOA,YAAY,aAAaA,SAAS;gBAC3C,MAAMC,mBAAmBD,OAAO,CAACD,UAAUG,IAAI,CAAyB;gBACxE,OAAO,OAAOD,qBAAqB,aAAaA,qBAAqB;YACvE;YAEA,OAAO;QACT;QAEA,sDAAsD;QACtD,MAAME,kBAAkBN,kBAAkBH,GAAG,CAAC,CAACK,YAAe,CAAA;gBAC5DG,MAAMH,UAAUG,IAAI;gBACpBE,MAAM;gBACNC,OAAO;oBACLC,aAAaP,UAAUO,WAAW,CAACX;gBACrC;gBACAY,cAAc;gBACdC,OAAOT,UAAUS,KAAK;YACxB,CAAA;QAEA,OAAO;YACLJ,MAAM;YACNC,OAAO;gBACLI,UAAU;YACZ;YACAC,QAAQ;gBACN;oBACER,MAAMf,YAAYQ;oBAClBS,MAAM;oBACNM,QAAQP;oBACRK,OAAOjB;gBACT;aACD;YACDiB,OAAO,GAAGb,KAAKgB,MAAM,CAAC,GAAGC,WAAW,KAAKzB,YAAYQ,MAAMkB,KAAK,CAAC,IAAI;QACvE;IACF;AACF,EAAC"}

package/dist/utils/getEnabledSlugs.d.ts

@@ -0,0 +1,13 @@
+import type { EntityConfig } from '../types.js';
+/**
+ * Extracts enabled slugs from collections or globals configuration.
+ * A slug is considered enabled if:
+ * 1. enabled is set to true (fully enabled)
+ * 2. enabled is an object with at least one operation set to true
+ *
+ * @param config - The collections or globals configuration object
+ * @param configType - The type of configuration ('collection' or 'global')
+ * @returns Array of enabled slugs
+ */
+export declare const getEnabledSlugs: (config: EntityConfig | undefined, configType: "collection" | "global") => string[];
+//# sourceMappingURL=getEnabledSlugs.d.ts.map

package/dist/utils/getEnabledSlugs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEnabledSlugs.d.ts","sourceRoot":"","sources":["../../src/utils/getEnabledSlugs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,WAClB,YAAY,GAAG,SAAS,cACpB,YAAY,GAAG,QAAQ,KAClC,MAAM,EAwBR,CAAA"}

package/dist/utils/getEnabledSlugs.js

@@ -0,0 +1,32 @@
+import { adminEntitySettings } from './adminEntitySettings.js';
+/**
+ * Extracts enabled slugs from collections or globals configuration.
+ * A slug is considered enabled if:
+ * 1. enabled is set to true (fully enabled)
+ * 2. enabled is an object with at least one operation set to true
+ *
+ * @param config - The collections or globals configuration object
+ * @param configType - The type of configuration ('collection' or 'global')
+ * @returns Array of enabled slugs
+ */ export const getEnabledSlugs = (config, configType)=>{
+    return Object.keys(config || {}).filter((slug)=>{
+        const entityConfig = config?.[slug];
+        const operations = adminEntitySettings[configType];
+        // Check if fully enabled (boolean true)
+        const fullyEnabled = typeof entityConfig?.enabled === 'boolean' && entityConfig?.enabled === true;
+        if (fullyEnabled) {
+            return true;
+        }
+        // Check if partially enabled (at least one operation is enabled)
+        const enabled = entityConfig?.enabled;
+        if (typeof enabled !== 'boolean' && enabled) {
+            return operations.some((operation)=>{
+                const operationEnabled = enabled[operation.name];
+                return typeof operationEnabled === 'boolean' && operationEnabled === true;
+            });
+        }
+        return false;
+    });
+};
+
+//# sourceMappingURL=getEnabledSlugs.js.map

package/dist/utils/getEnabledSlugs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getEnabledSlugs.ts"],"sourcesContent":["import type { EntityConfig } from '../types.js'\n\nimport { adminEntitySettings } from './adminEntitySettings.js'\n\n/**\n * Extracts enabled slugs from collections or globals configuration.\n * A slug is considered enabled if:\n * 1. enabled is set to true (fully enabled)\n * 2. enabled is an object with at least one operation set to true\n *\n * @param config - The collections or globals configuration object\n * @param configType - The type of configuration ('collection' or 'global')\n * @returns Array of enabled slugs\n */\nexport const getEnabledSlugs = (\n  config: EntityConfig | undefined,\n  configType: 'collection' | 'global',\n): string[] => {\n  return Object.keys(config || {}).filter((slug) => {\n    const entityConfig = config?.[slug]\n    const operations = adminEntitySettings[configType]\n\n    // Check if fully enabled (boolean true)\n    const fullyEnabled =\n      typeof entityConfig?.enabled === 'boolean' && entityConfig?.enabled === true\n\n    if (fullyEnabled) {\n      return true\n    }\n\n    // Check if partially enabled (at least one operation is enabled)\n    const enabled = entityConfig?.enabled\n    if (typeof enabled !== 'boolean' && enabled) {\n      return operations.some((operation) => {\n        const operationEnabled = enabled[operation.name as keyof typeof enabled]\n        return typeof operationEnabled === 'boolean' && operationEnabled === true\n      })\n    }\n\n    return false\n  })\n}\n"],"names":["adminEntitySettings","getEnabledSlugs","config","configType","Object","keys","filter","slug","entityConfig","operations","fullyEnabled","enabled","some","operation","operationEnabled","name"],"mappings":"AAEA,SAASA,mBAAmB,QAAQ,2BAA0B;AAE9D;;;;;;;;;CASC,GACD,OAAO,MAAMC,kBAAkB,CAC7BC,QACAC;IAEA,OAAOC,OAAOC,IAAI,CAACH,UAAU,CAAC,GAAGI,MAAM,CAAC,CAACC;QACvC,MAAMC,eAAeN,QAAQ,CAACK,KAAK;QACnC,MAAME,aAAaT,mBAAmB,CAACG,WAAW;QAElD,wCAAwC;QACxC,MAAMO,eACJ,OAAOF,cAAcG,YAAY,aAAaH,cAAcG,YAAY;QAE1E,IAAID,cAAc;YAChB,OAAO;QACT;QAEA,iEAAiE;QACjE,MAAMC,UAAUH,cAAcG;QAC9B,IAAI,OAAOA,YAAY,aAAaA,SAAS;YAC3C,OAAOF,WAAWG,IAAI,CAAC,CAACC;gBACtB,MAAMC,mBAAmBH,OAAO,CAACE,UAAUE,IAAI,CAAyB;gBACxE,OAAO,OAAOD,qBAAqB,aAAaA,qBAAqB;YACvE;QACF;QAEA,OAAO;IACT;AACF,EAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/plugin-mcp",
-  "version": "3.70.0",
+  "version": "3.71.0-internal.27e1e08",
   "description": "MCP (Model Context Protocol) capabilities with Payload",
   "keywords": [
     "plugin",
@@ -45,10 +45,10 @@
   },
   "devDependencies": {
     "@payloadcms/eslint-config": "3.28.0",
-    "payload": "3.70.0"
+    "payload": "3.71.0-internal.27e1e08"
   },
   "peerDependencies": {
-    "payload": "3.70.0"
+    "payload": "3.71.0-internal.27e1e08"
   },
   "homepage:": "https://payloadcms.com",
   "scripts": {

package/src/collections/createApiKeysCollection.ts

@@ -3,119 +3,11 @@ import type { CollectionConfig } from 'payload'
 import type { PluginMCPServerConfig } from '../types.js'
 
 import { toCamelCase } from '../utils/camelCase.js'
-
-const addEnabledCollectionTools = (collections: PluginMCPServerConfig['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' as const,
-    admin: {
-      description: `Manage client access to ${enabledCollectionSlug}`,
-      position: 'sidebar' as const,
-    },
-    fields: [
-      {
-        name: `${toCamelCase(enabledCollectionSlug)}`,
-        type: 'group' as const,
-        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' as const,
-                  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' as const,
-                  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' as const,
-                  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' as const,
-                  admin: {
-                    description: `Allow clients to delete ${enabledCollectionSlug}.`,
-                  },
-                  defaultValue: false,
-                  label: 'Delete',
-                },
-              ]
-            : []),
-        ],
-        label: false as const,
-      },
-    ],
-    label: `${enabledCollectionSlug.charAt(0).toUpperCase() + toCamelCase(enabledCollectionSlug).slice(1)}`,
-  }))
-}
+import { createApiKeyFields } from '../utils/createApiKeyFields.js'
 
 export const createAPIKeysCollection = (
   collections: PluginMCPServerConfig['collections'],
+  globals: PluginMCPServerConfig['globals'],
   customTools: Array<{ description: string; name: string }> = [],
   experimentalTools: NonNullable<PluginMCPServerConfig['experimental']>['tools'] = {},
   pluginOptions: PluginMCPServerConfig,
@@ -204,7 +96,15 @@ export const createAPIKeysCollection = (
         },
       },
 
-      ...addEnabledCollectionTools(collections),
+      ...createApiKeyFields({
+        config: collections,
+        configType: 'collection',
+      }),
+
+      ...createApiKeyFields({
+        config: globals,
+        configType: 'global',
+      }),
 
       ...(customTools.length > 0
         ? [

package/src/endpoints/mcp.ts

@@ -44,6 +44,7 @@ export const initializeMCPHandler = (pluginOptions: PluginMCPServerConfig) => {
 
       const { docs } = await payload.find({
         collection: 'payload-mcp-api-keys',
+        depth: 1,
         limit: 1,
         pagination: false,
         where,

package/src/index.ts

@@ -27,6 +27,8 @@ export const mcpPlugin =
 
     // Collections
     const collections = pluginOptions.collections || {}
+    // Globals
+    const globals = pluginOptions.globals || {}
     // Extract custom tools for the global config
     const customTools =
       pluginOptions.mcp?.tools?.map((tool) => ({
@@ -46,11 +48,13 @@ export const mcpPlugin =
      * 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 global has all of its capabilities enabled, admins can allow or disallow the find and update capabilities on that global.
      *  - If a custom tool has gone haywire, admins can disallow that tool.
      *
      */
     const apiKeyCollection = createAPIKeysCollection(
       collections,
+      globals,
       customTools,
       experimentalTools,
       pluginOptions,

package/src/mcp/getMcpHandler.ts

@@ -7,9 +7,12 @@ import { APIError, configToJSONSchema, type PayloadRequest, type TypedUser } fro
 import type { MCPAccessSettings, PluginMCPServerConfig } from '../types.js'
 
 import { toCamelCase } from '../utils/camelCase.js'
+import { getEnabledSlugs } from '../utils/getEnabledSlugs.js'
 import { registerTool } from './registerTool.js'
 
 // Tools
+import { findGlobalTool } from './tools/global/find.js'
+import { updateGlobalTool } from './tools/global/update.js'
 import { createResourceTool } from './tools/resource/create.js'
 import { deleteResourceTool } from './tools/resource/delete.js'
 import { findResourceTool } from './tools/resource/find.js'
@@ -81,6 +84,7 @@ export const getMCPHandler = (
   const experimentalTools: NonNullable<PluginMCPServerConfig['experimental']>['tools'] =
     pluginOptions?.experimental?.tools || {}
   const collectionsPluginConfig = pluginOptions.collections || {}
+  const globalsPluginConfig = pluginOptions.globals || {}
   const collectionsDirPath =
     experimentalTools && experimentalTools.collections?.collectionsDirPath
       ? experimentalTools.collections.collectionsDirPath
@@ -97,32 +101,8 @@ export const getMCPHandler = (
   try {
     return createMcpHandler(
       (server) => {
-        const enabledCollectionSlugs = Object.keys(collectionsPluginConfig || {}).filter(
-          (collection) => {
-            const fullyEnabled =
-              typeof collectionsPluginConfig?.[collection]?.enabled === 'boolean' &&
-              collectionsPluginConfig?.[collection]?.enabled
-
-            if (fullyEnabled) {
-              return true
-            }
-
-            const partiallyEnabled =
-              typeof collectionsPluginConfig?.[collection]?.enabled !== 'boolean' &&
-              ((typeof collectionsPluginConfig?.[collection]?.enabled?.find === 'boolean' &&
-                collectionsPluginConfig?.[collection]?.enabled?.find === true) ||
-                (typeof collectionsPluginConfig?.[collection]?.enabled?.create === 'boolean' &&
-                  collectionsPluginConfig?.[collection]?.enabled?.create === true) ||
-                (typeof collectionsPluginConfig?.[collection]?.enabled?.update === 'boolean' &&
-                  collectionsPluginConfig?.[collection]?.enabled?.update === true) ||
-                (typeof collectionsPluginConfig?.[collection]?.enabled?.delete === 'boolean' &&
-                  collectionsPluginConfig?.[collection]?.enabled?.delete === true))
-
-            if (partiallyEnabled) {
-              return true
-            }
-          },
-        )
+        // Get enabled collections
+        const enabledCollectionSlugs = getEnabledSlugs(collectionsPluginConfig, 'collection')
 
         // Collection Operation Tools
         enabledCollectionSlugs.forEach((enabledCollectionSlug) => {
@@ -215,6 +195,62 @@ export const getMCPHandler = (
           }
         })
 
+        // Global Operation Tools
+        const enabledGlobalSlugs = getEnabledSlugs(globalsPluginConfig, 'global')
+
+        enabledGlobalSlugs.forEach((enabledGlobalSlug) => {
+          try {
+            const schema = configSchema.definitions?.[enabledGlobalSlug] as JSONSchema4
+
+            const toolCapabilities = mcpAccessSettings?.[
+              `${toCamelCase(enabledGlobalSlug)}`
+            ] as Record<string, unknown>
+            const allowFind: boolean | undefined = toolCapabilities?.['find'] as boolean
+            const allowUpdate: boolean | undefined = toolCapabilities?.['update'] as boolean
+
+            if (allowFind) {
+              registerTool(
+                allowFind,
+                `Find ${enabledGlobalSlug}`,
+                () =>
+                  findGlobalTool(
+                    server,
+                    req,
+                    user,
+                    useVerboseLogs,
+                    enabledGlobalSlug,
+                    globalsPluginConfig,
+                  ),
+                payload,
+                useVerboseLogs,
+              )
+            }
+            if (allowUpdate) {
+              registerTool(
+                allowUpdate,
+                `Update ${enabledGlobalSlug}`,
+                () =>
+                  updateGlobalTool(
+                    server,
+                    req,
+                    user,
+                    useVerboseLogs,
+                    enabledGlobalSlug,
+                    globalsPluginConfig,
+                    schema,
+                  ),
+                payload,
+                useVerboseLogs,
+              )
+            }
+          } catch (error) {
+            throw new APIError(
+              `Error registering tools for global ${enabledGlobalSlug}: ${String(error)}`,
+              500,
+            )
+          }
+        })
+
         // Custom tools
         customMCPTools.forEach((tool) => {
           const camelCasedToolName = toCamelCase(tool.name)