AEM MCP Server

Instructions

Implementation Reference

• dist/mcp-server.js:751-754 (handler)

  MCP server dispatch handler for listActiveWorkflows tool, extracts limit and calls AEMConnector
  case 'listActiveWorkflows': { const limit = args.limit; const result = await aemConnector.listActiveWorkflows(limit); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
• dist/aem-connector-new.js:204-205 (helper)

  Delegation from AEMConnector to WorkflowOperations
  async listActiveWorkflows(limit) { return this.workflowOps.listActiveWorkflows(limit);
• dist/operations/workflow-operations.js:155-189 (handler)

  Core handler logic: Queries AEM QueryBuilder for running cq:WorkflowInstance nodes and maps to response format
  async listActiveWorkflows(limit = 20) { return safeExecute(async () => { try { // Query active workflows const response = await this.httpClient.get('/bin/querybuilder.json', { params: { type: 'cq:WorkflowInstance', 'property': 'state', 'property.value': 'RUNNING', 'p.limit': limit.toString(), 'p.hits': 'full' } }); const workflows = (response.data.hits || []).map((hit) => ({ workflowId: hit.path?.split('/').pop() || hit.name, model: hit['jcr:content/model'] || hit.model, payloadPath: hit['jcr:content/payload'] || hit.payload, status: hit['jcr:content/state'] || hit.state, startedBy: hit['jcr:content/startedBy'] || hit.startedBy, startedAt: hit['jcr:content/startedAt'] || hit.startedAt, currentStep: hit['jcr:content/currentStep'] || hit.currentStep, progress: this.calculateProgressFromHit(hit) })); return createSuccessResponse({ workflows, totalCount: workflows.length, activeCount: workflows.length, completedCount: 0, failedCount: 0 }, 'listActiveWorkflows'); } catch (error) { throw handleAEMHttpError(error, 'listActiveWorkflows'); } }, 'listActiveWorkflows');
• dist/mcp-server.js:442-451 (schema)

  Input schema and metadata for the MCP tool listActiveWorkflows
  { name: 'listActiveWorkflows', description: 'List all currently running workflow instances', inputSchema: { type: 'object', properties: { limit: { type: 'number' } } }, },
• dist/mcp-server.js:567-569 (registration)

  Registration of tools list handler, which includes listActiveWorkflows schema
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });