| name | mads-cli |
| description | Meta/Facebook/Instagram Ads campaign management via mads-cli — Marketing API campaigns/ad sets/ads/creatives/audiences, Business Manager, Pixel and Conversions API (CAPI), and Commerce/Catalog. Trigger on mentions of Facebook Ads, Instagram Ads, Meta Ads, Business Manager, Pixel, or CAPI.
|
mads-cli
mads is the CLI for managing Meta (Facebook/Instagram) Ads. Its knowledge base lives in
mads-cli/kb/ (sister to gads-cli/kb/ for Google Ads).
Discovery first
Before assuming any command shape, run discovery — do not guess flags or subcommands:
mads catalog --json — full machine-readable manifest of every implemented command, its
params, and help text. This is the ground truth for what mads can actually do today; the CLI
is fully wired (verified live via mads catalog --json, 2026-07-02): 82 commands across 25
groups, including dedicated campaign/adset/ad/creative resource commands (CRUD +
status/budget), plus audience, commerce, capi, insights, abtest, business, page,
webhook, and analyze (5 read-only checks) — alongside the core auth, query,
mutate/batch-mutate, snapshot, log, catalog, db, changelog, decisions,
milestones commands.mads kb list — mirrors the gads-cli kb command-group convention (kb list / kb show /
kb check) for surfacing the KB files below. Not yet implemented in mads-cli as of this
writing (see the TODO(mads-cli) block in mads_lib/cli.py) — until it lands, read the KB
files directly instead of assuming the command exists.
Deep API reference (read on demand, not preloaded)
kb/marketing-api.md — Campaigns, Ad Sets, Ads, Creatives, Custom/Lookalike Audiences, Ad
Studies (the core Marketing API resources you mutate/query).kb/graph-api.md — Business Manager, System Users, Pages, Webhooks (account/asset plumbing
outside the Marketing API proper).kb/conversions-api.md — Server-side Conversions API (CAPI), Pixel/Dataset management,
deduplication, Dataset Quality API.kb/commerce-catalog.md — Commerce Manager Catalog & Product API (product feeds, items,
ratings-and-reviews).
kb/manifest.json and kb/INDEX.md index all four with current version, base URL, OAuth scopes,
and status. Read the specific KB file for the resource you're touching before writing code against
it — do not rely on training-data knowledge of the Meta Marketing API, which changes frequently.
Operating directive: run it yourself
Execute mads commands yourself — snapshot, mutate, log — rather than handing the user
copy-paste commands to run. The user's involvement is limited to the irreducible minimum:
only steps a script genuinely cannot perform, such as the browser click in an interactive
OAuth consent flow (see Gotcha #7/#8 in AGENTS.md) or another physical/off-system action.
For those unavoidable human steps, still do everything around them — run the local flow,
generate and hand over the exact URL/action needed, then verify the result yourself.
Default to action over instruction.
Sister tool
For Google Ads, Google Business Profile (GBP), Google Merchant Center, GA4, and Google Search
Console, see the sister CLI gads-cli: https://github.com/talas9/gads-cli
(skill: gads-cli/.agents/skills/gads-cli/SKILL.md)
