list_ads
Retrieve and manage Meta ad campaigns, ad sets, and creatives from your ad account to monitor performance and optimize advertising strategies.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_account_id | Yes | ||
| meta_access_token | No | ||
| page_size | No | ||
| campaign_id | No | ||
| ad_set_id | No | ||
| page_cursor | No |
Implementation Reference
- The handler implementation for the list_ads tool, which fetches a list of ads for a given account, campaign, or ad set using the Meta API.
@mcp_server.tool() @meta_api_tool async def list_ads( ad_account_id: str, meta_access_token: Optional[str] = None, page_size: int = 10, campaign_id: str = "", ad_set_id: str = "", page_cursor: str = "", ) -> str: if not ad_account_id: return _json({"error": "No account ID specified"}) target_id = ad_set_id or campaign_id or ad_account_id endpoint = f"{target_id}/ads" params: Dict[str, Any] = {"fields": _AD_FIELDS, "page_size": int(page_size)} if page_cursor: params["page_cursor"] = page_cursor payload = await make_api_request(endpoint, meta_access_token, params) return _json(payload)