Get the user's connected Meta ad account IDs and Google Ads customer IDs. Call this first before any other tool — never ask the user for account IDs. If MUZE_DEFAULT_ACCOUNT_ID is set, this is skipped and defaults are returned. If multiple accounts exist, list them so the user can choose.

Get Meta Ads performance metrics (spend, impressions, clicks, CTR, CPC, ROAS, conversions). account_id comes from get_my_accounts. Dates in YYYY-MM-DD format; default = last 30 days.

Get Google Ads performance metrics (spend, impressions, clicks, CTR, CPC, conversions, ROAS). customer_id comes from get_my_accounts. Dates in YYYY-MM-DD format; default = last 30 days.

List all campaigns for a Meta ad account with their IDs, names, status, and budget. account_id comes from get_my_accounts. Use campaign IDs from this response in analyze_campaign_ads.

Run AI analysis on all ads in a campaign. Returns performance scores and recommendations. campaign_id comes from list_campaigns. Dates in YYYY-MM-DD format.

Run AI analysis on a single ad. Returns detailed analysis, performance score, and recommendations. Dates in YYYY-MM-DD format.

Fetch the most recent stored AI analysis for all ads in an account. Fast — reads from the database without re-running analysis. Use this before analyze_account_ads.

Re-run a full AI analysis of ALL ads in the account. WARNING: This is expensive and takes 30-60 seconds. Individual ads must have been analyzed in the same date range first. Use get_account_analysis to fetch existing results instead. Only call with confirmed=True after the user explicitly requests a fresh re-analysis.

Generate an ad creative concept from a product URL. Only ask the user for product_url — all other params have smart defaults. Brand guidelines are resolved server-side.

List products in the user's account with internal IDs, names, URLs, and selling propositions. Call this before generate_ad_concepts to resolve product_id — never ask the user for IDs directly.

Generate multiple ad creative concepts for an existing product in the system. product_id must come from list_products — match the product name the user mentions, then pass the corresponding internal ID. Never ask the user to provide a product ID.

List all tracked competitor brands with their internal IDs. account_id comes from get_my_accounts. Use competitor IDs from this response for get_competitor_ads and scrape_competitor_ads.

Get scraped ads for a specific competitor including creative previews and copy. competitor_id must come from list_competitors — match by brand name, then use the internal ID.

Start an async scrape job to fetch fresh competitor ads. Returns a run_id (integer). Then call get_scrape_status with that run_id and poll every few seconds until status is 'completed', then call get_competitor_ads.

Poll the status of a competitor scrape job started by scrape_competitor_ads. Status values: 'pending', 'running', 'completed', 'failed'. Poll every few seconds until status is 'completed', then call get_competitor_ads.

Pause a live Meta ad. The ad will stop spending immediately. IMPORTANT: Only call with confirm=True after the user has explicitly confirmed they want to pause this specific ad. If confirm is False, return the confirmation message.

Resume a paused Meta ad. The ad will start spending again. IMPORTANT: Only call with confirm=True after the user has explicitly confirmed they want to resume this specific ad. If confirm is False, return the confirmation message.