@govcraft/payload-cms-mcp 1.0.1

package/dist/mcp/generated/tools/createNumberField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createNumberField",
+  "description": "Creates a Payload CMS 3.0 NumberField configuration\n\nExample:\n```typescript\n{\n  name: 'price',\n  type: 'number',\n  required: true,\n  label: 'Product Price',\n  min: 0,\n  max: 1000,\n  // Custom validation example\n  validate: (value) => {\n    if (value && value % 1 !== 0) {\n      return 'Price must be a whole number';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'number',\n  label: 'Number Field', // Label shown in the admin UI\n  required: true,\n  min: 0,\n  max: 100,\n  // Optional: Add custom validation\n  validate: (value) => {\n    if (value && value % 1 !== 0) {\n      return 'Please enter a whole number';\n    }\n    return true; // Return true if valid\n  },\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Enter a numeric value',\n    width: '25%'\n  }\n}"
+}

package/dist/mcp/generated/tools/createPointField.json

@@ -0,0 +1,79 @@
+{
+  "name": "createPointField",
+  "description": "Creates a Payload CMS 3.0 PointField configuration\n\nExample:\n```typescript\n{\n  name: 'pointField',\n  type: 'point',\n  required: true,\n  label: 'Point Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "description": "Numeric value",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field, used as the property name in the database"
+      },
+      "type": {
+        "type": "string",
+        "enum": [
+          "point"
+        ],
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      },
+      "admin": {
+        "type": "object",
+        "description": "Admin panel configuration for this field",
+        "properties": {
+          "description": {
+            "type": "string",
+            "description": "Additional description shown in the admin UI"
+          },
+          "position": {
+            "type": "string",
+            "enum": [
+              "sidebar"
+            ],
+            "description": "Position of the field in the admin UI"
+          },
+          "width": {
+            "type": "string",
+            "description": "Width of the field in the admin UI"
+          },
+          "style": {
+            "type": "object",
+            "description": "Custom CSS styles for the field"
+          },
+          "className": {
+            "type": "string",
+            "description": "CSS class name for the field"
+          },
+          "readOnly": {
+            "type": "boolean",
+            "description": "Whether the field is read-only in the admin UI"
+          },
+          "hidden": {
+            "type": "boolean",
+            "description": "Whether the field is hidden in the admin UI"
+          },
+          "condition": {
+            "type": "string",
+            "description": "Condition for showing/hiding the field"
+          }
+        }
+      },
+      "validate": {
+        "type": "string",
+        "description": "Custom validation function that returns true if valid or an error message string if invalid"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ]
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'point',\n  label: 'Point Field', // Label shown in the admin UI\n  required: true,\n  // Add field-specific properties here\n  \n  // Optional: Add custom validation\n  validate: (value, { siblingData, operation }) => {\n    // Custom validation logic based on the value, sibling data, or operation\n    if (!value && operation === 'create') {\n      return 'This field is required for new records';\n    }\n    return true; // Return true if valid\n  },\n  ...{rest}\n}"
+}

package/dist/mcp/generated/tools/createPolymorphicRelationshipField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createPolymorphicRelationshipField",
+  "description": "Creates a Payload CMS 3.0 PolymorphicRelationshipField configuration\n\nExample:\n```typescript\n{\n  name: 'polymorphicrelationshipField',\n  type: 'polymorphicrelationship',\n  required: true,\n  label: 'Polymorphicrelationship Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'relationship',\n  label: 'Relationship Field', // Label shown in the admin UI\n  required: true,\n  relationTo: 'collection-name', // Replace with your collection slug\n  hasMany: false, // Set to true for multiple relationships\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Select a related document'\n  }\n}"
+}

package/dist/mcp/generated/tools/createRadioField.json

