AdAdvisor

Showing 25 of 42 from the live probe.

• List Ad Accounts

  Discover and list all Meta ad accounts the user can access — start here. This is the entry point for every session. Call this FIRST to find available ad accounts and get the ad_account_id values required by all other tools. Returns each account's name, numeric ID, platform type, business name, currency, data_synced / landed / sync_state, and pixel summary (id, name, last_fired_time, and hosts for each pixel on the account). Use the hosts to identify which pixel belongs to which website/busines

• List Pages

  List Facebook Pages reachable for advertising from this ad account. Returns each page's id, name, the connecting user's Page-role tasks (e.g. ADVERTISE, MANAGE, ANALYZE), and can_advertise. is_default marks the page create_lead_form uses when page_id is omitted. Pages are the union of the ad account's promote_pages edge and the user's /me/accounts, deduped (the same source the app's page picker uses). Prefer can_advertise=true pages. tasks are joined from /me/accounts because the promote_pages

• List Campaigns

  List campaigns — show what campaigns exist, their config and budgets. Use this to see what campaigns are running, review setup before making changes, or answer "what campaigns do I have?" questions. Returns: id, name, status, objective, daily_budget, lifetime_budget, budget_remaining, spend_cap, bid_strategy, buying_type, pacing_type, schedule. Pagination: response includes total / count / offset / has_more / next_offset. When has_more is true, call again with offset=next_offset to fetch the

• List Ad Sets

  List ad sets — show targeting, budgets, and optimization config. Use this to see what ad sets exist, review targeting and setup, or answer "what ad sets are in this campaign?" questions. Returns: id, name, campaign_id, status, targeting, daily_budget, lifetime_budget, budget_remaining, bid_amount, bid_strategy, optimization_goal, destination_type, billing_event, promoted_object, schedule, and CBO ad-set-level spend controls (daily_min_spend_target, daily_spend_cap, lifetime_min_spend_target, l

• List Ads

  List ads — show which creatives are running and their setup. Use this to see what ads exist, review creative details, or answer "what ads are in this ad set/campaign?" questions. Returns: id, name, campaign_id, adset_id, status, creative, tracking_specs, schedule. `creative` is a REFERENCE — normally just {"id": "..."} — not the creative itself. To see what the ad actually runs (its copy, media, and any lead_gen_form_id), take creative.id and call: list_creatives(account_id, creative_ids=['

• Get Performance

  Get performance metrics — how are my campaigns/ads doing? Use this to compare entities, find top or bottom performers, check spend and ROAS, or get an overview of account performance. Each row includes the ad set's primary Result (Meta Ads Manager's KPI column): result_count, result_value, cost_per_result, plus result_action_type (raw Meta event) and conversion_result_name (humanized label, e.g. "Purchase", "Subscribe", "Lead"). PREFER these when reporting performance — they reflect what the u

• Get Timeseries

  Get daily trend data — spot performance shifts day over day. Use this to see how a campaign, ad set, or ad is trending, detect when a performance change started, or compare day-over-day patterns. Each day includes the entity's primary Result (Meta Ads Manager's KPI column): result_count, result_value, cost_per_result, plus result_action_type (raw Meta event) and conversion_result_name (humanized label). PREFER these when reporting trends — they reflect what the user sees in Ads Manager. Legacy

• Change Entity Status

  Pause or resume one or more Meta campaigns, ad sets, or ads. Takes effect immediately. Live mutation — entities stop or start delivering on Meta right away. Idempotent: pausing an already-paused entity (or resuming an already-active entity) succeeds without error. Batch behavior: each entity is processed independently. A failure on one entity does not abort the others — inspect the per-item ``status`` in the returned ``results`` list. All changes are tracked with before/after state snapshots

• Change Entity Budget

  Update the budget of a Meta campaign or ad set. Takes effect immediately. Provide exactly one of daily_budget or lifetime_budget in the account's currency (e.g. 50.00 = $50/day). You cannot switch between budget types — the entity must already use the type you are updating. Check with list_campaigns or list_adsets first. Safety: changes >2× the current value (in either direction) are rejected unless force=True. This prevents an LLM hallucinating a 10× budget increase. Idempotent: setting the

• Update Entity Fields

  Patch arbitrary fields on a Meta campaign, ad set, or ad. Idempotent. Long-tail edit tool. Use the dedicated change_entity_status / change_entity_budget tools for the hot paths — they are safer and have richer error messages. Each field of EntityFieldsPatch documents which entity_type(s) it applies to. Live mutation — changes apply immediately on Meta. State before/after is captured for audit. NOT for editing targeting (use update_adset_targeting).

• Duplicate Campaign

  Duplicate a Meta campaign, creating a new copy in the same ad account. NOT idempotent — each call creates a new campaign. By default duplicates the campaign AND all its ad sets and ads (deep_copy=true). Set deep_copy=false to create an empty shell, then selectively add ad sets with duplicate_adset. The new campaign inherits the original's budgets and is created PAUSED so you can review before activating. Typical workflow: 1. duplicate_campaign → new campaign (PAUSED) 2. change_entity_budget →

• Duplicate Ad Set

  Duplicate a Meta ad set into the same or a different campaign. NOT idempotent — each call creates a new ad set. By default duplicates the ad set AND all its ads (deep_copy=true). Set deep_copy=false to create an empty shell, then selectively add ads with duplicate_ad. The new ad set inherits the original's budget and targeting. Use target_campaign_id to place the copy in any existing campaign — not just duplicated ones. Common use cases: move a top-performing ad set into a scaling campaign, or

• Duplicate Ad

  Duplicate a Meta ad into the same or a different ad set. NOT idempotent — each call creates a new ad. The new ad inherits the original's creative and tracking specs. Use target_adset_id to place the copy in any existing ad set — not just duplicated ones. Common use cases: A/B test the same creative under different targeting, or add a proven ad to a new ad set. To activate, call change_entity_status(action='resume') after duplication.

• Search Targeting Options

  Search targeting options — find interests, demographics, locations, behaviors. Use this before create_adset or update_adset_targeting to get valid IDs. Call estimate_audience_size to check reach before committing. Each search_type returns different result fields: - interests: {id, name, audience_size_lower_bound, audience_size_upper_bound} - geolocation: {key, name, type, country_code, region, region_id, ...} - behaviors/income/life_events/industries: {id, name, description, ...} - work_positio

• Estimate Audience Size

  Estimate the audience size for a targeting spec without creating anything. Use this to explore how big an audience would be before committing to creating an ad set. Helps with strategy planning — e.g. "how many people in the US aged 25-45 are interested in yoga?" Returns estimated reach (users count). Note: estimates are approximate and may return -1 for very new or niche audiences. At least one geo field (countries, cities, regions, or zips) is required.

• List Custom Audiences

  List custom audiences available for targeting in this ad account. Returns each audience's ID, name, subtype, approximate size, and delivery status. Use the id and name values in create_adset or update_adset_targeting to target or exclude these audiences: 1. list_custom_audiences(account_id, search='lookalike') — find audiences 2. create_adset(..., custom_audiences=[{id: '...', name: '...'}]) 3. Or: update_adset_targeting(..., custom_audiences=[{id: '...', name: '...'}]) Audience types include

• Create Website Audience

  Create a website custom audience based on pixel events. NOT idempotent — each call creates a new audience on Meta. Common use cases: - Exclude recent purchasers: event_name='Purchase', retention_days=90 - Target cart abandoners: create one audience for AddToCart (include) and one for Purchase (exclude), then use both in create_adset - All website visitors: omit event_name, retention_days=30 - High-intent visitors: event_name='ViewContent', retention_days=14 After creation, use the returned

• Create Lookalike Audience

  Create a lookalike audience from an existing custom audience seed. NOT idempotent — each call creates a new audience on Meta. Lookalike audiences take 1-6 hours to fully populate. Common use cases: - 1% lookalike of purchasers: Find people most similar to your buyers - 5% lookalike for broader reach: Larger audience, less precise match - Tiered lookalikes: starting_ratio=0.01, ratio=0.03 targets 1%-3% band (excludes the top 1% you're already targeting separately) Workflow: 1. list_custom_au

• Update Ad Set Targeting

  Update the targeting for a Meta ad set. Takes effect immediately. Workflow: 1. search_targeting(search_type='interests', query='...') to find interest IDs 2. search_targeting(search_type='geolocation', query='...') to find geo keys 3. update_adset_targeting(adset_id='...', countries=['US'], interests=[{id, name}]) The server assembles a valid Meta targeting spec from the flat inputs, validates it via /reachestimate (auto-fixing deprecated interests), then applies it. Idempotent: applying the s

• Create Campaign(s)

  Create one or more Meta ad campaigns. NOT idempotent — each call creates new campaigns. All campaigns are created as PAUSED. After creation, add ad sets with create_adset, then activate with change_entity_status(action='resume'). For most use cases, use objective=OUTCOME_SALES with budget at the campaign level and LOWEST_COST_WITHOUT_CAP bid strategy. promoted_object goes on the AD SET, not here — the only exception is OUTCOME_APP_PROMOTION, where Meta requires it at campaign level for iOS 14

• Create Ad Set(s)

  Create one or more Meta ad sets. NOT idempotent — each call creates new ad sets. All ad sets are created as PAUSED. The targeting spec is assembled server-side from flat inputs (same format as update_adset_targeting) and validated via /reachestimate before creation. The campaign_id can be any existing campaign in the account — use list_campaigns to find one, or create_campaign to make a new one. Workflow (new campaign): 1. create_campaign(...) to get a campaign_id 2. search_targeting(search_t

• Get Pixel Health

  Get pixel health for a Meta ad account — metadata, event counts, source and host breakdown. Returns the account's pixel(s) with: - Metadata: name, last_fired_time, automatic matching config, first-party cookie status - Event stats (last 7 days): per-event counts (PageView, Purchase, AddToCart, etc.) - Source breakdown (last 7 days): browser pixel vs Conversions API (CAPI) event counts - Host breakdown (last 7 days): which domains/sites the pixel fires on Use this to diagnose tracking issues: m

• List Ad Creatives

  List existing ad creatives for an account — use to find a creative_id for reuse with create_ad. Queries the tenant DB directly — fast indexed query, no metrics aggregation. Returns id, name, status, object_type, body (truncated unless creative_ids is set), headline, call_to_action_type, link_url, url_tags, image_hash, video_id, actor_id (page_id), instagram_user_id, effective_object_story_id, and lead_gen_form_id. lead_gen_form_id is the Meta Lead Form this creative collects leads into (null f

• Create Ad Creative

  Create one or more Meta ad creatives. NOT idempotent — each call creates new creatives. Pass a list of ``creatives`` to create several in a single tool call (e.g. five image variants for A/B testing, or one creative per hash returned by the multi-select asset picker). Each item is processed independently and an error on one does not abort the others — inspect the per-item ``status`` in the returned ``results`` list. Batching rule of thumb: if you have N image_hashes / video_ids in hand from on

• Create Ad

  Create one or more ads by attaching creatives to ad sets. NOT idempotent — each call creates new ads. Typical workflow: 1. search_ad_images / search_ad_videos — find an asset 2. create_creative(account_id, creatives=[creative_spec]) — build creatives → creative_ids 3. create_ad(account_id, ads=[{adset_id, creative_id, name}]) — create this tool Shortcut (reuse existing creative): 1. list_creatives(account_id) — find an existing creative_id 2. create_ad(account_id, ads=[{adset_id, creative_id,