AEM MCP Server

Instructions

Implementation Reference

• src/mcp-server.ts:797-801 (handler)

  MCP tool handler for 'createVersion': extracts parameters from tool call arguments and invokes AEMConnector.createVersion, formats result as MCP response

  case 'createVersion': {
    const { path, label, comment } = args as { path: string; label?: string; comment?: string };
    const result = await aemConnector.createVersion(path, label, comment);
    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
  }

• src/mcp-server.ts:527-538 (schema)

  JSON schema defining input parameters for the createVersion tool: path (required), optional label and comment

    name: 'createVersion',
    description: 'Create a new version of content',
    inputSchema: {
      type: 'object',
      properties: {
        path: { type: 'string' },
        label: { type: 'string' },
        comment: { type: 'string' }
      },
      required: ['path'],
    },
  },

• src/operations/version-operations.ts:183-240 (handler)

  Core implementation of createVersion: validates input, checks out node, POSTs form data to AEM's /bin/wcm/versioning/createVersion endpoint with cmd=createVersion, path, optional label/comment; checks in node; constructs and returns standardized success response with version details

  async createVersion(path: string, label?: string, comment?: string): Promise<CreateVersionResponse> {
    return safeExecute<CreateVersionResponse>(async () => {
      if (!isValidContentPath(path)) {
        throw createAEMError(
          AEM_ERROR_CODES.INVALID_PARAMETERS,
          `Invalid content path: ${path}`,
          { path }
        );
      }
  
      try {
        // Check out the content first
        await this.checkOutContent(path);
  
        // Create version using AEM's versioning API
        const formData = new URLSearchParams();
        formData.append('cmd', 'createVersion');
        formData.append('path', path);
        
        if (label) {
          formData.append('label', label);
        }
        
        if (comment) {
          formData.append('comment', comment);
        }
  
        const response = await this.httpClient.post('/bin/wcm/versioning/createVersion', formData, {
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
          },
        });
  
        // Check the content back in
        await this.checkInContent(path);
  
        const versionName = response.data?.versionName || `v${Date.now()}`;
  
        this.logger.info(`Created version for path: ${path}`, {
          versionName,
          label,
          comment
        });
  
        return createSuccessResponse({
          path,
          versionName,
          label,
          comment,
          created: new Date().toISOString(),
          createdBy: this.config.serviceUser.username
        }, 'createVersion') as CreateVersionResponse;
  
      } catch (error: any) {
        throw handleAEMHttpError(error, 'createVersion');
      }
    }, 'createVersion');
  }

• src/aem-connector-new.ts:277-279 (helper)

  AEMConnector wrapper method that delegates createVersion call to the specialized VersionOperations instance

  async createVersion(path: string, label?: string, comment?: string) {
    return this.versionOps.createVersion(path, label, comment);
  }

• src/mcp-server.ts:578-580 (registration)

  Registers the listTools handler which returns the full tools array including createVersion tool definition for MCP clients to discover available tools

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools };
  });