MCP creative tutorial
Use IQM Model Context Protocol (MCP) to interact with the Creative API.
Overview
This tutorial guides you through using IQM MCP to access and manage creatives in the Creative app. You learn how to retrieve creative details, upload new creatives, and update existing creatives using the MCP interface.
Before you begin
To upload a creative 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
- Image, Video, Audio, HTML, VAST, DAAST, CSV, or XLSX file to upload a creative
File requirements for creative file:
- 2MB for JPG, JPEG, PNG
- 750KB for GIF
- 400MB for MOV, MP4
- 100MB for MP3, WAV, OGG, MPEG
For more information on VAST and DAAST XML format specifications, see IAB Tech Lab's documentation.
Sample CSV file: https://app.iqm.com/creatives/example-files/sample_html_creatives.csv
About IQM creatives
The IQM APIs provide access to upload a creative in Image, Video, Audio, HTML, XLSX, or CSV formats. The APIs can be used to connect to the desired applications.
More resources
- Creatives and specifications Help Center article
- Creative API guidelines
- Upload a creative quickstart guide
Upload a creative
To upload a creative using IQM MCP, you can either prompt Claude to upload a specified file or have Claude search for a file in the designated directory. Try these prompts:
| Prompt | Response example | Notes |
|---|---|---|
| I want to upload a new creative | MCP asks what type of creative and which source the creative comes from. | |
| Show me available files to upload | MCP asks for access to the designated directory, searches the directory, and lists available files for upload. | |
| Upload the file IQM-LOGO-RGB with the name: IQM Logo 001 | MCP prompts for other required creative details. | |
| Use iqm.com for the click url and 300x250 for dimensions |
Assign creative to campaign
After uploading the creative, you can assign it to a campaign using IQM MCP. Use the following prompt:
| Prompt | Response example | Notes |
|---|---|---|
| Let's assign the creative you just uploaded to a campaign | MCP gets a list of campaigns to which a creative can be assigned. | |
| Assign the creative to campaign "cmp test" |
More creative actions
You can use IQM MCP to perform various actions related to creatives, such as retrieving creative details, updating existing creatives, and deleting creatives. Here are some example prompts:
| Prompt | Response example | Notes |
|---|---|---|
| Show me a list of creatives | tip Prompt for the results to be returned "in a simple table." | |
| Update creative "test b" to have name "Creative 005" | ||
| Delete creative "Creative 005" |
Tools index
The table below lists the tools that MCP uses in this tutorial, with links to their API documentation. For every Creative API tool available in MCP, see the Creative API section of the Tools index.
| Tool name | Description | Documentation |
|---|---|---|
file_manager | Upload a creative file to the MCP session | |
create_creatives | Create a creative from the uploaded file | Add new creative |
getCampaignBasicDetailList | Paginated list with rich filters (type, status, IO, creative type) | Get basic details of campaigns |
createCampaignCreativeTargeting | Bulk assign or unassign creatives to campaigns | Update creative targeting in campaigns |
getCreatives_1 | Get a list of creatives and their details | Get list of creatives and details |
updateCreative | Update the details of an existing creative | Update creative details |
updateCreativeStatus | Update a creative's status | Update creative status |
Video demo
Follow along with this video demo of the creative tutorial: