list_advertisers

List the advertisers (ad accounts) in your organization, optionally filtered by provider.

Ask which ad accounts your organization has in AdCrunch, for each provider or for one provider. The agent answers with each ad account.

Which Meta ad accounts do I have in AdCrunch?

The agent lists the advertisers of your organization for Meta. You see the name, the currency and the status of each ad account, and whether it is connected. Read your accounts shows the full job.

An advertiser with connection set to not_connected has no usable connection to its provider. A tool that asks the provider now, or a change, fails on it with provider_not_connected. The stored reads still answer. To repair it, connect the provider again in the AdCrunch console. Errors gives the details.

Reference

List the ad accounts (advertisers) that the active organization owns, and say which ones are connected. Optionally filter by provider (meta, gads, tiktok, x, openai, snapchat, dv360).

Input

Argument	Type	Required	Description
`provider`	one of `meta`, `tiktok`, `snapchat`, `gads`, `dv360`, `x`, `openai`	no	Filter by ad provider. Allowed values: meta, gads, tiktok, x, openai, snapchat, dv360. Omit to return advertisers across all providers.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`advertisers`	array of object	yes	Each advertiser that the organization owns, or each one of `provider` when you send it. An empty array means that no advertiser matches.
`advertisers[].createdAt`	number	yes	When AdCrunch first stored it, in milliseconds since the Unix epoch, UTC.
`advertisers[].deletedAt`	number or null	yes	When AdCrunch marked it deleted, in milliseconds since the Unix epoch, UTC. Null when it is not deleted.
`advertisers[].updatedAt`	number or null	yes	When AdCrunch last changed it, in milliseconds since the Unix epoch, UTC. Null when it never changed.
`advertisers[].connection`	one of `connected`, `not_connected`	yes	`connected` when the organization holds a usable connection to the provider for this advertiser. `not_connected` when it holds none: a live read (`meta_list_`, `tiktok_list_`, `gads_list_*`) or a write on this advertiser fails with `provider_not_connected`. The stored reads (`list_campaigns`, `query_insights` and the others) still answer with the data that AdCrunch holds. Tell the user to reconnect the provider in the AdCrunch console.
`advertisers[].currency`	string or null	yes	The currency of the ad account, ISO 4217. Null when AdCrunch does not know it yet.
`advertisers[].id`	string	yes	The id of the advertiser: `acc_` and the id that the provider gives the ad account. The other read tools take it as `advertiserId`.
`advertisers[].name`	string	yes	The name of the ad account at the provider.
`advertisers[].provider`	one of `meta`, `tiktok`, `snapchat`, `gads`, `dv360`, `x`, `openai`	yes	The provider of the ad account.
`advertisers[].status`	one of `ACTIVE`, `DISABLED`	yes	`ACTIVE` when the provider reports the ad account as active or enabled. `DISABLED` in each other case.

Failure codes

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

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.
Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "provider": "meta"
}

The result, in structuredContent:

{
  "advertisers": [
    {
      "connection": "connected",
      "createdAt": 1780391640000,
      "currency": "EUR",
      "deletedAt": null,
      "id": "acc_1203456789012345",
      "name": "Northwind Outdoor – EU",
      "provider": "meta",
      "status": "ACTIVE",
      "updatedAt": 1790208251000
    },
    {
      "connection": "not_connected",
      "createdAt": 1780391645000,
      "currency": "USD",
      "deletedAt": null,
      "id": "acc_987654321098765",
      "name": "Northwind Outdoor – US",
      "provider": "meta",
      "status": "DISABLED",
      "updatedAt": 1790208251000
    }
  ]
}