mcp-confluent

Instructions

Implementation Reference

• src/confluent/tools/handlers/catalog/delete-tag.ts:24-57 (handler)

  The handle method implements the core logic to delete a tag definition from Confluent Cloud Schema Registry using the REST API DELETE request.

  async handle(
    clientManager: ClientManager,
    toolArguments: Record<string, unknown>,
  ): Promise<CallToolResult> {
    const { tagName, baseUrl } = deleteTagArguments.parse(toolArguments);
  
    if (baseUrl !== undefined && baseUrl !== "") {
      clientManager.setConfluentCloudSchemaRegistryEndpoint(baseUrl);
    }
  
    const pathBasedClient = wrapAsPathBasedClient(
      clientManager.getConfluentCloudSchemaRegistryRestClient(),
    );
  
    const { response, error } = await pathBasedClient[
      "/catalog/v1/types/tagdefs/{tagName}"
    ].DELETE({
      params: {
        path: {
          tagName: tagName,
        },
      },
    });
  
    if (error) {
      return this.createResponse(
        `Failed to delete tag: ${JSON.stringify(error)}`,
        true,
      );
    }
    return this.createResponse(
      `Successfully deleted tag: ${tagName}. Status: ${response?.status}`,
    );
  }

• src/confluent/tools/handlers/catalog/delete-tag.ts:13-21 (schema)

  Zod input schema for the delete-tag tool defining parameters: optional baseUrl (Schema Registry endpoint) and required tagName.

  const deleteTagArguments = z.object({
    baseUrl: z
      .string()
      .describe("The base URL of the Schema Registry REST API.")
      .url()
      .default(() => env.SCHEMA_REGISTRY_ENDPOINT ?? "")
      .optional(),
    tagName: z.string().describe("Name of the tag to delete").nonempty(),
  });

• src/confluent/tools/tool-factory.ts:56-56 (registration)

  Registers the DeleteTagHandler in the ToolFactory's static handlers Map using the ToolName.DELETE_TAG key.

  [ToolName.DELETE_TAG, new DeleteTagHandler()],

• src/confluent/tools/tool-name.ts:18-18 (helper)

  Defines the tool name constant 'delete-tag' in the ToolName enum, used for registration and identification.

  DELETE_TAG = "delete-tag",