Skip to main content

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:

  1. An account on the IQM platform
    • See Before you begin to create an account and request a Client ID and Client Secret
  2. 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​

Manage assets​

You can use the MCP to manage assets by performing the following actions:

PromptResponse exampleNotes
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 folderMCP 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 falseMCP 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 nameDescriptionDocumentation
getAllAssetsGet a list of all assets in the workspaceGet a list of all assets
getAssetDetailsGet the details of an asset by IDGet asset details
addAssetsUpload one or more new assetsAdd multiple assets
updateAssetDetailsUpdate the details of an existing assetUpdate asset details
deleteAssetSoft-delete an asset by IDDelete asset

Video demo​

Follow along with this video demo of the asset tutorial:

Have a question?
Was this page helpful?