Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/ads_meta_report.md

# ads_meta_report

Read a 1–31-day Meta account report, with explicit source and metrics. Missing metrics stay missing; summed ratio totals, placeholder costs, overlapping actions and lead-only conversions are labelled. Not product activation or global attribution. Read guides/ads-reporting. No paid change or connection change is executed.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: reads data or returns an account-screen link.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "adAccountId": "act_123456789",
  "sourceType": "INTEGRATION",
  "startDate": "2026-10-01",
  "endDate": "2026-10-07",
  "fields": [
    "impressions",
    "clicks",
    "spend"
  ],
  "groupBy": "day"
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "adAccountId": {
      "type": "string",
      "pattern": "^act_[0-9]{1,40}$"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "AD_MANAGER",
        "INTEGRATION"
      ]
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "fields": {
      "default": [
        "impressions",
        "clicks",
        "spend"
      ],
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "impressions",
          "clicks",
          "spend",
          "cpc",
          "cost_per_conversion",
          "conversions",
          "results",
          "cost_per_result",
          "cpm",
          "reach",
          "frequency",
          "ctr"
        ]
      }
    },
    "groupBy": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ]
    }
  },
  "required": [
    "adAccountId",
    "sourceType",
    "startDate",
    "endDate"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [ads-reporting](https://docs.creator.gg/guides/ads-reporting.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)
