AEM MCP Server

Instructions

Implementation Reference

• dist/operations/page-operations.js:312-363 (handler)

  Core handler function that executes the page activation by posting to AEM replication endpoints (/bin/replicate.json or fallback /bin/wcmcommand). Handles parameters pagePath and activateTree.

  async activatePage(request) {
      return safeExecute(async () => {
          const { pagePath, activateTree = false } = request;
          if (!isValidContentPath(pagePath)) {
              throw createAEMError(AEM_ERROR_CODES.INVALID_PARAMETERS, `Invalid page path: ${String(pagePath)}`, { pagePath });
          }
          try {
              // Use the correct AEM replication servlet endpoint
              const formData = new URLSearchParams();
              formData.append('cmd', 'Activate');
              formData.append('path', pagePath);
              formData.append('ignoredeactivated', 'false');
              formData.append('onlymodified', 'false');
              if (activateTree) {
                  formData.append('deep', 'true');
              }
              const response = await this.httpClient.post('/bin/replicate.json', formData, {
                  headers: {
                      'Content-Type': 'application/x-www-form-urlencoded',
                  },
              });
              return createSuccessResponse({
                  success: true,
                  activatedPath: pagePath,
                  activateTree,
                  response: response.data,
                  timestamp: new Date().toISOString(),
              }, 'activatePage');
          }
          catch (error) {
              // Fallback to alternative replication methods
              try {
                  const wcmResponse = await this.httpClient.post('/bin/wcmcommand', {
                      cmd: 'activate',
                      path: pagePath,
                      ignoredeactivated: false,
                      onlymodified: false,
                  });
                  return createSuccessResponse({
                      success: true,
                      activatedPath: pagePath,
                      activateTree,
                      response: wcmResponse.data,
                      fallbackUsed: 'WCM Command',
                      timestamp: new Date().toISOString(),
                  }, 'activatePage');
              }
              catch (fallbackError) {
                  throw handleAEMHttpError(error, 'activatePage');
              }
          }
      }, 'activatePage');

• dist/mcp-server.js:324-334 (schema)

  MCP tool schema definition including input schema for parameters pagePath (required) and activateTree (optional boolean).

      name: 'activatePage',
      description: 'Activate (publish) a single page',
      inputSchema: {
          type: 'object',
          properties: {
              pagePath: { type: 'string' },
              activateTree: { type: 'boolean' },
          },
          required: ['pagePath'],
      },
  },

• dist/mcp-server.js:713-715 (registration)

  MCP server registration: the callToolRequest handler switch case that invokes aemConnector.activatePage with tool arguments.

  case 'activatePage': {
      const result = await aemConnector.activatePage(args);
      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };

• dist/aem-connector-new.js:85-86 (handler)

  Delegation handler in AEMConnector class that forwards activatePage calls to the PageOperations module.

  async activatePage(request) {
      return this.pageOps.activatePage(request);

• dist/mcp-handler.js:65-66 (handler)

  Handler in MCPRequestHandler class switch statement that dispatches to aemConnector.activatePage.

  case 'activatePage':
      return await this.aemConnector.activatePage(params);