Meta Ads / API Reference
meta_ads_list_ads
Meta Ads tool. List all ads with their IDs, creative IDs, adset IDs, campaign IDs, and status. Args: account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env. campaign_id: Filter by campaign ID. Leave blank for all. adset_id: Filter by adset ID. Leave blank for all. status_filter: ACTIVE, PAUSED, ARCHIVED, or ALL. Default ALL.
This is a read-only tool: it lists ads from 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:
List ads in my Meta Ads account.
It takes 0 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | No | Account Id |
campaign_id | string | No | Campaign Id |
adset_id | string | No | Adset Id |
status_filter | string | No | Status Filter |
Related Meta Ads tools
meta_ads_list_ad_accountsmeta_ads_list_adsetsmeta_ads_list_automated_rulesmeta_ads_list_campaignsmeta_ads_list_catalog_productsmeta_ads_list_creative_assets
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: