`meta_ads_get_ad_creative_report`

Get Meta Ads Creative Performance Report

Description

Ad-level performance report with full funnel metrics. All conversion types shown individually. Supports two grouping modes: ad_name (default, aggregates ads sharing the same name with a representative ad_id for preview) and ad_id (one row per ad). The representative ad_id can be passed to meta_ads_preview_ads. Always fetches fresh data.

Read-onlyIdempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_get_ad_creative_report",
    "arguments": {
      "account_id": "act_123",
      "time_range": {
        "since": "2024-01-01",
        "until": "2024-01-31"
      },
      "reason": "Review individual ad performance"
    }
  }
}

hopkin meta ad-creative-report get

Flag	Type	Required	Description
`--account`	`string`	Required	Meta ad account ID
`--time-range`	`object`	Required	Required date range {since, until} in YYYY-MM-DD
`--level`	`string`	Optional	Grouping level: ad_name (default, aggregate ads sharing the same name, providing a representative ad_id that can be passed to meta_ads_preview_ads) or ad_id (one row per ad)
`--time-increment`	`unknown`	Optional	Time grouping: 1=daily, 7=weekly, or "monthly"
`--breakdowns`	`array`	Optional	Segment by dimension. Pass multiple values for cross-tabulated rows (e.g. ["age","gender"] → one row per "35-44 / female" segment). Available: age, gender, country, region, device_platform, publisher_platform, platform_position, impression_device, dma
`--filtering`	`array`	Optional	Filters as [{field, operator, value}]

{
  "mcpServers": {
    "meta-ads": {
      "url": "https://mcp.hopkin.ai/meta-ads/mcp",
      "transport": "sse"
    }
  }
}

All ads by ID
Aggregate by creative name
Filter by campaign
Creative names by demographics

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Meta ad account IDminLength: 1
`time_range`	`object`	Required	Required date range {since, until} in YYYY-MM-DD
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (4)

Name	Type	Required	Description
`level`	`string`	Optional	Grouping level: ad_name (default, aggregate ads sharing the same name, providing a representative ad_id that can be passed to meta_ads_preview_ads) or ad_id (one row per ad) `ad_id` `ad_name`
`time_increment`	`unknown`	Optional	Time grouping: 1=daily, 7=weekly, or "monthly"
`breakdowns`	`array`	Optional	Segment by dimension. Pass multiple values for cross-tabulated rows (e.g. ["age","gender"] → one row per "35-44 / female" segment). Available: age, gender, country, region, device_platform, publisher_platform, platform_position, impression_device, dma
`filtering`	`array`	Optional	Filters as [{field, operator, value}]

Examples

All ads by ID

{
  "account_id": "act_123",
  "time_range": {
    "since": "2024-01-01",
    "until": "2024-01-31"
  },
  "reason": "Review individual ad performance"
}

hopkin meta ad-creative-report get --account act_123 --time-range [object Object]

Aggregate by creative name

{
  "account_id": "act_123",
  "time_range": {
    "since": "2024-01-01",
    "until": "2024-01-31"
  },
  "level": "ad_name",
  "reason": "Compare creative variants running across multiple ad sets"
}

hopkin meta ad-creative-report get --account act_123 --time-range [object Object] --level ad_name

Filter by campaign

{
  "account_id": "act_123",
  "time_range": {
    "since": "2024-01-01",
    "until": "2024-01-31"
  },
  "level": "ad_name",
  "filtering": [
    {
      "field": "campaign.id",
      "operator": "IN",
      "value": [
        "111111111"
      ]
    }
  ],
  "reason": "Creative performance within a specific campaign"
}

hopkin meta ad-creative-report get --account act_123 --time-range [object Object] --level ad_name --filtering [object Object]

Creative names by demographics

{
  "account_id": "act_123",
  "time_range": {
    "since": "2024-01-01",
    "until": "2024-01-31"
  },
  "level": "ad_name",
  "breakdowns": [
    "age",
    "gender"
  ],
  "reason": "Understand which creatives perform best per demographic"
}

hopkin meta ad-creative-report get --account act_123 --time-range [object Object] --level ad_name --breakdowns age,gender