cloudinary-mcp-server

Instructions

Implementation Reference

• src/tools/deleteAssetTool.js:34-67 (handler)

  Core handler function that deletes a Cloudinary asset by publicId (using api.delete_resources) or assetId (using custom DELETE /resources endpoint), handles errors, and returns success/error messages.

  const deleteAssetTool = async (cloudinary, { publicId, assetId }) => {
  	try {
  		let result;
  
  		if (!publicId && !assetId) {
  			throw new Error(`Must provide either publicId or assetId to delete`);
  		}
  
  		if (publicId) {
  			// Delete by public ID using Cloudinary API
  			result = await cloudinary.api.delete_resources(publicId);
  			if (!result || result?.deleted[publicId] === "not_found") {
  				return getToolError(`Failed to delete asset with publicId: '${publicId}' - not_found`, cloudinary);
  			}
  		} else {
  			// Delete by asset ID using /resources endpoint
  			result = await deleteWithAssetId([assetId]);
  
  			if (!result.ok) {
  				return getToolError(`Failed to delete asset with assetId: '${assetId}' - ${result.error.message}`, cloudinary);
  			}
  		}
  
  		return {
  			content: [{
  				type: "text",
  				text: `Successfully deleted asset: '${publicId || assetId}'`
  			}],
  			isError: false,
  		};
  	} catch (error) {
  		return getToolError(`Error deleting asset: ${error.message}`, cloudinary);
  	}
  };

• src/tools/deleteAssetTool.js:5-8 (schema)

  Zod schema defining optional publicId or assetId parameters for the delete-asset tool.

  export const deleteAssetToolParams = {
  	publicId: z.string().optional().describe("The public ID of the asset to delete"),
  	assetId: z.string().optional().describe("The asset ID of the asset to delete")
  };

• src/index.js:47-52 (registration)

  Registers the 'delete-asset' tool on the MCP server with name, description, schema, and wrapped handler.

  server.tool(
  	"delete-asset",
  	"Delete a file (asset) from Cloudinary",
  	deleteAssetToolParams,
  	getDeleteTool(cloudinary),
  );

• src/tools/deleteAssetTool.js:10-32 (helper)

  Helper function to delete one or more assets by assetId(s) using direct fetch to Cloudinary's /resources DELETE endpoint.

  const deleteWithAssetId = (assetIds) => {
  	const config = cloudinary.config();
  
  	if (!assetIds || !Array.isArray(assetIds) || assetIds.length === 0) {
  		return Promise.reject(new Error('You must provide an array of asset IDs'));
  	}
  
  	// Format asset_ids[] parameters according to the API requirements
  	const formData = new URLSearchParams();
  	assetIds.forEach(id => formData.append('asset_ids[]', id));
  
  	// Build the request URL
  	const apiUrl = `https://api.cloudinary.com/v1_1/${config.cloud_name}/resources`;
  
  	return fetch(apiUrl, {
  		method: 'DELETE',
  		headers: {
  			'Authorization': `Basic ${Buffer.from(`${config.api_key}:${config.api_secret}`).toString('base64')}`,
  			'Content-Type': 'application/x-www-form-urlencoded'
  		},
  		body: formData.toString()
  	});
  }