Connect Claude to Meta Ads

List the ad accounts the signed-in user can reach, with their status, currency, time zone and lifetime spend. Call this first when you do not know which account to report on - the `id` it returns (act_1234567890) is what every other action here wants.

Fetch one ad account's configuration - name, status, currency, time zone and owning business. Read the currency and time zone from here before interpreting any spend figure or date range, because insights are reported in the account's own currency and cut on its own time zone.

Read an ad account's billing position: lifetime amount spent, the account spend cap, the outstanding balance and how it is funded, all in the account's own currency. This answers "how much has this account spent and how much room is left", which the insights actions cannot - they report delivery over a window, not the account's ledger. Amounts come back as minor units (cents) in the account currency.

List an ad account's campaigns with their objective, status, budget and bid strategy. Filter by effective_status to see only what is live - note that effective_status is Meta's resolved state (a campaign can read ACTIVE while every ad set under it is paused), whereas status is what was set on the campaign itself.

Fetch one campaign by ID, with its objective, budget, bid strategy, schedule and special ad categories. Budgets are minor units (cents) of the ad account's currency, and start_time and stop_time are read-only here - scheduling lives on the ad sets.

List an ad account's ad sets - the layer that carries the budget, the schedule, the optimisation goal and the targeting. Pass campaign_only_fields false only if you actually need the full targeting object, which is large.

List an ad account's individual ads with the ad set and campaign each belongs to, plus its review state. Use effective_status to find ads that are DISAPPROVED or WITH_ISSUES, which is the usual reason a live campaign stops delivering.

The reporting action. Run a delivery report against an ad account, a campaign, an ad set or a single ad, and break it down however you need. Pass the object's own ID as object_id - act_1234567890 for a whole account, or a campaign, ad set or ad ID. `level` decides how rows are grouped, not what is queried: object_id=act_… with level=campaign gives one row per campaign in that account. Choose a window with either date_preset or start_date and end_date together; supply neither and Meta reports its own default of the last 30 days. start_date without end_date sends no window at all, because half a range is not a range. Common metrics: impressions, clicks, spend, reach, frequency, cpc, cpm, ctr, actions, cost_per_action_type, purchase_roas. Only documented breakdown combinations are accepted; Meta rejects arbitrary ones, and video metrics cannot be combined with region or hourly breakdowns.

List the custom audiences on an ad account by name, with their approximate size band, how they were built and whether they are ready to use. Deliberately names only: this returns the audience definitions and counts, never the people in them, and Meta does not expose audience membership through this edge at all. operation_status tells you whether an audience is still building; delivery_status tells you whether it is large enough to deliver against.