Supervised Meta Ads Operating System for Claude Code. Create, read, update, duplicate campaigns, ad sets, and ads with validation gates, naming enforcement, and operator control.
Check Meta API token health, permissions, and rate limit status. Returns token validity, granted permissions, missing permissions, and current rate limit usage percentage.
Create a new ad set (always PAUSED, no exceptions). Runs Advantage+ audience enforcement, parent campaign inspection, ABO/CBO enforcement, ICP signal mapping, narrowing detection, pre-write validation, creates the ad set, and verifies post-write.
Create an ad with enforced identity, multi-asset support, and verification. Supports two asset modes (not mixed): - VIDEO: If 9:16 and/or 1:1 videos provided, creates ONE ad with asset_feed_spec and placement mapping. Single video = simple mode. - STATIC IMAGE: If 2+ of image_1x1_hash/image_4x5_hash/image_9x16_hash provided, creates ONE ad with asset_feed_spec and placement mapping. Single image hash not accepted here - use create_ad_creative instead. Mixed video + image is blocked. Provide one type only. INSTAGRAM GATE: Enforced via placement_mode. - full_meta (default): requires IG identity, BLOCKS if unavailable - facebook_only: explicit FB-only, no IG placements - instagram_only: requires IG identity, BLOCKS if unavailable
Discover all ad accounts, their pages, pixels, and Instagram accounts. Used to generate or update the account registry (config/accounts.yaml). Returns a comprehensive mapping of all accessible assets.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 11 | <=2025-11-25 | v2 |
Get detailed information about a specific ad account. Returns account configuration, status, spend data, pixel info, and connected assets.
List Facebook Pages available for ads on a specific ad account.
List all ad accounts accessible to the authenticated user. Returns account IDs, names, statuses, currencies, and timezones for all accounts in your business portfolio.
List ads for an account, campaign, or ad set.
Get detailed ad set information including targeting, optimization, learning stage, frequency caps, and attribution settings.
List ad sets for an account or filtered by campaign.
List Instagram accounts available for ads on a specific ad account. Returns instagram_user_id (the canonical identifier) for each account. This is the first step in the Instagram identity resolution ladder.
Check MCP setup readiness and return structured results. Validates token, permissions, account access, pages, Instagram identity, pixels, and local configuration. Returns pass/warn/fail for each check with exact fix instructions for failures. Read-only. Does not modify any configuration or Meta settings.