@umbraco-cms/mcp-dev 18.0.2 → 18.1.0

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: {
@@ -1418,6 +1464,27 @@ export interface UpdateDocumentInput {
   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 {
   /**
    * The unique identifier of the document to update
@@ -3284,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 {
@@ -4144,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;
@@ -4196,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
@@ -4927,6 +5078,7 @@ export interface GetManifestManifestOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -4938,6 +5090,7 @@ export interface GetManifestManifestPrivateOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -4949,6 +5102,7 @@ export interface GetManifestManifestPublicOutput {
     name: string;
     id?: string | null;
     version?: string | null;
+    cacheBuster?: string | null;
     extensions: unknown[];
   }[];
 }
@@ -13589,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[];
 }
@@ -16069,10 +16236,6 @@ export interface GetRedirectStatusOutput {
   userIsAdmin: boolean;
 }
 
-export interface UpdateRedirectStatusInput {
-  status?: "Enabled" | "Disabled";
-}
-
 export interface GetRelationByRelationTypeIdInput {
   id: string;
   /**
@@ -17322,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: {
@@ -17967,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 };
@@ -17981,8 +18185,11 @@ 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 };
@@ -18042,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 };
@@ -18063,10 +18271,12 @@ 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 };
@@ -18131,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 };
@@ -18232,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 };
@@ -18305,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.2",
+  "version": "18.1.0",
   "type": "module",
   "description": "A model context protocol (MCP) server for Umbraco CMS",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
     "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",
@@ -72,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",
@@ -86,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",