get_meta_auction_rankings
Retrieve Meta auction-ranking labels per ad, count below-average rankings, and sort worst offenders first to flag when creative needs refreshing.
Instructions
Returns Meta's three auction-ranking labels per ad: quality_ranking, engagement_rate_ranking, conversion_rate_ranking — each one of ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE_35/20/10, or UNKNOWN. Computes below_average_count (0–3) and sorts the worst offenders to the top — 2+ below-average rankings is a creative-refresh trigger. Filters out ads under min_impressions (default 1000) since Meta only assigns labels above that volume. Same data Meta's MCP ads_insights_auction_ranking_benchmarks exposes; runs against /act_/insights at level=ad.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_meta_auction_rankings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_ids | No | Filter to specific ad IDs. | |
| client_id | No | Client identifier. | |
| campaign_ids | No | Filter to specific campaign IDs. | |
| ad_account_ids | No | Override the client's default Meta ad account IDs. | |
| date_range_end | No | YYYY-MM-DD. Defaults to today. | |
| min_impressions | No | Drop ads below this impression threshold. Default 1000 — Meta does not assign labels under ~1000 impressions/week. | |
| date_range_start | No | YYYY-MM-DD. Defaults to 30 days ago. |