Pega DX MCP Server

Instructions

Implementation Reference

• src/tools/tags/delete-case-tag.js:40-67 (handler)

  The execute method that performs the tool's core logic: validates inputs, initializes session, handles errors, and calls pegaClient.deleteCaseTag to delete the tag from the case.

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

• src/tools/tags/delete-case-tag.js:15-35 (schema)

  Static method providing the tool definition for MCP protocol, including name 'delete_case_tag', description, and input schema requiring caseID and tagID.

  static getDefinition() {
    return {
      name: 'delete_case_tag', 
      description: 'Delete a specific tag from a case by case ID and tag ID',
      inputSchema: {
        type: 'object',
        properties: {
          caseID: {
            type: 'string',
            description: 'Case ID. Example: "MYORG-APP-WORK C-1001". Complete identifier including spaces."OSIEO3-DOCSAPP-WORK T-561003". a complete case identifier including spaces and special characters.'
          },
          tagID: {
            type: 'string',
            description: 'Tag ID to be deleted from the case. This is the unique identifier of the specific tag to remove.'
          },
          sessionCredentials: getSessionCredentialsSchema()
        },
        required: ['caseID', 'tagID']
      }
    };
  }

• src/api/pega-client.js:927-932 (helper)

  PegaClient wrapper for deleting a case tag, checks if 'tags' feature is available, then delegates to the underlying client implementation.

  async deleteCaseTag(caseID, tagID) {
    if (!this.isFeatureAvailable('tags')) {
      this.throwUnsupportedFeatureError('tags', 'deleteCaseTag');
    }
    return this.client.deleteCaseTag(caseID, tagID);
  }