150+ tools. One operator.

Get connected Meta and Google Ads accounts. Call this first — never ask user for IDs. Returns Meta ad-account ids (act_-prefixed) and Google customer_ids to pass to the other tools.

List products with internal IDs, for use with product research and competitor tracking tools.

List tracked competitors with internal IDs. account_id from get_my_accounts.

Get scraped ads for a competitor. competitor_id from list_competitors.

Start async competitor scrape. Returns run_id integer. Poll with get_scrape_status.

Poll scrape job status: pending, running, completed, failed.

Cross-platform blended performance: total ad spend (Meta + Google + Amazon) vs Shopify revenue, with blended MER/ROAS/ACOS. NON-LLM and cheap — safe to call often, unlike a full account analysis. Pass whichever platform ids you already have (account_id/customer_id from get_my_accounts, amazon_profile_id from list_amazon_profiles, shop from list_shopify_stores) — all four are optional. An omitted platform contributes 0 and is reported as not connected in `platforms_connected` rather than failing the whole call. Honesty notes: Amazon spend is ad-attributed only (no SP-API access) — Amazon marketplace sales are NOT included in shopify_revenue or any total-revenue figure here. Spend/revenue are summed with NO currency conversion across platforms — only meaningful when the connected accounts share a currency. See the response's own `notes` field for the caveats that applied to this specific call.

This API key's usage this month: {plan, tier, monthly_limit, units_used_this_month, units_remaining, daily_requests_today, daily_limit}. Call it to check how much of the MCP quota is left and WARN the user before they run out: when units_remaining is low, tell them they are close to their monthly limit and can upgrade at muzecmo.com/pricing (units_remaining/monthly_limit are null for non-MCP / unlimited plans). Cheap read.

Get Meta Ads performance metrics (spend, CTR, ROAS, conversions). account_id from get_my_accounts.

List campaigns with IDs, names, status, budget. account_id from get_my_accounts.

List Meta campaigns with extended fields (delivery, budgets, objective). Heavier than list_campaigns; use when you need per-campaign detail in bulk.

Get one Meta campaign by ID (status, budget, objective, timing). campaign_id from list_campaigns.

List stored insight rows for one Meta ad (per-period spend, clicks, conversions).

