Pega DX MCP Server

import { BaseTool } from '../../registry/base-tool.js'; import { getSessionCredentialsSchema } from '../../utils/tool-schema.js'; export class GetParticipantRoleDetailsTool extends BaseTool { /** * Get the category this tool belongs to */ static getCategory() { return 'participants'; } /** * Get tool definition for MCP protocol */ static getDefinition() { return { name: 'get_participant_role_details', description: 'Get detailed information about a specific participant role in a Pega case, including role configuration, permissions, and user details. Returns participant role metadata with optional UI resources.', inputSchema: { type: 'object', properties: { caseID: { type: 'string', description: 'Case ID. Example: "MYORG-APP-WORK C-1001". Complete identifier including spaces."ON6E5R-DIYRecipe-Work-RecipeCollection R-1008". a complete case identifier including spaces and special characters.' }, participantRoleID: { type: 'string', description: 'Participant role ID to get details for. This identifies the specific role within the case that you want detailed information about.' }, viewType: { type: 'string', enum: ['form', 'none'], description: 'UI resources to return. "form" returns form UI metadata in uiResources object, "none" returns no UI resources. Default: "form".', default: 'form' }, sessionCredentials: getSessionCredentialsSchema() }, required: ['caseID', 'participantRoleID'] } }; } /** * Execute the get participant role details operation */ async execute(params) { const { caseID, participantRoleID, viewType } = params; let sessionInfo = null; try { sessionInfo = this.initializeSessionConfig(params); // Validate required parameters using base class const requiredValidation = this.validateRequiredParams(params, ['caseID', 'participantRoleID']); if (requiredValidation) { return requiredValidation; } // Validate enum parameters using base class const enumValidation = this.validateEnumParams(params, { viewType: ['form', 'none'] }); if (enumValidation) { return enumValidation; } // Execute with standardized error handling return await this.executeWithErrorHandling( `Participant Role Details: ${caseID} / ${participantRoleID}`, async () => await this.pegaClient.getParticipantRoleDetails(caseID.trim(), participantRoleID.trim(), { viewType }), { caseID: caseID.trim(), participantRoleID: participantRoleID.trim(), viewType, sessionInfo } ); } catch (error) { return { content: [{ type: 'text', text: `## Error: Participant Role Details: ${caseID} / ${participantRoleID}\n\n**Unexpected Error**: ${error.message}\n\n${sessionInfo ? `**Session**: ${sessionInfo.sessionId} (${sessionInfo.authMode} mode)\n` : ''}*Error occurred at: ${new Date().toISOString()}*` }] }; } } }