@@ -0,0 +1,94 @@
+{
+  "name": "createRadioField",
+  "description": "Creates a Payload CMS 3.0 RadioField configuration\n\nExample:\n```typescript\n{\n  name: 'radioField',\n  type: 'radio',\n  required: true,\n  label: 'Radio Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "description": "Payload.RadioField configuration object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field, used as the property name in the database"
+      },
+      "type": {
+        "type": "string",
+        "enum": [
+          "radio"
+        ],
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      },
+      "admin": {
+        "type": "object",
+        "description": "Admin panel configuration for this field",
+        "properties": {
+          "description": {
+            "type": "string",
+            "description": "Additional description shown in the admin UI"
+          },
+          "position": {
+            "type": "string",
+            "enum": [
+              "sidebar"
+            ],
+            "description": "Position of the field in the admin UI"
+          },
+          "width": {
+            "type": "string",
+            "description": "Width of the field in the admin UI"
+          },
+          "style": {
+            "type": "object",
+            "description": "Custom CSS styles for the field"
+          },
+          "className": {
+            "type": "string",
+            "description": "CSS class name for the field"
+          },
+          "readOnly": {
+            "type": "boolean",
+            "description": "Whether the field is read-only in the admin UI"
+          },
+          "hidden": {
+            "type": "boolean",
+            "description": "Whether the field is hidden in the admin UI"
+          },
+          "condition": {
+            "type": "string",
+            "description": "Condition for showing/hiding the field"
+          }
+        }
+      },
+      "options": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          }
+        },
+        "description": "Options for the select/radio field"
+      },
+      "validate": {
+        "type": "string",
+        "description": "Custom validation function that returns true if valid or an error message string if invalid"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ]
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'radio',\n  label: 'Radio Field', // Label shown in the admin UI\n  required: true,\n  options: [\n    {\n      label: 'Option One',\n      value: 'option-one',\n    },\n    {\n      label: 'Option Two',\n      value: 'option-two',\n    },\n  ],\n  defaultValue: 'option-one',\n  // Optional: Add custom validation\n  validate: (value) => {\n    // Custom validation logic\n    return true; // Return true if valid\n  },\n}"
+}

package/dist/mcp/generated/tools/createRefreshHook.json

@@ -0,0 +1,9 @@
+{
+  "name": "createRefreshHook",
+  "description": "Creates a Payload CMS 3.0 RefreshHook configuration",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  },
+  "template": "/**\n * Generic Payload CMS hook\n * See documentation for specific hook parameters\n */\nconst hook = (args) => {\n  // Extract relevant properties from args based on hook type\n  const { req } = args;\n  \n  // Example: Log hook execution\n  logger.info('Hook executed');\n  \n  // For hooks that modify data, return the modified data\n  // For other hooks, return as appropriate for the hook type\n  return args.data ? { ...args.data, modified: true } : undefined;\n};"
+}

package/dist/mcp/generated/tools/createRelationshipField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createRelationshipField",
+  "description": "Creates a Payload CMS 3.0 RelationshipField configuration\n\nExample:\n```typescript\n{\n  name: 'author',\n  type: 'relationship',\n  relationTo: 'users',\n  hasMany: false,\n  required: true,\n  // Custom validation example\n  validate: async (value, { req }) => {\n    // Check if the related document exists and is published\n    if (value) {\n      const relatedDoc = await req.payload.findByID({\n        collection: 'users',\n        id: value,\n      });\n      \n      if (!relatedDoc) {\n        return 'Selected user does not exist';\n      }\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'relationship',\n  label: 'Relationship Field', // Label shown in the admin UI\n  required: true,\n  relationTo: 'collection-name', // Replace with your collection slug\n  hasMany: false, // Set to true for multiple relationships\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Select a related document'\n  }\n}"
+}

package/dist/mcp/generated/tools/createRichTextField.json

