Skip to main content

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:

  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 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​

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.

PromptResponse exampleNotes
I want to create a Pixel conversionMCP prompts user for Pixel conversion settings and creates the conversion.
I want to create a Postback conversionMCP 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.

PromptResponse exampleNotes
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.

PromptResponse exampleNotes
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 assignmentMCP 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 nameDescriptionDocumentation
addPixelConversionCreate a Pixel conversionCreate Pixel conversion
addPostbackConversionCreate a Postback conversionCreate Postback conversion
getAttachableCampaignListByConversionIdsGet campaigns that can be attached to one or more conversionsGet campaign details by conversion ID in group or basic
assignConversionToCampaignAssign a conversion to a campaignAssign conversion to a campaign
getConversionListGet a list of conversionsGet list of conversions
getListOfConversionPartnerTypeGet the list of Postback partner typesGet list of partner types for Postback conversions
getListOfConversionAttributionTypesGet the list of conversion attribution typesGet list of conversion property types
Have a question?
Was this page helpful?