Skip to main content

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:

  1. An account on the IQM platform
    • See Before you begin to create an account and request a Client ID and Client Secret
  2. Image, Video, Audio, HTML, VAST, DAAST, CSV, or XLSX file to upload a creative
info

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​

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:

PromptResponse exampleNotes
I want to upload a new creativeMCP asks what type of creative and which source the creative comes from.
Show me available files to uploadMCP 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 001MCP 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:

PromptResponse exampleNotes
Let's assign the creative you just uploaded to a campaignMCP 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:

PromptResponse exampleNotes
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 nameDescriptionDocumentation
file_managerUpload a creative file to the MCP session
create_creativesCreate a creative from the uploaded fileAdd new creative
getCampaignBasicDetailListPaginated list with rich filters (type, status, IO, creative type)Get basic details of campaigns
createCampaignCreativeTargetingBulk assign or unassign creatives to campaignsUpdate creative targeting in campaigns
getCreatives_1Get a list of creatives and their detailsGet list of creatives and details
updateCreativeUpdate the details of an existing creativeUpdate creative details
updateCreativeStatusUpdate a creative's statusUpdate creative status

Video demo​

Follow along with this video demo of the creative tutorial:

Have a question?
Was this page helpful?