@@ -0,0 +1,79 @@
+{
+  "name": "createRichTextField",
+  "description": "Creates a Payload CMS 3.0 RichTextField configuration\n\nExample:\n```typescript\n{\n  name: 'richtextField',\n  type: 'richtext',\n  required: true,\n  label: 'Richtext Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "description": "Payload.RichTextField configuration object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field, used as the property name in the database"
+      },
+      "type": {
+        "type": "string",
+        "enum": [
+          "richtext"
+        ],
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      },
+      "admin": {
+        "type": "object",
+        "description": "Admin panel configuration for this field",
+        "properties": {
+          "description": {
+            "type": "string",
+            "description": "Additional description shown in the admin UI"
+          },
+          "position": {
+            "type": "string",
+            "enum": [
+              "sidebar"
+            ],
+            "description": "Position of the field in the admin UI"
+          },
+          "width": {
+            "type": "string",
+            "description": "Width of the field in the admin UI"
+          },
+          "style": {
+            "type": "object",
+            "description": "Custom CSS styles for the field"
+          },
+          "className": {
+            "type": "string",
+            "description": "CSS class name for the field"
+          },
+          "readOnly": {
+            "type": "boolean",
+            "description": "Whether the field is read-only in the admin UI"
+          },
+          "hidden": {
+            "type": "boolean",
+            "description": "Whether the field is hidden in the admin UI"
+          },
+          "condition": {
+            "type": "string",
+            "description": "Condition for showing/hiding the field"
+          }
+        }
+      },
+      "validate": {
+        "type": "string",
+        "description": "Custom validation function that returns true if valid or an error message string if invalid"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ]
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'richText',\n  label: 'Rich Text Field', // Label shown in the admin UI\n  required: true,\n  admin: {\n    elements: ['h2', 'h3', 'link', 'ol', 'ul', 'indent'],\n    leaves: ['bold', 'italic', 'underline'],\n  },\n  // Optional: Add custom validation\n  validate: (value) => {\n    if (value && JSON.stringify(value).length < 20) {\n      return 'Please enter more content';\n    }\n    return true; // Return true if valid\n  },\n}"
+}

package/dist/mcp/generated/tools/createSelectField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createSelectField",
+  "description": "Creates a Payload CMS 3.0 SelectField configuration\n\nExample:\n```typescript\n{\n  name: 'status',\n  type: 'select',\n  required: true,\n  label: 'Status',\n  options: [\n    { label: 'Draft', value: 'draft' },\n    { label: 'Published', value: 'published' },\n    { label: 'Archived', value: 'archived' }\n  ],\n  defaultValue: 'draft',\n  // Custom validation example\n  validate: (value, { siblingData }) => {\n    if (value === 'published' && !siblingData.publishedAt) {\n      return 'Cannot set status to published without a publish date';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'select',\n  label: 'Select Field', // Label shown in the admin UI\n  required: true,\n  options: [\n    { label: 'Option 1', value: 'option1' },\n    { label: 'Option 2', value: 'option2' },\n    { label: 'Option 3', value: 'option3' }\n  ],\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Select one option from the list'\n  }\n}"
+}

package/dist/mcp/generated/tools/createSingleRelationshipField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createSingleRelationshipField",
+  "description": "Creates a Payload CMS 3.0 SingleRelationshipField configuration\n\nExample:\n```typescript\n{\n  name: 'singlerelationshipField',\n  type: 'singlerelationship',\n  required: true,\n  label: 'Singlerelationship Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'relationship',\n  label: 'Relationship Field', // Label shown in the admin UI\n  required: true,\n  relationTo: 'collection-name', // Replace with your collection slug\n  hasMany: false, // Set to true for multiple relationships\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Select a related document'\n  }\n}"
+}

package/dist/mcp/generated/tools/createTextField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createTextField",
+  "description": "Creates a Payload CMS 3.0 TextField configuration\n\nExample:\n```typescript\n{\n  name: 'title',\n  type: 'text',\n  required: true,\n  label: 'Post Title',\n  minLength: 10,\n  maxLength: 100,\n  // Custom validation example\n  validate: (value, { siblingData }) => {\n    if (value && value.toLowerCase().includes('forbidden')) {\n      return 'Title cannot contain the word \"forbidden\"';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'text',\n  label: 'Text Field', // Label shown in the admin UI\n  required: true,\n  minLength: 2,\n  maxLength: 100,\n  // Optional: Add custom validation\n  validate: (value, { siblingData }) => {\n    if (value && value.toLowerCase().includes('forbidden')) {\n      return 'This field cannot contain the word \"forbidden\"';\n    }\n    return true; // Return true if valid\n  },\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Enter text content here',\n    position: 'sidebar',\n    width: '50%',\n    readOnly: false,\n    hidden: false\n  }\n}"
+}

