Skip to main content
Glama

Metadata MCP Connector

Create Campaign — Precision Optimization (1×1×1)

create_campaign

Create a draft campaign using Precision Optimization (1x1x1), with a separate experiment for each configured audience, ad, and offer combination. Supports LinkedIn, Facebook, Instagram, Google Ads, Reddit, Microsoft Ads, and X (Twitter: image ads and landing page offers only; launching needs X connected, and a launched X campaign is view-only). Ads are attached individually through ads.list; ads.groups creates named Metadata platform ad groups only when the user asks for them, each with at least two distinct compatible ads (the same ad type on LinkedIn) and a name of at most 50 characters. Returns the draft campaign and channel configuration or validation errors. This tool does not launch it.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "campaign_data": "<campaign_data>"
    },
    "name": "create_campaign"
  }
}

Input Schema

NameRequiredDescriptionDefault
campaign_dataYesComplete campaign configuration data

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / campaign_data / properties / google / description
      Previous value: -"Google Ads campaign configuration"New value: +"Google Ads Search campaign configuration (keywords and text ads). This tool does not build Performance Max or Display campaigns."
  2. Changed1 schema field changed
    • addedInput schema / properties / campaign_data / properties / x
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "X (Twitter) campaign configuration: audiences or target groups, image ads and landing page offers. X takes no objective or bid here (its launch sets them), launching needs X connected, and once launched an X campaign is view-only.",
      +  "properties": {
      +    "ads": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "groups": {
      +          "description": "Named Metadata platform ad groups, ONLY when explicitly requested. Each group needs at least two distinct X ads. Names are capped at 50 characters.",
      +          "items": {
      +            "properties": {
      +              "ads": {
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "name": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "name",
      +              "ads"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "list": {
      +          "description": "Array of X ad IDs (from create_update_image_ad with channels=['X']), attached individually. Default unless the user explicitly asks for grouped ads.",
      +          "items": {
      +            "type": "integer"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "audiences": {
      +      "description": "Array of X audience names: firmographic, technographic, intent, store leads, contact or account CSV uploads, website retargeting contacts, marketing automation lists, HubSpot account lists and dynamic Salesforce lists (the types the platform UI offers for X). Audiences native to another channel (LinkedIn, Facebook, Display, or another channel's retargeting), static Salesforce or G2 Intent lists and Express Firmographic cannot go to X. An audience exists on X only after the platform has uploaded it to a CONNECTED X account, and it blocks the launch until it is READY with at least 100 matched users.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "dailyBudget": {
      +      "description": "Daily budget in USD for this channel (platform minimum $10). Applied through the platform's own channel budget endpoint; without it the channel keeps the platform default of $50/day. Derive from the approved split (e.g. monthly channel budget / 30, rounded to cents).",
      +      "minimum": 10,
      +      "type": "number"
      +    },
      +    "offers": {
      +      "description": "Array of offer IDs for X. MUST contain ONLY Landing Page offer_ids: X has no Lead Gen forms, and the X card clicks through to the landing page (plus UTMs). A Lead Gen offer_id is refused and reported in errors.",
      +      "items": {
      +        "type": "integer"
      +      },
      +      "type": "array"
      +    },
      +    "target_groups": {
      +      "description": "Array of Targeting Group names for X: groups built for X in the platform's Targeting Groups section, whose interests, keywords and locations the X launch reads. These are NOT audiences.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "ads",
      +    "offers"
      +  ],
      +  "type": "object"
      +}
  3. Changed3 schema fields changed
    • addedInput schema / properties / campaign_data / properties / linkedin / properties / ads / properties / groups
      Added value: +{
      +  "description": "Named Metadata platform ad groups for Precision/METADATA campaigns, ONLY when explicitly requested. Each group needs at least two distinct compatible LinkedIn ads of the same type. Names are capped at 50 characters. These are not native LinkedIn campaign groups or Channel-First containers. May be combined with list.",
      +  "items": {
      +    "properties": {
      +      "ads": {
      +        "items": {
      +          "type": "integer"
      +        },
      +        "type": "array"
      +      },
      +      "name": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "name",
      +      "ads"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / campaign_data / properties / linkedin / properties / ads / properties / list / description
      Previous value: -"Array of ad IDs for LinkedIn, each sent as its own request. This is the default way to attach ads. LinkedIn has no ad-group concept, so all LinkedIn ads go here."New value: +"Array of LinkedIn ad IDs, attached individually. Default unless the user explicitly asks for grouped ads. May be combined with groups."
    • changedInput schema / properties / campaign_data / properties / reddit / properties / ads / properties / list / description
      Previous value: -"Array of Reddit ad IDs (from create_update_image_ad / create_update_video_ad with channels=['REDDIT']), each sent as its own request. Like LinkedIn, Reddit uses list only — no ad groups."New value: +"Array of Reddit ad IDs (from create_update_image_ad / create_update_video_ad with channels=['REDDIT']), attached individually. Reddit uses list only — no ad groups in this tool."
  4. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources