meta_ads_enable_creative_intelligence

Enable Meta Creative Intelligence

Meta

Description

Turn creative intelligence on or off for a Meta ad account, or list the accounts that have it. With it on, Hopkin sweeps the account daily: every ad that spent in the last 90 days has its media mirrored, its video frames and audio extracted and its creative profiled (hook, format, pacing…), so creative questions answer in one call. Pass ad_account_id with enabled: true to enroll (starts the first sweep at once; sweep.status says whether it started) or enabled: false to stop the daily sweep (creatives already analyzed are kept). Pass neither to list the enrolled accounts on this connection under data, with last sweep status and creative counts (analyzed / processing / no_source / failed; no_source is a video whose file Meta would not hand over). Enabling is free; each newly analyzed creative costs 5 credits, charged as it is analyzed. Enrollment belongs to the connection: teammates sharing it see and can change it. Enabling needs the connection to reach the account (see meta_ads_list_ad_accounts).

Idempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_enable_creative_intelligence",
    "arguments": {}
  }
}

Parameters

NameTypeRequiredDescription
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (3)
NameTypeRequiredDescription
ad_account_id string Optional Meta ad account to turn creative intelligence on or off, e.g. "act_123456789". Pass with enabled. Omit both to list the enrolled accounts.minLength: 1, maxLength: 64, pattern: ^(act_)?\d+$
enabled boolean Optional true enrolls the account and starts its first sweep; false stops the daily sweep (creatives already analyzed are kept). Pass with ad_account_id.
connection_id string Optional Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.