package/dist/mcp/generated/tools/createTextareaField.json

@@ -0,0 +1,87 @@
+{
+  "name": "createTextareaField",
+  "description": "Creates a Payload CMS 3.0 TextareaField configuration\n\nExample:\n```typescript\n{\n  name: 'textareaField',\n  type: 'textarea',\n  required: true,\n  label: 'Textarea Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "description": "Payload.TextareaField configuration object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field, used as the property name in the database"
+      },
+      "type": {
+        "type": "string",
+        "enum": [
+          "textarea"
+        ],
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      },
+      "admin": {
+        "type": "object",
+        "description": "Admin panel configuration for this field",
+        "properties": {
+          "description": {
+            "type": "string",
+            "description": "Additional description shown in the admin UI"
+          },
+          "position": {
+            "type": "string",
+            "enum": [
+              "sidebar"
+            ],
+            "description": "Position of the field in the admin UI"
+          },
+          "width": {
+            "type": "string",
+            "description": "Width of the field in the admin UI"
+          },
+          "style": {
+            "type": "object",
+            "description": "Custom CSS styles for the field"
+          },
+          "className": {
+            "type": "string",
+            "description": "CSS class name for the field"
+          },
+          "readOnly": {
+            "type": "boolean",
+            "description": "Whether the field is read-only in the admin UI"
+          },
+          "hidden": {
+            "type": "boolean",
+            "description": "Whether the field is hidden in the admin UI"
+          },
+          "condition": {
+            "type": "string",
+            "description": "Condition for showing/hiding the field"
+          }
+        }
+      },
+      "minLength": {
+        "type": "number",
+        "description": "Minimum length of the text"
+      },
+      "maxLength": {
+        "type": "number",
+        "description": "Maximum length of the text"
+      },
+      "validate": {
+        "type": "string",
+        "description": "Custom validation function that returns true if valid or an error message string if invalid"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ]
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'textarea',\n  label: 'Textarea Field', // Label shown in the admin UI\n  required: true,\n  minLength: 2,\n  maxLength: 500,\n  // Optional: Admin UI configuration\n  admin: {\n    description: 'Enter longer text content here'\n  }\n}"
+}

package/dist/mcp/generated/tools/createUploadField.json

@@ -0,0 +1,31 @@
+{
+  "name": "createUploadField",
+  "description": "Creates a Payload CMS 3.0 UploadField configuration\n\nExample:\n```typescript\n{\n  name: 'uploadField',\n  type: 'upload',\n  required: true,\n  label: 'Upload Field',\n  // Custom validation example\n  validate: (value, { siblingData, operation }) => {\n    // Validation logic based on the value, sibling data, or operation\n    if (operation === 'create' && !value) {\n      return 'This field is required for new records';\n    }\n    return true;\n  }\n}\n```",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "The name of the field"
+      },
+      "type": {
+        "type": "string",
+        "description": "The type of field"
+      },
+      "label": {
+        "type": "string",
+        "description": "The label shown in the admin UI"
+      },
+      "required": {
+        "type": "boolean",
+        "description": "Whether this field is required"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "description": "Field configuration"
+  },
+  "template": "{\n  name: '{name}', // Database field name\n  type: 'upload',\n  label: 'Upload Field', // Label shown in the admin UI\n  relationTo: 'media', // The collection to upload to\n  required: true,\n  // Optional: Add custom validation\n  validate: (value) => {\n    if (!value) {\n      return 'Please upload a file';\n    }\n    return true; // Return true if valid\n  },\n}"
+}

package/dist/mcp/handler.d.ts

@@ -0,0 +1,6 @@
+import { MCPRequest, MCPResponse, MCPError, MCPToolCall, MCPToolResult, MCPTool } from './types.js';
+export declare function processRequest(request: MCPRequest, sessionId?: string): Promise<MCPResponse | MCPError>;
+export declare function registerTool(tool: MCPTool): void;
+export declare function executeTool(toolCall: MCPToolCall, sessionId: string): Promise<MCPToolResult | MCPError>;
+export declare function getAvailableTools(): MCPTool[];
+export declare function validateMessage(message: unknown): boolean;