meta_create_ad_study

Create a Meta A/B test (split test) comparing 2 to 10 cells of campaigns or ad sets of this ad account, with each cell's share of the audience summing to 100.

View as Markdown

Create a Meta A/B test (split test) comparing 2 to 10 cells of campaigns or ad sets of this ad account, with each cell's share of the audience summing to 100. Created on the ad account's Business; the campaigns keep their own status and budgets, so paused campaigns spend nothing. Conversion Lift studies are set up with Meta and are not created here. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Source: Meta Ads
Kind: Write
Discovery: Reachable through search_tools and run_write_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/meta-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`adAccountId`	string	Required	Selected owning ad account ID, with or without act_. Every referenced ad object must belong to it.
`name`	string	Required	Exact business name to give this object. Do not derive it from an uploaded filename.
`description`	string	Optional	What the test compares.
`level`	string	Required	What each cell holds: campaigns or ad sets of this ad account. One of: `campaigns`, `adsets`.
`startTime`	string	Required	Start of the test, ISO 8601 with UTC offset, in the future.
`endTime`	string	Required	End of the test, ISO 8601 with UTC offset, after the start.
`cells`	array	Required	The cells; their shares sum to 100 and no entity is in two cells.
`confirm`	boolean	Optional	Apply only when true. Default is a local preview with no API mutation.
`validateOnly`	boolean	Optional	Ask Meta to validate, without creating or changing an object. Mutually exclusive with confirm.

Calling it

json · Through run_write_tool, since it is not announced

{
  "name": "run_write_tool",
  "arguments": {
    "name": "meta_create_ad_study",
    "args": {
      "adAccountId": "<string>",
      "name": "<string>",
      "level": "campaigns",
      "startTime": "<string>",
      "endTime": "<string>",
      "cells": "<array>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.