meta_list_pixel_events

List the events that a Meta Pixel received in the last 7 days.

Ask whether an event fires before an ad set optimizes for it. An ad set that optimizes for an event that never fires gets no delivery.

Does the Northwind Web Pixel send StartTrial?

The agent calls meta_list_pixel_events with the id of the Pixel. You see each event name with its count over the last 7 days, and the hour of its last event. The counts are the ones that Meta reports for the Pixel. Meta keeps 7 days of events, so a smaller window is possible and a larger one is not. Change what runs on Meta shows where this step comes in the job.

Reference

Available on:

List the events that one Meta Pixel received in the last days days (1 to 7, default 7): one row per event name, with its count and lastSeenAt. Call this before you create an ad set that optimizes for an event. Confirm that the event fires. An ad set that optimizes for an event that never fires gets no delivery. The counts are the ones that Meta reports for the Pixel. Meta keeps 7 days of events, and the top 100 event names of each hour. The Pixel must be a Pixel of the advertiser: find its id with meta_list_pixels. The answer has no page.

Input

Argument	Type	Required	Description
`advertiserId`	string	yes	Advertiser account ID (`acc_<id>`). Must belong to the active organization — find one with `list_advertisers`.
`days`	integer, 1 to 7	no	The days to read, back from now: 1 to 7. The default is 7, all the days that Meta keeps. Default: `7`.
`pixelId`	string	yes	The Meta id of the Pixel, digits only. Find it with `meta_list_pixels`.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`events`	array of object	yes	One row for each event name that the Pixel received in the window, the greatest `count` first. An empty list means that the Pixel received no event in the window.
`events[].count`	integer	yes	The number of events of this name in the window.
`events[].event`	string	yes	The event name, as the Pixel sends it: `PageView`, `StartTrial`. The standard event `StartTrial` is the `customEventType` `START_TRIAL` of `meta_create_adset`.
`events[].lastSeenAt`	string	yes	The start of the last hour with an event of this name, as Meta writes it (ISO 8601).

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
provider_not_connected
provider_error
organization_unentitled
forbidden
invalid_request
internal_error

Scope

The token must hold observe:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Read-only. The tool changes nothing.
Open world. The tool reaches a system outside AdCrunch, such as an ad platform.

Example

The arguments:

{
  "advertiserId": "acc_1485443900032333",
  "pixelId": "812345678901234"
}

The result, in structuredContent:

{
  "events": [
    {
      "count": 4210,
      "event": "PageView",
      "lastSeenAt": "2026-09-24T08:00:00+0000"
    },
    {
      "count": 37,
      "event": "StartTrial",
      "lastSeenAt": "2026-09-24T07:00:00+0000"
    },
    {
      "count": 5,
      "event": "Purchase",
      "lastSeenAt": "2026-09-23T16:00:00+0000"
    }
  ]
}