All ads for a Meta account with their insight data (the account's working set). Optional date range narrows the analysis window.

Period-over-period Meta account comparison (this period vs previous). Defaults to month-to-date vs the same span last month; pass custom_start_date/custom_end_date for an arbitrary window.

Meta account performance over a rolling 30-day window (yesterday minus 29 days through yesterday). Same shape as compare_meta_performance but one fixed window.

Recommended launch settings derived from the account's own live campaigns — objective, optimization, median budget, geo/age, pixel — with a plain-English rationale. Read before creating campaigns.

Poll an async launch started by launch_meta_ad with async_mode=true. Returns processing/completed/failed; results kept ~1 hour.

List datasets (pixels + offline event sets) for a Meta Business account. business_id from get_meta_business_info.

List conversion events available on a Meta ad account (for choosing optimization events).

Business account info for the connected Meta user (business IDs, names).

List custom conversions defined on a Meta ad account.

Today's launch-plan analysis messages and full chat thread for a Meta account.

ACTIVE Meta campaigns with detailed insights and their ACTIVE ads (the launch-plan working view).

Pause a live Meta ad — stops spending immediately. MUST have confirm=True after user explicitly confirms. If confirm=False, ask user first.

Resume a paused Meta ad — starts spending again. MUST have confirm=True after user explicitly confirms. If confirm=False, ask user first.

Pause a Meta ad set — stops every ad inside it from spending.

Pause a Meta campaign — stops the whole campaign (all ad sets and ads) from spending.

Update a Meta ad's name and/or status (ACTIVE|PAUSED). To restart spend prefer resume_ad; to stop it prefer pause_ad.

Update a Meta ad set: name, status, daily_budget and/or bid_amount. daily_budget and bid_amount are in the account currency's MINOR units (e.g. cents: 5000 = $50.00). Budget changes affect spend immediately.

Update a Meta campaign: name, status and/or daily_budget (CBO campaigns). daily_budget is in the account currency's MINOR units (cents).

Create a Meta campaign — ALWAYS created PAUSED (MCP safety rail; activate later). campaign is the CampaignCreate object: {name, objective (OUTCOME_SALES|OUTCOME_TRAFFIC|...), daily_budget?|lifetime_budget? (minor units), special_ad_categories?}.

Create a Meta ad set — ALWAYS created PAUSED. ad_set is the AdSetCreate object: {name, campaign_id, optimization_goal, billing_event, daily_budget? (minor units), targeting: {geo_locations,...}, bid_strategy?/bid_amount?}.

Create a Meta ad creative. creative is the AdCreativeCreate object: {name, object_story_spec: {page_id, link_data|video_data}}. Creatives don't spend by themselves.

Create a Meta ad — ALWAYS created PAUSED. ad is the AdCreate object: {name, adset_id, creative: {creative_id}}.

One-call full funnel: campaign + ad set + creative + ad — every layer ALWAYS created PAUSED. flow is the CompleteCampaignFlowCreate object: {account_id, campaign: CampaignCreate, ad_set: AdSetCreate, creative: AdCreativeCreate, ad: AdCreate}.

High-level Meta launch (Muze's launch flow: builds campaign, ad set, creative and ad from simple inputs) — ALWAYS launched PAUSED via the L5 status field. launch is the LaunchAdCreateParams object: {account_id, title, description, creative_url, landing_url, daily_budget (dollars), objective?, page_id?, async_mode? ...}. Use get_meta_launch_defaults first for sensible values; poll get_meta_launch_status when async_mode=true.

Bulk Meta launch — create MANY ads under one campaign + ad set in a single call, ALWAYS launched PAUSED. The top-level status is forced to PAUSED, so every ad in the batch is created paused AND the staging ad set is left paused (nothing spends until activated). launch is the BulkLaunchAdCreateParams object: {account_id, ads: [{title, description?, creative_url?, call_to_action_type?, landing_url?}, ...], landing_url?, daily_budget? (dollars), objective?, page_id?, existing_campaign_id?/existing_adset_id? to reuse an existing campaign/ad set instead of creating new ones}.

Replace the image on a live Meta ad, keeping all other settings.

Replace the video on a live Meta ad, keeping all other settings.

Execute the actions inside a stored launch-plan chat message (pause/scale ad sets) and mark it applied. analysis_id + message_index from get_launch_chat_thread.

Pause a list of Meta ads. ads_to_pause: [{"ad_id": "..."}, ...].

Resume (un-pause) a list of Meta ads. ads_to_enable: [{"ad_id": "..."}, ...].

Scale ad set budgets. ads_to_scale: [{"ad_id": "<adset_id>", "new_budget": <MAJOR units, e.g. dollars>}] — note new_budget is in MAJOR currency units here (the route converts to minor units).

Apply ad copy changes. copy_changes: [{"ad_id": "...", "headline"?: str, "description"?: str, "call_to_action"?: str}] — each entry needs ad_id plus at least one field.

Get Google Ads performance metrics. customer_id from get_my_accounts.

List every Google Ads customer the OAuth grant can access (each item has is_manager — pick a non-manager client account).

All Google Ads entities for a customer with insights (PMax asset groups + campaign working set).

When the account's scheduled analysis last ran and how many campaigns were analyzed vs gated out.

All open UserLists (remarketing audiences) for the account, ordered by size.

Merchant Center accounts linked to this Google Ads customer (needed for Shopping/PMax launches).

Conversion actions defined on the account (for choosing bidding/conversion goals).

Canonical PMax top-20/bottom-80 product split for the account (days 7-90).

Campaign launch logs for the current user (status filter: success|failed).

Inspect one Google campaign's ads/asset groups in detail.

Search Google geo target constants by name (cities, regions, postal codes) for targeting.

Per-placement performance for a Display campaign over the window.

Per-audience (user_interest / user_list) performance for a Display campaign.

User lists eligible to seed a Demand Gen lookalike or attach as audience signals.

Preflight: can this customer create Video campaigns? Gate video work on this.

Video campaigns with core video metrics for the window.

Firebase / MMP link state for the customer — read before attempting App campaign work.

Period-over-period Google account comparison (mirrors compare_meta_performance).

Keyword ideas from Google's Keyword Planner (live platform data, no LLM). payload example: {"customer_id": "...", "keywords": ["seed one", "seed two"], "page_url"?: "..."}

Pause a Google Ads campaign — stops its spend immediately.

Resume a paused Google Ads campaign — it starts spending again.

Apply a stored recommendation action to a campaign (budget / target CPA / target ROAS changes). payload example: {"campaign_id": "...", "action": {...}} — the same payload shape the Muze dashboard's apply button sends. Spend changes take effect immediately.

Replace a text/image asset inside a campaign with an improved one. payload example: {"campaign_id": "...", "asset_id": "...", "new_text"?: "...", ...}

Execute Muze's stored ad-group-level autopilot actions now (keyword/bid changes). payload is the executor payload the dashboard sends.

Execute Muze's stored campaign-level autopilot actions now (budget/target changes). payload is the executor payload the dashboard sends.

Create a Demand Gen lookalike audience from a seed user list. payload: {"seed_user_list_id": "...", "name"?: "...", ...}. Creates an audience only — no campaign, no spend.

Launch a Performance Max campaign — ALWAYS launched PAUSED (status forced server-side). payload: the same body the Muze launch dialog sends: {campaign_name, daily_budget, final_url, headlines[], long_headlines[], descriptions[], image_urls[], geo targets, bidding_strategy?, merchant_center_id?/feed_label? for shopping-PMax, ...}. Resolve prerequisites first via list_merchant_center_links / list_google_conversion_actions.

Launch a Search campaign — ALWAYS launched PAUSED (U7-2 status forced). payload is the LaunchSearchCampaignRequest object: {campaign_name, daily_budget, final_url, keywords[], headlines[], descriptions[], geo_target_constants?, partition_mode?, ...}.

Launch a Standard Shopping campaign — ALWAYS launched PAUSED (U7-2 status forced). payload is the LaunchShoppingCampaignRequest object: {campaign_name, daily_budget, merchant_center_id, partition_mode ('all'|'branded'), brand_value?, geo_target_constants?, ...}.

Launch a Display (responsive display) campaign — ALWAYS launched PAUSED (U7-2 status forced). payload is the LaunchDisplayCampaignRequest object: {campaign_name, budget_amount_micros, business_name, geo_target_constants[], ad_groups[] (each with ads[] carrying headlines/long_headline/descriptions/marketing_images + optional targeting), bidding_strategy?, target_cpa_micros?/target_roas?}.

Launch a Demand Gen campaign (YouTube Shorts / in-feed / in-stream, Gmail, Discover) — ALWAYS launched PAUSED (U7-2 status forced). payload is the DemandGenLaunchRequest object: {headlines[], long_headlines[], descriptions[], business_name, image_urls{}, budget_amount_micros (>= 300 units/day in micros), youtube_video_urls?[], geo_target_constants?[], bidding_strategy?, lookalike_user_list_ids?/audience_user_list_ids?}.

Launch a Video (YouTube) campaign — ALWAYS launched PAUSED (U7-2 status forced). Google Ads cannot upload videos: supply pre-existing YouTube video IDs. payload is the LaunchVideoCampaignRequest object: {campaign_name, campaign_subtype, budget_amount_micros, bidding_strategy, youtube_video_ids[], final_urls[], geo_target_constants?[], ad_groups?[], validate_only?}. Preflight with get_video_capabilities first.

Launch a Google App (UAC) install campaign — ALWAYS launched PAUSED (U7-2 status forced). Requires Firebase or a linked MMP (check get_app_campaign_prerequisites first — a missing link 422s). payload is the LaunchAppCampaignRequest object: {app_id, app_store (GOOGLE_APP_STORE|APPLE_APP_STORE), daily_budget_micros, headlines[] (>=2), descriptions[] (>=2), image_asset_urls?[]/image_asset_resources?[], video_ids?[], geo_targets?[], target_cpi_micros?, validate_only?}.

Read the user's Google autopilot settings (whether Muze may auto-apply optimizations).

Update Google autopilot settings. settings is the GoogleAutopilotUpdate object (e.g. {"campaign_autopilot": true, ...}). CAUTION: enabling autopilot authorizes Muze to change budgets/bids autonomously on the daily schedule.

Create default Google autopilot settings for the user (or one customer).

Merchant Center accounts connected to the user (for product feeds / Shopping).

Products in a Merchant Center account (paginated via page_token).

Feed health for a Merchant Center account: approved / disapproved product counts and issues.

Link a Merchant Center account to a Google Ads customer (required before Shopping/PMax-shopping launches).

Disconnect the user's Merchant Center connection from Muze. Does not delete anything on Google; Shopping features in Muze stop working until reconnected.

List the user's connected Amazon Ads profiles (profile_id, marketplace, currency, account type). Call this first to resolve profile_id for the other Amazon tools — never ask the user for it.

List Amazon Ads campaigns with rolling-period metrics (spend, sales, orders, ACOS, ROAS, CTR, CVR) for one profile. profile_id from list_amazon_profiles. Default period: last 30 days. Honesty note: spend/sales here are AD-ATTRIBUTED only — Muze holds only the advertising::campaign_management Amazon Ads API scope, not SP-API, so there is no Amazon marketplace total-revenue figure on this connection (organic sales are invisible to these numbers).

Account-level Amazon Ads daily performance series (spend, sales, orders, ACOS, ROAS, CTR, CVR per day) for one profile. Default period: last 30 days. Same ad-attributed-only scope caveat as list_amazon_campaigns.

Report-ingest queue rows for a profile (which daily Amazon reports have been requested/ingested).

Pending search-term recommendations for a profile (harvest winners as keywords, block wasters as negatives). Each row has a row_id for apply/dismiss.

Current Amazon autopilot configuration for a profile (whether Muze may auto-apply search-term and bid actions).

Audit log of autopilot actions taken on this profile.

Per-profile ASIN catalog (auto-built from product ads + reports). enriched_only=true filters to rows with title/brand metadata.

Portfolios for this profile (Muze's local copy).

Event-driven budget boost schedules for this profile (e.g. Prime Day boosts).

Expand a seed keyword via Amazon's search-bar completion API (live platform data, no LLM).

Read a campaign wizard's current state (draft inputs, stage). wizard_id from start_amazon_campaign_wizard.

Re-discover and sync the user's Amazon Ads profiles from Amazon (refreshes list_amazon_profiles).

Re-run the 4-stage kickoff (entity sync, benchmark snapshot, report submit, ingest) for the user's profiles. Data refresh only — changes nothing on Amazon.

Submit yesterday's report requests to Amazon for one profile (results ingest asynchronously).

Pull all keywords for this profile from Amazon and upsert locally (data refresh, no Amazon-side change).

Recompute search-term recommendations for a period (YYYY-MM-DD bounds). Generates recommendations only — applies nothing.

Dismiss one search-term recommendation (row_id from list_amazon_search_terms). Nothing changes on Amazon.

APPLY one search-term recommendation on Amazon (row_id from list_amazon_search_terms): harvests the term as a keyword or adds it as a negative, per the recommendation. This mutates the live account.

Update the Amazon autopilot config for a profile. config is the AmazonAdsAutopilotConfigCreate object. CAUTION: enabling autopilot authorizes Muze to apply search-term/bid actions autonomously.

Run the search-term autopilot once, now, for this profile — applies eligible recommendations to the live account within the configured guardrails.

Run the bid-adjustment autopilot once, now, for this profile — changes live bids within the guardrail clip range (0.65x-1.25x).

Set the monthly total-revenue estimate used for TACOS (e.g. "120000"). Muze-side setting only.

Schedule an event-driven budget boost (e.g. Prime Day): the campaign's daily budget is raised to boosted_daily_budget between starts_at and ends_at (ISO-8601), then reverted. campaign_id is Muze's internal campaign row id from list_amazon_campaigns.

Start a guided campaign-creation wizard for a profile. inputs is the WizardStartRequest object (campaign type, ASINs, budget, ...). The wizard only stores state — nothing is created on Amazon until its launch step, which is NOT exposed over MCP yet (created-paused enforcement pending).

Update a wizard's draft inputs. draft is the WizardSaveDraftRequest object.

Move a wizard to a new state (draft → configured → ready, ...). transition is the WizardTransitionRequest object. State change only; creates nothing on Amazon.

Cancel a wizard run (terminal). Nothing on Amazon is touched.

Revoke Muze's stored Amazon Ads credentials for this user. Amazon campaigns keep running; Muze loses access until reconnected.

Create a Sponsored Products AUTO-targeting campaign. `campaign` is the create body (name, daily_budget, start_date, ...). Created PAUSED — it will not spend until you enable it (set_amazon_campaign_state).

Create a Sponsored Products MANUAL-targeting campaign. `campaign` is the create body. Created PAUSED — it will not spend until enabled.

Pause or resume a campaign. state is PAUSED or ENABLED — pausing stops spend, enabling resumes it. campaign_id is the Amazon campaign id.

Update a campaign's daily budget. daily_budget is the new amount as a string (e.g. '25.00'). campaign_id is the Amazon campaign id.

Archive a campaign. IRREVERSIBLE on Amazon — an archived campaign cannot be un-archived. To merely stop spend, use set_amazon_campaign_state with PAUSED instead.

Create an ad group under a campaign. `ad_group` is the create body (campaign_id, name, default_bid). Created PAUSED.

Update an ad group's default bid (applies to targets without their own bid). default_bid is a string (e.g. '0.75').

Archive an ad group. IRREVERSIBLE on Amazon.

Create one product ad per ASIN and per SKU in an ad group. `product_ads` is the create body (campaign_id, ad_group_id, asins, skus). Created PAUSED.

Update the bid on an Amazon-created auto target. target_id from the ad group's auto targets. bid is a string (e.g. '0.80').

Batch-create keyword targets in an ad group. `keywords` is the create body (campaign_id, ad_group_id, keywords[{keyword_text, match_type, bid}]). Created PAUSED.

Create a single keyword target. `keyword` is the create body (campaign_id, ad_group_id, keyword_text, match_type, bid). Created PAUSED.

Update a keyword's bid. keyword_id is the Amazon keyword id. bid is a string (e.g. '0.90').

Batch-create ad-group negative keywords (exclusions). `negatives` is the create body (campaign_id, ad_group_id, negative_keywords[{keyword_text, match_type}]). match_type is negativeExact or negativePhrase. Created ENABLED so the exclusion is active immediately.

Create a single ad-group negative keyword (exclusion). `negative` is the create body (campaign_id, ad_group_id, keyword_text, match_type). Created ENABLED.

Batch-create manual product targets in an ad group. `targets` is the create body (campaign_id, ad_group_id, targets[{expression[{type, value}], bid}]). Created PAUSED.

Update a manual product target's bid. target_id is the Amazon target id. bid is a string (e.g. '0.85').

Batch-create negative product targets (ASIN/brand exclusions). `negatives` is the create body (campaign_id, ad_group_id, negative_targets[{expression[{type, value}]}]). Created ENABLED so the exclusion is active.

Execute a READY campaign wizard's Amazon mutation chain (creates the campaign, ad group, product ads and targets). Over MCP the launch is ALWAYS forced PAUSED — every created entity lands PAUSED so nothing spends until you enable it. wizard_id from start_amazon_campaign_wizard.

List the user's connected Shopify stores (domain, subscription status). Call this first to resolve `shop` for the other Shopify tools — never ask the user for their store domain.

Shopify order revenue for the trailing period_days, summed by currency. shop from list_shopify_stores. `revenue`/`currency` are null (not a fabricated number) when the store transacted in more than one currency in the window — read `revenue_by_currency` for the real per-currency breakdown in that case.

Top products summary (by sales + inventory) for a Shopify store. shop from list_shopify_stores.

Full product list for a store, paginated (limit 1-250; pass the returned page_info to get the next page).

Orders for a store, paginated (limit 1-250; pass the returned page_info for the next page).

Store metadata (name, domain, plan, currency, timezone).

The user's current Muze subscription state as seen through Shopify billing.

Top products list for a shop (sales-ranked, from Muze's product intelligence store).

History of creative generations for a shop's products.

Status of the latest Shopify catalog/orders sync for a shop.

Active Shopify-agent cards for one shop (inventory/pricing/product alerts), ordered by urgency.

Historical Shopify-agent cards for a shop over the window.

Sync health for a shop: catalog row count, orders row count, webhook state.

Kick off a background catalog+orders sync. Omit shop to sync every connected store. Data refresh only — changes nothing in Shopify.

Apply / dismiss / acknowledge an action on a Shopify-agent card. card_id from get_shopify_feed; action_key is the card's primary or secondary action key. Some actions modify the store (e.g. price updates).