@umbraco-cms/mcp-dev 18.0.1 → 18.1.0-rc

package/dist/tool-types.d.ts

@@ -1186,6 +1186,36 @@ export interface CreateDocumentOutput {
   id: string;
 }
 
+export interface CreateAndPublishDocumentInput {
+  documentTypeId: string;
+  parentId?: string;
+  name: string;
+  /**
+   * Optional template ID to apply to the document. If omitted, the document type's default template is applied automatically. Provide a value only when you need a specific allowed template other than the default.
+   */
+  templateId?: string;
+  /**
+   * Array of culture codes. If not provided or empty array, will create single variant with null culture.
+   */
+  cultures?: string[];
+  /**
+   * Culture codes to publish immediately after creation. Must contain real culture codes only - wildcards ("*") and nulls are rejected by Umbraco. If omitted, defaults to publishing every culture in the cultures array, or an empty array (which publishes the single invariant variant) when the document type does not vary by culture.
+   */
+  culturesToPublish?: string[];
+  values: {
+    editorAlias: string;
+    culture: string | null;
+    segment: string | null;
+    alias: string;
+    value: unknown;
+  }[];
+}
+
+export interface CreateAndPublishDocumentOutput {
+  message: string;
+  id: string;
+}
+
 export interface PostDocumentPublicAccessInput {
   id: string;
   data: {
@@ -1214,6 +1244,7 @@ export interface DeleteDocumentRecycleBinItemInput {
 
 export interface GetDocumentUrlsInput {
   id?: string[];
+  culture?: string;
 }
 
 export interface GetDocumentUrlsOutput {
@@ -1387,6 +1418,21 @@ export interface SortDocumentInput {
   }[];
 }
 
+export interface SortDocumentChildrenInput {
+  id: string;
+  data: {
+    culture?: string | null;
+    field: "Name" | "CreateDate" | "UpdateDate";
+    direction: "Ascending" | "Descending";
+  };
+}
+
+export interface SortDocumentRootChildrenInput {
+  culture?: string | null;
+  field: "Name" | "CreateDate" | "UpdateDate";
+  direction: "Ascending" | "Descending";
+}
+
 export interface UnpublishDocumentInput {
   id: string;
   data: {
@@ -1412,6 +1458,31 @@ export interface UpdateDocumentInput {
       name: string;
     }[];
   };
+  /**
+   * Must be set to true to proceed when 'data.values' is an empty array and the document currently has property values. Without this, the call is rejected to prevent accidentally wiping every property value - the exact mistake that motivated this guard. Not needed if the document has no existing values, or if 'data.values' is non-empty.
+   */
+  confirmClearValues?: boolean;
+}
+
+export interface UpdateAndPublishDocumentInput {
+  id: string;
+  data: {
+    culturesToPublish: string[];
+    template?: null | {
+      id: string;
+    };
+    values: {
+      culture?: string | null;
+      segment?: string | null;
+      alias: string;
+      value?: unknown;
+    }[];
+    variants: {
+      culture?: string | null;
+      segment?: string | null;
+      name: string;
+    }[];
+  };
 }
 
 export interface UpdateDocumentPropertiesInput {
@@ -1477,6 +1548,35 @@ export interface UpdateDocumentPropertiesOutput {
   };
 }
 
+export interface UpdateDocumentNameInput {
+  /**
+   * The unique identifier of the document to rename
+   */
+  id: string;
+  /**
+   * The new name for the document (or the document variant matching the given culture)
+   */
+  name: string;
+  /**
+   * Optional culture code identifying which variant to rename (e.g., 'en-US'). Required when the document varies by culture and has more than one variant; omit for invariant documents.
+   */
+  culture?: string | null;
+}
+
+export interface UpdateDocumentNameOutput {
+  success: boolean;
+  message: string;
+  previousName: string;
+  name: string;
+  culture: string | null;
+  /**
+   * The updated document object
+   */
+  document: {
+    [k: string]: unknown;
+  };
+}
+
 export interface UpdateBlockPropertyInput {
   /**
    * The document containing the block
@@ -3251,6 +3351,47 @@ export interface GetElementByIdOutput {
   }[];
 }
 
+export interface GetElementPublishedInput {
+  id: string;
+}
+
+export interface GetElementPublishedOutput {
+  isTrashed: boolean;
+  documentType: {
+    id: string;
+    icon: string;
+    collection?: null | {
+      id: string;
+    };
+  };
+  id: string;
+  flags: {
+    alias: string;
+  }[];
+  values: {
+    editorAlias: string;
+    culture?: string | null;
+    segment?: string | null;
+    alias: string;
+    value?: unknown;
+  }[];
+  variants: {
+    id: string;
+    flags: {
+      alias: string;
+    }[];
+    state: "NotCreated" | "Draft" | "Published" | "PublishedPendingChanges" | "Trashed";
+    publishDate?: string | null;
+    scheduledPublishDate?: string | null;
+    scheduledUnpublishDate?: string | null;
+    createDate: string;
+    updateDate: string;
+    culture?: string | null;
+    segment?: string | null;
+    name: string;
+  }[];
+}
+
 export interface GetElementConfigurationInput {}
 
 export interface GetElementConfigurationOutput {
@@ -4111,6 +4252,31 @@ export interface CreateElementOutput {
   id: string;
 }
 
+export interface CreateAndPublishElementInput {
+  documentTypeId: string;
+  parentId?: string;
+  name: string;
+  /**
+   * Array of culture codes. If not provided or empty array, will create single variant with null culture.
+   */
+  cultures?: string[];
+  /**
+   * Culture codes to publish immediately after creation. Must contain real culture codes only - wildcards ("*") and nulls are rejected by Umbraco. If omitted, defaults to publishing every culture in the cultures array, or an empty array (which publishes the single invariant variant) when the element type does not vary by culture.
+   */
+  culturesToPublish?: string[];
+  values: {
+    culture: string | null;
+    segment: string | null;
+    alias: string;
+    value: unknown;
+  }[];
+}
+
+export interface CreateAndPublishElementOutput {
+  message: string;
+  id: string;
+}
+
 export interface CopyElementInput {
   parentId?: string;
   idToCopy: string;
@@ -4163,6 +4329,24 @@ export interface UpdateElementInput {
   };
 }
 
+export interface UpdateAndPublishElementInput {
+  id: string;
+  data: {
+    culturesToPublish: string[];
+    values: {
+      culture?: string | null;
+      segment?: string | null;
+      alias: string;
+      value?: unknown;
+    }[];
+    variants: {
+      culture?: string | null;
+      segment?: string | null;
+      name: string;
+    }[];
+  };
+}
+
 export interface UpdateElementPropertiesInput {
   /**
    * The unique identifier of the element to update
@@ -4226,6 +4410,152 @@ export interface UpdateElementPropertiesOutput {
   };
 }
 
+export interface UpdateElementBlockPropertyInput {
+  /**
+   * The element containing the block
+   */
+  elementId: string;
+  /**
+   * Element property alias containing BlockList/BlockGrid
+   */
+  propertyAlias: string;
+  /**
+   * Optional culture for variant element properties
+   */
+  culture?: string | null;
+  /**
+   * Optional segment for variant element properties
+   */
+  segment?: string | null;
+  /**
+   * Array of block updates
+   *
+   * @minItems 1
+   */
+  updates: [
+    {
+      /**
+       * The unique key (UUID) identifying the block
+       */
+      contentKey: string;
+      /**
+       * 'content' for contentData, 'settings' for settingsData
+       */
+      blockType: "content" | "settings";
+      /**
+       * Properties to update within this block
+       *
+       * @minItems 1
+       */
+      properties: [
+        {
+          /**
+           * The property alias within the block to update
+           */
+          alias: string;
+          /**
+           * The new value for the property
+           */
+          value?: unknown | null;
+          /**
+           * Optional culture code for variant block properties
+           */
+          culture?: string | null;
+          /**
+           * Optional segment identifier for variant block properties
+           */
+          segment?: string | null;
+        },
+        ...{
+          /**
+           * The property alias within the block to update
+           */
+          alias: string;
+          /**
+           * The new value for the property
+           */
+          value?: unknown | null;
+          /**
+           * Optional culture code for variant block properties
+           */
+          culture?: string | null;
+          /**
+           * Optional segment identifier for variant block properties
+           */
+          segment?: string | null;
+        }[]
+      ];
+    },
+    ...{
+      /**
+       * The unique key (UUID) identifying the block
+       */
+      contentKey: string;
+      /**
+       * 'content' for contentData, 'settings' for settingsData
+       */
+      blockType: "content" | "settings";
+      /**
+       * Properties to update within this block
+       *
+       * @minItems 1
+       */
+      properties: [
+        {
+          /**
+           * The property alias within the block to update
+           */
+          alias: string;
+          /**
+           * The new value for the property
+           */
+          value?: unknown | null;
+          /**
+           * Optional culture code for variant block properties
+           */
+          culture?: string | null;
+          /**
+           * Optional segment identifier for variant block properties
+           */
+          segment?: string | null;
+        },
+        ...{
+          /**
+           * The property alias within the block to update
+           */
+          alias: string;
+          /**
+           * The new value for the property
+           */
+          value?: unknown | null;
+          /**
+           * Optional culture code for variant block properties
+           */
+          culture?: string | null;
+          /**
+           * Optional segment identifier for variant block properties
+           */
+          segment?: string | null;
+        }[]
+      ];
+    }[]
+  ];
+}
+
+export interface UpdateElementBlockPropertyOutput {
+  success: boolean;
+  message: string;
+  results: {
+    success: boolean;
+    contentKey: string;
+    message: string;
+    updatedCount?: number;
+    addedCount?: number;
+    warnings?: string[];
+    errors?: string[];
+  }[];
+}
+
 export interface MoveElementInput {
   id: string;
   data: {
@@ -4748,6 +5078,7 @@ export interface GetManifestManifestOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -4759,6 +5090,7 @@ export interface GetManifestManifestPrivateOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -4770,6 +5102,7 @@ export interface GetManifestManifestPublicOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -13410,6 +13743,19 @@ export interface SortMediaInput {
   }[];
 }
 
+export interface SortMediaChildrenInput {
+  id: string;
+  data: {
+    field: "Name" | "CreateDate" | "UpdateDate";
+    direction: "Ascending" | "Descending";
+  };
+}
+
+export interface SortMediaRootChildrenInput {
+  field: "Name" | "CreateDate" | "UpdateDate";
+  direction: "Ascending" | "Descending";
+}
+
 export interface GetMediaByIdArrayInput {
   id?: string[];
 }
@@ -15890,10 +16236,6 @@ export interface GetRedirectStatusOutput {
   userIsAdmin: boolean;
 }
 
-export interface UpdateRedirectStatusInput {
-  status?: "Enabled" | "Disabled";
-}
-
 export interface GetRelationByRelationTypeIdInput {
   id: string;
   /**
@@ -17143,6 +17485,46 @@ export interface GetUserByIdCalculateStartNodesOutput {
   hasElementRootAccess: boolean;
 }
 
+export interface GetUserBatchInput {
+  id?: string[];
+}
+
+export interface GetUserBatchOutput {
+  total: number;
+  items: {
+    id: string;
+    languageIsoCode?: string | null;
+    documentStartNodeIds: {
+      id: string;
+    }[];
+    hasDocumentRootAccess: boolean;
+    mediaStartNodeIds: {
+      id: string;
+    }[];
+    hasMediaRootAccess: boolean;
+    elementStartNodeIds: {
+      id: string;
+    }[];
+    hasElementRootAccess: boolean;
+    avatarUrls: string[];
+    state: "Active" | "Disabled" | "LockedOut" | "Invited" | "Inactive" | "All";
+    failedLoginAttempts: number;
+    createDate: string;
+    updateDate: string;
+    lastLoginDate?: string | null;
+    lastLockoutDate?: string | null;
+    lastPasswordChangeDate?: string | null;
+    isAdmin: boolean;
+    kind: "Default" | "Api";
+    email: string;
+    userName: string;
+    name: string;
+    userGroupIds: {
+      id: string;
+    }[];
+  }[];
+}
+
 export interface UploadUserAvatarByIdInput {
   id: string;
   file: {
@@ -17788,6 +18170,7 @@ export interface CmsTools {
   "get-document-type-schema": { input: GetDocumentTypeSchemaInput; output: GetDocumentTypeSchemaOutput };
   "copy-document": { input: CopyDocumentInput; output: CopyDocumentOutput };
   "create-document": { input: CreateDocumentInput; output: CreateDocumentOutput };
+  "create-and-publish-document": { input: CreateAndPublishDocumentInput; output: CreateAndPublishDocumentOutput };
   "post-document-public-access": { input: PostDocumentPublicAccessInput; output: unknown };
   "delete-document": { input: DeleteDocumentInput; output: unknown };
   "delete-document-public-access": { input: DeleteDocumentPublicAccessInput; output: unknown };
@@ -17802,9 +18185,13 @@ export interface CmsTools {
   "publish-document": { input: PublishDocumentInput; output: unknown };
   "publish-document-with-descendants": { input: PublishDocumentWithDescendantsInput; output: unknown };
   "sort-document": { input: SortDocumentInput; output: unknown };
+  "sort-document-children": { input: SortDocumentChildrenInput; output: unknown };
+  "sort-document-root-children": { input: SortDocumentRootChildrenInput; output: unknown };
   "unpublish-document": { input: UnpublishDocumentInput; output: unknown };
   "update-document": { input: UpdateDocumentInput; output: unknown };
+  "update-and-publish-document": { input: UpdateAndPublishDocumentInput; output: unknown };
   "update-document-properties": { input: UpdateDocumentPropertiesInput; output: UpdateDocumentPropertiesOutput };
+  "update-document-name": { input: UpdateDocumentNameInput; output: UpdateDocumentNameOutput };
   "update-block-property": { input: UpdateBlockPropertyInput; output: UpdateBlockPropertyOutput };
   "put-document-domains": { input: PutDocumentDomainsInput; output: unknown };
   "put-document-notifications": { input: PutDocumentNotificationsInput; output: unknown };
@@ -17862,6 +18249,7 @@ export interface CmsTools {
   "update-document-version-prevent-cleanup": { input: UpdateDocumentVersionPreventCleanupInput; output: unknown };
   "create-document-version-rollback": { input: CreateDocumentVersionRollbackInput; output: unknown };
   "get-element-by-id": { input: GetElementByIdInput; output: GetElementByIdOutput };
+  "get-element-published": { input: GetElementPublishedInput; output: GetElementPublishedOutput };
   "get-element-configuration": { input: GetElementConfigurationInput; output: GetElementConfigurationOutput };
   "get-element-audit-log": { input: GetElementAuditLogInput; output: GetElementAuditLogOutput };
   "get-element-are-referenced": { input: GetElementAreReferencedInput; output: GetElementAreReferencedOutput };
@@ -17883,11 +18271,14 @@ export interface CmsTools {
   "get-recycle-bin-element-children": { input: GetRecycleBinElementChildrenInput; output: GetRecycleBinElementChildrenOutput };
   "get-recycle-bin-element-siblings": { input: GetRecycleBinElementSiblingsInput; output: GetRecycleBinElementSiblingsOutput };
   "create-element": { input: CreateElementInput; output: CreateElementOutput };
+  "create-and-publish-element": { input: CreateAndPublishElementInput; output: CreateAndPublishElementOutput };
   "copy-element": { input: CopyElementInput; output: CopyElementOutput };
   "validate-element": { input: ValidateElementInput; output: unknown };
   "rollback-element-version": { input: RollbackElementVersionInput; output: unknown };
   "update-element": { input: UpdateElementInput; output: unknown };
+  "update-and-publish-element": { input: UpdateAndPublishElementInput; output: unknown };
   "update-element-properties": { input: UpdateElementPropertiesInput; output: UpdateElementPropertiesOutput };
+  "update-element-block-property": { input: UpdateElementBlockPropertyInput; output: UpdateElementBlockPropertyOutput };
   "move-element": { input: MoveElementInput; output: unknown };
   "move-element-to-recycle-bin": { input: MoveElementToRecycleBinInput; output: unknown };
   "publish-element": { input: PublishElementInput; output: unknown };
@@ -17950,6 +18341,8 @@ export interface CmsTools {
   "validate-media": { input: ValidateMediaInput; output: unknown };
   "validate-media-update": { input: ValidateMediaUpdateInput; output: unknown };
   "sort-media": { input: SortMediaInput; output: unknown };
+  "sort-media-children": { input: SortMediaChildrenInput; output: unknown };
+  "sort-media-root-children": { input: SortMediaRootChildrenInput; output: unknown };
   "get-media-by-id-array": { input: GetMediaByIdArrayInput; output: GetMediaByIdArrayOutput };
   "move-media": { input: MoveMediaInput; output: unknown };
   "get-media-audit-log": { input: GetMediaAuditLogInput; output: GetMediaAuditLogOutput };
@@ -18051,7 +18444,6 @@ export interface CmsTools {
   "get-redirect-by-id": { input: GetRedirectByIdInput; output: GetRedirectByIdOutput };
   "delete-redirect": { input: DeleteRedirectInput; output: unknown };
   "get-redirect-status": { input: GetRedirectStatusInput; output: GetRedirectStatusOutput };
-  "update-redirect-status": { input: UpdateRedirectStatusInput; output: unknown };
   "get-relation-by-relation-type-id": { input: GetRelationByRelationTypeIdInput; output: GetRelationByRelationTypeIdOutput };
   "get-relation-type": { input: GetRelationTypeInput; output: GetRelationTypeOutput };
   "get-relation-type-by-id": { input: GetRelationTypeByIdInput; output: GetRelationTypeByIdOutput };
@@ -18124,6 +18516,7 @@ export interface CmsTools {
   "get-item-user": { input: GetItemUserInput; output: GetItemUserOutput };
   "get-user-configuration": { input: GetUserConfigurationInput; output: GetUserConfigurationOutput };
   "get-user-by-id-calculate-start-nodes": { input: GetUserByIdCalculateStartNodesInput; output: GetUserByIdCalculateStartNodesOutput };
+  "get-user-batch": { input: GetUserBatchInput; output: GetUserBatchOutput };
   "upload-user-avatar-by-id": { input: UploadUserAvatarByIdInput; output: unknown };
   "delete-user-avatar-by-id": { input: DeleteUserAvatarByIdInput; output: unknown };
   "create-user-data": { input: CreateUserDataInput; output: CreateUserDataOutput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbraco-cms/mcp-dev",
-  "version": "18.0.1",
+  "version": "18.1.0-rc",
   "type": "module",
   "description": "A model context protocol (MCP) server for Umbraco CMS",
   "main": "dist/index.js",
@@ -25,8 +25,11 @@
     "compile": "tsc --noEmit",
     "watch": "tsup --config tsup.config.ts --watch",
     "generate": "orval --config orval.config.ts",
-    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector@1 node dist/index.js",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:all": "npm run build && npm run test && npm run test:evals",
+    "test:one": "node --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --forceExit",
+    "test:changed": "node scripts/test-changed.mjs",
     "test:rerun-failures": "grep '^FAIL ' test-failures.log 2>/dev/null | sed 's/^FAIL //' | tr '\\n' ' ' | xargs -r node --experimental-vm-modules node_modules/jest/bin/jest.js --no-coverage || echo 'No failures to rerun (test-failures.log not found or empty)'",
     "test:evals": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-coverage --config tests/evals/jest.config.ts",
     "patch-publish-alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha --access public",
@@ -36,6 +39,7 @@
     "test:e2e": "npx playwright test --config tests/cms-hosted-e2e/playwright.config.ts",
     "umbraco:bootstrap": "bash scripts/bootstrap-demo-site.sh",
     "umbraco:start": "bash scripts/bootstrap-demo-site.sh && dotnet run --project demo-site",
+    "start:umbraco": "npm run umbraco:start",
     "umbraco:stop": "lsof -ti :44391 | xargs kill 2>/dev/null; lsof -ti :56472 | xargs kill 2>/dev/null",
     "dev:hosted": "wrangler dev"
   },
@@ -68,8 +72,8 @@
     "@modelcontextprotocol/sdk": "^1.28.0",
     "@types/uuid": "^10.0.0",
     "@types/yargs": "^17.0.33",
-    "@umbraco-cms/mcp-hosted": "^1.0.0-beta.31",
-    "@umbraco-cms/mcp-server-sdk": "^1.0.0-beta.31",
+    "@umbraco-cms/mcp-hosted": "^1.0.0-beta.35",
+    "@umbraco-cms/mcp-server-sdk": "^1.0.0-beta.35",
     "dotenv": "^16.5.0",
     "form-data": "^4.0.4",
     "mime-types": "^3.0.1",
@@ -82,6 +86,7 @@
     "@anthropic-ai/claude-agent-sdk": "0.2.39",
     "@cloudflare/workers-oauth-provider": "^0.2.3",
     "@jest/types": "^29.6.3",
+    "@modelcontextprotocol/inspector": "^1.0.1",
     "@playwright/test": "^1.58.2",
     "@types/dotenv": "^6.1.1",
     "@types/jest": "^29.5.14",