delete_target_list

Remove a target list from Firewalla MSP firewall to manage network security rules and reduce attack surface by eliminating outdated or unnecessary access controls.

Instructions

Delete a target list

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Target list ID to delete (required)

Implementation Reference

src/tools/handlers/rules.ts:1755-1817 (handler)

The DeleteTargetListHandler class implements the core logic for the 'delete_target_list' tool. It validates the required 'id' parameter, calls firewalla.deleteTargetList(id), handles errors and timeouts, and returns a unified response.

export class DeleteTargetListHandler extends BaseToolHandler {
  name = 'delete_target_list';
  description = 'Delete a target list from Firewalla';
  category = 'rule' as const;

  constructor() {
    super({
      enableGeoEnrichment: false,
      enableFieldNormalization: true,
      additionalMeta: {
        data_source: 'target_lists',
        entity_type: 'target_list_deletion',
        supports_geographic_enrichment: false,
        supports_field_normalization: true,
        standardization_version: '2.0.0',
      },
    });
  }

  async execute(
    args: ToolArgs,
    firewalla: FirewallaClient
  ): Promise<ToolResponse> {
    try {
      const idValidation = ParameterValidator.validateRequiredString(
        args?.id,
        'id'
      );

      if (!idValidation.isValid) {
        return createErrorResponse(
          this.name,
          'Parameter validation failed',
          ErrorType.VALIDATION_ERROR,
          undefined,
          idValidation.errors
        );
      }

      const id = idValidation.sanitizedValue as string;

      const response = await withToolTimeout(
        async () => firewalla.deleteTargetList(id),
        this.name
      );

      return this.createUnifiedResponse(response);
    } catch (error: unknown) {
      if (error instanceof TimeoutError) {
        return createTimeoutErrorResponse(this.name, error.duration, 10000);
      }

      const errorMessage =
        error instanceof Error ? error.message : 'Unknown error occurred';
      return createErrorResponse(
        this.name,
        `Failed to delete target list: ${errorMessage}`,
        ErrorType.API_ERROR,
        { id: args?.id }
      );
    }
  }
}

src/server.ts:421-433 (schema)

MCP tool schema definition for 'delete_target_list' including input schema requiring 'id' string parameter.

  name: 'delete_target_list',
  description: 'Delete a target list',
  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'string',
        description: 'Target list ID to delete (required)',
      },
    },
    required: ['id'],
  },
},

src/tools/registry.ts:153-153 (registration)
Registration of DeleteTargetListHandler instance in the ToolRegistry during auto-registration of rule tools.
```
this.register(new DeleteTargetListHandler());
```
src/tools/registry.ts:54-56 (registration)
Import statement for DeleteTargetListHandler from rules handlers module.
```
  DeleteTargetListHandler,
  GetNetworkRulesSummaryHandler,
} from './handlers/rules.js';
```

firewalla-mcp-server