MCP assets tutorial
Use IQM Model Context Protocol (MCP) to interact with the Asset API.
Overview
This tutorial guides you through using IQM MCP to access and manage assets with the Asset API. You'll learn how to retrieve asset details, upload new assets, and update existing assets using the MCP interface.
Before you begin
To upload an asset using IQM MCP, the following are required:
- An account on the IQM platform
- See Before you begin to create an account and request a Client ID and Client Secret
- A file to upload as an asset (image, video, audio, document, or ZIP)
About IQM assets
The Asset API streamlines the management and storage of media files. This service plays a critical role in handling media uploads, temporary storage, and coordination with other services for final storage and metadata management.
More resources
- Asset API guidelines
- HTML5 ZIP creatives Help Center article
Manage assets
You can use the MCP to manage assets by performing the following actions:
| Prompt | Response example | Notes |
|---|---|---|
| Show me a list of assets associated with my Workspace | ||
| I want to see the details of asset 46023 | ||
| I want to upload a new asset. It's called Youtube_Video_Thumbnail.png and it's in my downloads folder | MCP prompts the user for access to the folder containing the asset before uploading. | |
| Let's update that asset's details. Make the new URL: asset-updated-2026-march set disposable to false | MCP prompts the user to choose an asset and the parameters to update. | |
| Now delete asset 57378 |
Tools index
The table below lists the tools that MCP uses in this tutorial, with links to their API documentation. For every Asset API tool available in MCP, see the Asset API section of the Tools index.
| Tool name | Description | Documentation |
|---|---|---|
getAllAssets | Get a list of all assets in the workspace | Get a list of all assets |
getAssetDetails | Get the details of an asset by ID | Get asset details |
addAssets | Upload one or more new assets | Add multiple assets |
updateAssetDetails | Update the details of an existing asset | Update asset details |
deleteAsset | Soft-delete an asset by ID | Delete asset |
Video demo
Follow along with this video demo of the asset tutorial: