Meta Ads / API Reference
meta_ads_frequency_watcher
Meta Ads tool. Monitor ad frequency across all campaigns and flag campaigns exceeding the threshold. Returns a list of at-risk campaigns with tailored recommendations: refresh_creative, reduce_budget, or pause. Args: frequency_threshold: Flag campaigns with frequency above this value. Default 3.0. start_date: Start date YYYY-MM-DD. Defaults to 14 days ago. end_date: End date YYYY-MM-DD. Defaults to today. account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env. include_paused: Include paused campaigns in the check. Default False (active only).
This is a read-only tool: it returns frequency watcher 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:
Frequency watcher in my Meta Ads account.
It takes 0 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
frequency_threshold | number | No | Frequency Threshold |
start_date | string | No | Start Date |
end_date | string | No | End Date |
account_id | string | No | Account Id |
include_paused | boolean | No | Include Paused |
Related Meta Ads tools
meta_ads_frequencymeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
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: