Pega DX MCP Server

Instructions

Implementation Reference

• src/tools/cases/delete-case.js:36-68 (handler)

  The execute method implements the core logic of the delete_case MCP tool. It validates the caseID parameter, handles session configuration, performs the deletion via pegaClient.deleteCase, and formats success/error responses.

    async execute(params) {
      const { caseID } = params;
      let sessionInfo = null;
  
      try {
        // Initialize session configuration if provided
        sessionInfo = this.initializeSessionConfig(params);
  
        // Validate required parameters using base class
      const requiredValidation = this.validateRequiredParams(params, ['caseID']);
      if (requiredValidation) {
        return requiredValidation;
      }
  
        // Execute with standardized error handling
        return await this.executeWithErrorHandling(
          `Case Deletion: ${caseID}`,
          async () => await this.pegaClient.deleteCase(caseID.trim()),
          { caseID, sessionInfo }
        );
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: `## Error: Delete Case
  
  **Unexpected Error**: ${error.message}
  
  ${sessionInfo ? `**Session**: ${sessionInfo.sessionId} (${sessionInfo.authMode} mode)\n` : ''}*Error occurred at: ${new Date().toISOString()}*`
          }]
        };
      }
    }

• src/tools/cases/delete-case.js:15-31 (schema)

  Defines the MCP tool schema including name 'delete_case', description, and inputSchema requiring 'caseID' string parameter.

  static getDefinition() {
    return {
      name: 'delete_case',
      description: 'Delete a case that is currently in the create stage',
      inputSchema: {
        type: 'object',
        properties: {
          caseID: {
            type: 'string',
            description: 'Case ID. Example: "MYORG-APP-WORK C-1001". Complete identifier including spaces.'
          },
          sessionCredentials: getSessionCredentialsSchema()
        },
        required: ['caseID']
      }
    };
  }

• src/api/pega-client.js:199-201 (helper)

  The PegaClient.deleteCase method called by the tool handler to perform the actual API deletion by routing to the appropriate version-specific client (v1 or v2).

  async deleteCase(caseID) {
    return this.client.deleteCase(caseID);
  }