MCP conversion tutorial
Use IQM Model Context Protocol (MCP) to interact with the Conversion API.
Overview
This tutorial guides you through using IQM MCP to create and manage conversions with the Conversion API. You learn how to retrieve conversion details, create new conversions, and update existing conversions using the MCP interface.
Before you begin
To create a new conversion and assign it to a campaign, 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 draft campaign
About IQM conversions
IQM uses conversions as a tool to track user traffic for your campaigns.
The IQM platform supports two types of conversions:
- Pixel conversions are client-side tracking and feature advanced settings for fine-tuned optimization.
- Postback conversions are server-side.
More resources
- Conversions and tracking Help Center article
- Conversion API guidelines
Create a conversion
You can use IQM MCP to create a Pixel or Postback conversion by providing the required details and settings for each type.
| Prompt | Response example | Notes |
|---|---|---|
| I want to create a Pixel conversion | MCP prompts user for Pixel conversion settings and creates the conversion. | |
| I want to create a Postback conversion | MCP prompts user for Postback partners and click URLs. |
Attach a conversion to a campaign
Attach your new conversion to an eligible campaign by prompting MCP with the conversion and campaign IDs.
| Prompt | Response example | Notes |
|---|---|---|
| Assign conversion [ID] to campaign [ID] | MCP checks for campaigns eligible for conversion assignment and assigns the conversion to the selected campaign. |
Get conversion details
Use MCP to get details about your conversions, including their settings and which campaigns they're attached to.
| Prompt | Response example | Notes |
|---|---|---|
| Show me a list of conversions | ||
| Show me a list of available Postback partners | ||
| Show me a list of conversion attribution types | ||
| Show me a list of campaigns eligible for conversion assignment | MCP checks for campaigns eligible for conversion assignment and displays the list. |
Tools index
The table below lists the tools that MCP uses in this tutorial, with links to their API documentation. For every Conversion API tool available in MCP, see the Conversion API section of the Tools index.
| Tool name | Description | Documentation |
|---|---|---|
addPixelConversion | Create a Pixel conversion | Create Pixel conversion |
addPostbackConversion | Create a Postback conversion | Create Postback conversion |
getAttachableCampaignListByConversionIds | Get campaigns that can be attached to one or more conversions | Get campaign details by conversion ID in group or basic |
assignConversionToCampaign | Assign a conversion to a campaign | Assign conversion to a campaign |
getConversionList | Get a list of conversions | Get list of conversions |
getListOfConversionPartnerType | Get the list of Postback partner types | Get list of partner types for Postback conversions |
getListOfConversionAttributionTypes | Get the list of conversion attribution types | Get list of conversion property types |