Digital Products & Downloadables

This guide explains how to use the Zid MCP tools for managing digital products, downloadable files, and digital content in your Zid store. Each tool is callable from your MCP environment and supports digital product creation, file management, and secure content delivery.

1. Create Downloadable Product (mcp_Zid_action_CreateDownloadableProduct)

Purpose:
Create a new digital product that can be downloaded by customers.

Use Cases:

Sell digital products like e-books, software, or music

Create digital content for immediate delivery

Set up digital product templates

Establish digital product categories

How to Use:
Provide the required product information for the digital product.

Parameters:

nameAr (string): Product name in Arabic

nameEn (string): Product name in English

price (number): Product price

isDraft (boolean, optional): Whether product is draft (default: true)

language (string): Response language (en or ar)

Example Usage:

2. Generate Upload URL (mcp_Zid_action_GenerateUploadUrl)

Purpose:
Generate a pre-signed URL for securely uploading digital files directly to cloud storage.

Use Cases:

Upload digital files securely to cloud storage

Enable direct file uploads without server storage

Create secure file upload workflows

Prepare files for digital product association

How to Use:
Provide the productId to generate an upload URL for that digital product.

Parameters:

productId (string): The unique identifier of the product for which to generate the upload URL

language (string): Response language (en or ar)

Example Usage:

3. Create Product Downloadable (mcp_Zid_action_CreateProductDownloadable)

Purpose:
Associate a digital file with a product and create a downloadable link for customers.

Use Cases:

Link digital files to products for customer download

Create secure download links

Manage digital content delivery

Organize digital files for products

How to Use:
Provide the productId, file information, and display details.

Parameters:

productId (string): The unique identifier of the product to associate the downloadable file with

file (string): The storage key/path of the uploaded file (obtained from generate-upload-url)

displayName (string): The name of the file as it should appear to the end user

saveToLibrary (boolean, optional): Whether the downloadable file should be saved to the store's library for future use (default: true)

language (string): Response language (en or ar)

Example Usage:

4. Get Product Downloadables (mcp_Zid_GetProductDownloadables)

Purpose:
Retrieve a list of downloadable files associated with a specific product.

Use Cases:

View all downloadable files for a product

Manage multiple files for a single product

Verify file associations and access URLs

Monitor digital content organization

How to Use:
Provide the productId to get all downloadable files for that product.

Parameters:

productId (string): The unique identifier of the product to retrieve downloadable files for

language (string): Response language (en or ar)

Example Usage:

5. Delete Product Downloadable (mcp_Zid_action_DeleteProductDownloadable)

Purpose:
Remove a downloadable file association from a product.

Use Cases:

Remove outdated or incorrect file associations

Clean up digital content organization

Replace files with updated versions

Manage digital product file structure

How to Use:
Provide the productId and downloadableId to remove the file association.

Parameters:

productId (string): The unique identifier of the product

downloadableId (string): The unique identifier of the downloadable file to delete

language (string): Response language (en or ar)

Example Usage:

6. Get Store Downloadables (mcp_Zid_GetStoreDownloadables)

Purpose:
Retrieve a list of downloadable files associated with your store's library.

Use Cases:

View all digital files in your store's library

Search for specific files by name

Organize digital content across the store

Manage reusable digital assets

How to Use:
Call this tool with optional search and ordering parameters.

Parameters:

displayName (string, optional): A search keyword to filter files by their display name

ordering (string, optional): Determines the sorting order - 'file_size' orders by size, 'created_at' orders by creation date

language (string): Response language (en or ar)

Example Usage:

7. Create Store Downloadable (mcp_Zid_action_CreateStoreDownloadable)

Purpose:
Add a new downloadable file to your store's library for reuse across products.

Use Cases:

Upload reusable digital assets to store library

Create templates for digital products

Organize digital content for multiple products

Build a digital asset library

How to Use:
Provide the file information and display name.

Parameters:

file (string): The storage key/path of the uploaded file

displayName (string): The name of the file as it should appear in the library

language (string): Response language (en or ar)

Example Usage:

8. Delete Store Downloadable (mcp_Zid_action_DeleteStoreDownloadable)

Purpose:
Remove a downloadable file from your store's library.

Use Cases:

Remove outdated or unused files from library

Clean up digital asset library

Remove files that are no longer needed

Manage storage space efficiently

How to Use:
Provide the downloadableId to remove the file from the store library.

Parameters:

downloadableId (string): The unique identifier of the downloadable file to delete

language (string): Response language (en or ar)

Example Usage:

Summary Table

Tool Name	Purpose/Use Case	Key Parameters
Create Downloadable Product	Create new digital product	nameAr, nameEn, price, isDraft
Generate Upload URL	Create secure file upload URL	productId
Create Product Downloadable	Associate file with product	productId, file, displayName, saveToLibrary
Get Product Downloadables	List files for a product	productId
Delete Product Downloadable	Remove file from product	productId, downloadableId
Get Store Downloadables	List all store digital files	displayName, ordering
Create Store Downloadable	Add file to store library	file, displayName
Delete Store Downloadable	Remove file from store library	downloadableId

Best Practices for Digital Products & Downloadables

File Organization: Use clear, descriptive file names and organize files logically

Security: Use secure upload URLs and implement proper access controls

File Formats: Ensure files are in commonly supported formats for your customers

File Size: Consider file size limits and download times for customer experience

Library Management: Maintain a clean and organized digital asset library

Version Control: Keep track of file versions and update downloadable associations

Access Management: Control who can access and manage digital files

Backup Strategy: Implement proper backup procedures for digital assets

Customer Support: Provide clear instructions for downloading and using digital products

10.

Performance Optimization: Optimize file sizes and delivery methods for better performance

Digital Product Workflow Example

Here's a typical workflow for creating and managing a digital product:

This comprehensive digital products and downloadables system allows you to efficiently create, manage, and deliver digital content to your customers while maintaining secure file handling and organized digital asset management.

Digital Products & Downloadables

1. Create Downloadable Product (mcp_Zid_action_CreateDownloadableProduct)#

2. Generate Upload URL (mcp_Zid_action_GenerateUploadUrl)#

3. Create Product Downloadable (mcp_Zid_action_CreateProductDownloadable)#

4. Get Product Downloadables (mcp_Zid_GetProductDownloadables)#

5. Delete Product Downloadable (mcp_Zid_action_DeleteProductDownloadable)#

6. Get Store Downloadables (mcp_Zid_GetStoreDownloadables)#

7. Create Store Downloadable (mcp_Zid_action_CreateStoreDownloadable)#

8. Delete Store Downloadable (mcp_Zid_action_DeleteStoreDownloadable)#

Summary Table#

Best Practices for Digital Products & Downloadables#

Digital Product Workflow Example#

1. Create Downloadable Product (mcp_Zid_action_CreateDownloadableProduct)

2. Generate Upload URL (mcp_Zid_action_GenerateUploadUrl)

3. Create Product Downloadable (mcp_Zid_action_CreateProductDownloadable)

4. Get Product Downloadables (mcp_Zid_GetProductDownloadables)

5. Delete Product Downloadable (mcp_Zid_action_DeleteProductDownloadable)

6. Get Store Downloadables (mcp_Zid_GetStoreDownloadables)

7. Create Store Downloadable (mcp_Zid_action_CreateStoreDownloadable)

8. Delete Store Downloadable (mcp_Zid_action_DeleteStoreDownloadable)

Summary Table

Best Practices for Digital Products & Downloadables

Digital Product Workflow Example