Meta Ads / API Reference
meta_ads_cross_account_report
Meta Ads tool. Run a performance overview across multiple ad accounts and return a unified table. Calls each account individually and merges results, then sorts by the chosen metric. Ideal for agency-level reporting across all clients in one call. Args: account_ids: Comma-separated list of ad account IDs (with or without 'act_' prefix), e.g. "act_123,456,789" (required). start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. sort_by: Metric to sort results by. Options: roas, spend, impressions, clicks, ctr, cpm. Default roas.
This is a read-only tool: it returns cross account report for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Cross account report in my Meta Ads account for [account ids].
It takes 1 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_ids | string | Yes | Account Ids |
start_date | string | No | Start Date |
end_date | string | No | End Date |
sort_by | string | No | Sort By |
Related Meta Ads tools
meta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_admeta_ads_ad_account
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: