---
title: meta_list_pixels
description: List the Meta Pixels installed on a Meta ad account.
---

An ad set that optimizes for conversions must name a Pixel. This lists the Pixels on the ad account so the agent can pick one instead of guessing.

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `advertiserId` | `acc_*` | yes | The Meta advertiser. Must belong to your active organization. |

## Output

`{ pixels: [{ id, name, lastFiredTime }] }`. `lastFiredTime` is `null` for a Pixel that has never fired. An empty array means the account has no Pixel.

## Example

> _"Which pixel should a conversion campaign on this account use?"_

Claude calls `meta_list_pixels({ advertiserId: 'acc_998877' })` and picks the one that fired most recently.

:::info[Prefer a pixel that has fired]

Accounts routinely carry several Pixels of which only one is live. A Pixel with no `lastFiredTime` is usually not installed on the site, and optimizing toward it will not deliver.

:::

## Errors

- `Advertiser not found for this organization` — the `acc_*` ID is unknown or belongs to another organization. Call `list_advertisers` to find one you own.
- `This advertiser has no usable Meta connection` — reconnect Meta.
- Anything Meta itself refuses is surfaced in Meta's own words, including its error subcode.
- `401` or `403` — see [Errors](/mcp/errors), which every tool shares. This one needs `observe:read`.