Skip to main content

Set up and run IQM Model Context Protocol (MCP)

Connect IQM MCP to Claude or ChatGPT, then run your first prompts to manage operations across the campaign lifecycle.

Written by Team IQM

On this page:

IQM MCP overview

Model Context Protocol (MCP) provides a standardized way for AI applications to connect with external tools and services. With MCP, an AI assistant can access capabilities made available by an MCP server, then use those capabilities to retrieve information or perform supported action.

IQM MCP extends this approach to the IQM platform. It brings specific platform capabilities into an AI-assisted workflow to offer an alternative method for managing your campaign workflow. This approach minimizes the need to toggle between apps to perform supported platform operations. Instead, you can perform supported tasks directly via Claude’s or ChatGPT’s chat interface.

Refer to IQM Model Context Protocol (MCP) overview for more information, including supported actions and eligibility details.

IQM MCP setup

More on third-party eligibility requirements: IQM MCP is supported via Claude and ChatGPT. You can sign up for a free account directly with either AI-assistant provider.

You can set up IQM MCP via custom connectors (Claude) or custom plugins (ChatGPT via developer mode).

Connect to Claude - Video tutorial

More on the MCP server URL: This video tutorial includes a step to add the MCP server URL during setup. Refer to step 8 of Connect to Claude - Written instructions to copy the URL to your clipboard.

Connect to Claude - Written instructions

Follow these steps to connect IQM MCP to your Claude account:

  1. Visit https://claude.ai/new to navigate to Claude and open a new chat.

  2. Select + to open the options menu.

  3. Hover over Connectors.

  4. Click Manage connectors from the Connectors menu. This will open the Connectors pop-up window.

  5. Open the + Add menu.

  6. Select Add custom connector. This will open the Add custom connector pop-up window.

    1. If your Claude account is a corporate organization account, you may need to ask an organization owner to add this capability for your team.

  7. Enter IQM MCP in the Name field.

  8. Enter https://mcp.iqm.com/v1/iqm/mcp in the MCP server URL field.

  9. Click Continue.

  10. In the Authentication section, select Sign in now.

  11. In the OAuth client section, select Use Claude’s published identity.

  12. Click Add. This will close the Add custom connector pop-up window.

  13. Select Connect. This will redirect you to a page that confirms whether you’d like to grant Claude access to IQM MCP.

  14. Click Allow access to confirm your selection. This will redirect you to the IQM MCP Server page.

  15. Enter your IQM platform login credentials.

  16. Select Login. This will authenticate your account and redirect you to the Your connectors page, where IQM MCP now appears connected.

  17. Confirm that setup was successful.

    1. Open a new chat.

    2. Select + to open the options menu.

    3. Hover over Connectors.

    4. Locate IQM MCP and check that the toggle switch is turned on.

Connect to ChatGPT - Written instructions

Follow these steps to connect IQM MCP to your ChatGPT account:

  1. Visit https://chatgpt.com/ to navigate to ChatGPT and open a new chat.

  2. Click your profile name or initials.

  3. Select Settings. This will open the General pop-up window.

  4. Click Security and login from the left-side panel.

  5. Scroll to the Developer mode section and enable Developer mode.

    1. If your ChatGPT account is a corporate organization account (e.g., Business, Enterprise), you may need to ask an organization owner to add this capability for your team.

  6. Select Plugins. This will redirect you to the Plugins page.

  7. Click +. This will open the New Plugin pop-up window.

  8. Enter IQM MCP in the Name field.

  9. Enter https://mcp.iqm.com/v1/iqm/mcp in the Connection field.

  10. Review any warnings and disclaimers, then select the I understand and want to continue checkbox to agree.

  11. Click Create.

  12. Select Connect from the IQM MCP page. This will open the Add IQM MCP to ChatGPT pop-up window.

  13. Click Sign in with IQM MCP. This will redirect you to a page that confirms whether you’d like to grant ChatGPT access to IQM MCP.

  14. Click Allow access to confirm your selection. This will redirect you to the IQM MCP Server page.

  15. Enter your IQM platform login credentials.

  16. Select Login. This will authenticate your account and redirect you to the Your connectors page, where IQM MCP now appears connected.

Run IQM MCP

Refer to the example text prompts and tutorial videos below to get started with IQM MCP, and review IQM Model Context Protocol (MCP) overview to reference all actions that are supported via IQM MCP.

Example text prompts

Optimization (Bid Model)

More on Bid Modeling: A Bid Model is the set of rules that you apply to a campaign to optimize its performance. These rules allow you to adjust bids, allocate budgets, and shift priorities for supported dimensions. Refer to Bid Model overview to learn more about Bid Modeling, including eligibility requirements, components (Spend Ratio, Priority, Bid Modifier) and supported dimensions.

Outcome

Prompt

Example

Creates a table of modeled items for a specified campaign and dimension

“Show me the modeled items for Campaign [Campaign ID] and [dimension name(s)], with the details in a table format.”

“Show me the modeled items for Campaign 123 and the creative dimensions with the details in a table format.”

Creates a table of supported Bid Model dimensions, with descriptions and targeting examples

“Show me a list of Bid Model dimensions.”

“Show me a list of Bid Model dimensions.”

Removes modeling from the specified item

“Remove modeling from the [dimension details] [dimension].”

“Remove modeling from the “barcelona-skyline” creative.”

Sets new modeling rules for the specified item

“Set or update modeling for [dimension details] [dimension]: [bid model settings].”

“Set modeling for the “barcelona-skyline” creative: Spend Ratio 10, Priority 4.”

Creates a new dimension bundle

“Show me how to create a new bundle.”

“Show me how to create a new bundle.”

Adds items to an existing dimension bundle

“Add [dimension details] to [bundle details].”

“Add the “barcelona-skyline” creative to bundle 1387.”

Analysis (Reports)

Outcome

Prompt

Example

Creates a report with the specified dimensions and metrics for a given date range

“Create a report with [dimensions and metrics] from [date range].”

“Create a report with impressions, clicks, and spent details by campaign from August 1, 2026 to August 31, 2026.”

Executes an existing report

“Run report [report ID #].”

“Run report 2015.”

Updates an existing report

“Update [report ID #]: remove [dimensions and metrics] and add [dimensions and metrics], and set the date range to [date range].”

“Update report 2015: remove clicks and add conversions, and set the date range to September 1, 2026 to September 30, 2026.”

Review and management (Dashboard)

Outcome

Prompt

Example

Updates a campaign’s budget

“Update campaign [campaign ID]’s [budget type] budget to [value].”

“Update campaign 537599’s daily budget to $4,000.”

“Update campaign 537599’s total budget to $50,000.”

Lists all existing dashboards that are accessible by the logged-in account

“List all dashboards.”

“List all dashboards.”

Deletes a dashboard

“Delete the [dashboard name] dashboard.”

“Delete the Dashboard V2 dashboard.”

Lists and organizes the requested details

“List all [items], sorted by [dimension or metric] in [descending/ascending order].”

“List all campaigns.”

“List all IOs.”

“List all campaigns within IO 4599.”

“List all campaigns within IO 4599, sorted by total budget in descending order.”

Example video tutorials

Create campaigns in bulk

Locate additional IQM MCP resources:

Did this answer your question?