Tool reference

Workspace, accounts and guardrails

Shows the workspace you're connected to, your role, plan status, enabled accounts per platform (with the ids tools accept as account_id), budget bumpers, and whether plans can be approved in chat.

No parameters.

List proposed and applied changes

Lists the workspace's change plans, newest first, optionally filtered by status.

Show a change plan

Shows one plan's full diff, status and review link.

Apply an approved change plan

Applies a pending plan, only after the user has seen the diff and explicitly approved it in the conversation. Works only when the workspace allows approvals in chat and the user is a member or above; otherwise it returns the dashboard link.

Reject a pending change plan

Rejects a pending plan so it can't be applied. Nothing changes on any platform.

Propose undoing an applied plan

Creates a new pending plan that reverses every applied change in a plan, newest first. The undo plan needs approval like any other plan.

Google Ads account overview

Headline numbers for one Google Ads account over a date range (default: last 30 complete days) compared with the previous period of the same length: spend, clicks, impressions, conversions, conversion value, CPA, ROAS, CTR, avg CPC. Money is in account currency units (already converted from micros).

List Google Ads campaigns

Campaigns in a Google Ads account with ID, status, channel, daily budget, bidding strategy and metrics for a date range (default last 30 days): spend, clicks, conversions, CPA, ROAS. Budgets and money are in account currency units (converted from micros). Shared budgets are marked; changing one affects every campaign on it. Use the IDs with the write tools.

Google Ads search terms report

What people actually searched before clicking your Search ads, with spend, clicks, conversions and conversion value for a date range (default last 30 days), highest spend first. Use wasted_only + min_spend to find negative-keyword candidates; terms already negated are left out unless include_negated=true. Money is in account currency units (converted from micros). Performance Max terms aren't included (Google doesn't expose them here).

Google Ads keywords

Keywords (not negatives) with match type, status, Quality Score (1-10) and its components, plus spend, clicks, conversions and CPA for a date range (default last 30 days), highest spend first. Keyword IDs are printed as adGroupId~criterionId for google_ads_set_keyword_status. Money is in account currency units (converted from micros).

Google Ads responsive search ads

Responsive search ads with status, ad strength, policy approval, headlines, descriptions, final URL and metrics for a date range (default last 30 days), highest spend first. Ad IDs are printed as adGroupId~adId for google_ads_set_ad_status. Money is in account currency units (converted from micros).

Run a Google Ads (GAQL) report query

Runs ONE read-only Google Ads Query Language (GAQL, https://developers.google.com/google-ads/api/docs/query/overview) SELECT against an allowlisted reporting resource (campaign, ad_group, ad_group_ad, keyword_view, search_term_view, geographic_view, landing_page_view, asset_group, conversion_action, change_event, ...). Anything else is rejected. Results are capped at 1000 rows. Micros fields are converted to account currency units and renamed without the Micros suffix (metrics.cost_micros → metrics.cost; average_cpc and cost_per_conversion too).

Google Ads change history

Who changed what in the Google Ads account over the last 14 days (from Google's change history, including changes made outside MegaMCP): time, resource type, operation, changed fields, user and tool. Newest first.

Pause or enable Google Ads campaigns

Proposes pausing or enabling campaigns. Returns a plan (checked by Google in a dry run) for a human to approve; nothing changes until approved. Enabling counts as a spend increase from 0 to the campaign's daily budget for budget bumpers. Undo is available after applying.

Change a Google Ads campaign's daily budget

Proposes a new daily budget for a campaign, in account currency units (not micros). If the budget is shared by several campaigns it refuses unless allow_shared=true, and the plan names every affected campaign. Subject to budget bumpers. Returns a plan (dry-run validated by Google) to approve; undo restores the previous amount.

Add Google Ads negative keywords

Proposes campaign-level negative keywords (EXACT by default; PHRASE or BROAD optional) so a campaign stops showing for those searches. Negatives the campaign already has are skipped. Returns a plan (dry-run validated by Google) to approve; undo removes exactly the negatives it added.

Pause or enable Google Ads ad groups

Proposes pausing or enabling ad groups. Returns a plan (dry-run validated by Google) to approve; nothing changes until approved. Undo is available after applying.

Pause or enable Google Ads keywords

Proposes pausing or enabling keywords. keyword_ids are "adGroupId~criterionId" as printed by google_ads_keywords. Returns a plan (dry-run validated by Google) to approve; nothing changes until approved. Undo is available after applying.

Pause or enable Google Ads ads

Proposes pausing or enabling ads. ad_ids are "adGroupId~adId" as printed by google_ads_ads. Returns a plan (dry-run validated by Google) to approve; nothing changes until approved. Undo is available after applying.

Create a Google Ads search campaign

Proposes a complete Search campaign: a daily budget (account currency units, not micros), the campaign (ALWAYS created PAUSED, Google Search only, no display or partners), optional location/language targeting, ad groups with keywords, and one responsive search ad per ad group (3-15 headlines of at most 30 characters, 2-4 descriptions of at most 90, https final URL). Google dry-runs the whole thing before you approve. Everything is created in one atomic request; the new daily budget counts against budget bumpers. Undo removes the campaign and its budget.

GA4: run a report

Flexible Google Analytics 4 report using the GA4 Data API runReport method (https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport). Pick metrics (e.g. sessions, totalUsers, keyEvents, engagementRate, screenPageViews, totalRevenue) and dimensions (e.g. date, sessionDefaultChannelGroup, sessionSourceMedium, pagePath, country, deviceCategory, eventName). Up to 4 date ranges (a Range column is added when there are several). Filters match dimension values (exact, contains, begins_with, ends_with, regex, in_list; exclude to negate). Rates are shown as percentages; durations in seconds. Note: GA4 renamed conversions to keyEvents.

GA4: traffic summary

Headline GA4 numbers for a date range compared with the previous period of equal length: sessions, users, new users, key events (formerly conversions), engagement rate and average session duration, plus the same by default channel group.

GA4: what changed and where

Explains a change in one GA4 metric between two periods: the total for each period and the biggest gains and drops broken down by one dimension (e.g. sessionDefaultChannelGroup, sessionSourceMedium, landingPage, country, deviceCategory). The previous period defaults to the same length right before the current one.

GA4: top pages

Top pages in GA4. by=page (default): views, active users, average engagement time per user and key events by page path. by=landing_page: sessions, users, engagement rate and key events by landing page. Optional path_contains filter.

GA4: realtime

Active users on the site in the last 30 minutes (GA4 realtime), total and broken down by one dimension: unifiedScreenName (page title/screen), country, city, deviceCategory, platform or eventName (with event counts).

GA4: list key events

Lists the GA4 property's key events (formerly conversions): event name, counting method, whether it's custom and whether it can be removed.

GA4: mark an event as a key event

Proposes marking a GA4 event name as a key event (formerly 'conversion'). Returns a plan for the user to approve; nothing changes until approved. Key events count from the moment they're created, not retroactively.

Search Console: search performance

Google Search performance from Search Console: clicks, impressions, CTR and average position, broken down by up to 5 dimensions (query, page, country, device, date, searchAppearance), with optional filters. Includes the property's totals for the range. Dates are in Pacific Time; data lags about 2 days.

Search Console: quick wins

Striking-distance keywords: queries ranking at average position 8–20 (bottom of page 1 / top of page 2) with at least min_impressions impressions, grouped by the page that ranks.

Search Console: keyword cannibalization

Queries where two or more of the site's own pages get impressions, so they compete with each other. Shows each competing page's position, clicks and share of impressions.

Search Console: inspect a URL

Google's index status for one URL in the property (URL Inspection API): verdict, coverage state, last crawl, robots.txt and fetch state, Google-selected vs declared canonical, sitemaps, and rich result issues. Shows what Google has indexed, not a live test.

Search Console: sitemaps

Sitemaps submitted for the property: when each was submitted and last read, pending status, errors, warnings and submitted URL counts.

Search Console: submit a sitemap

Proposes submitting (or resubmitting) a sitemap URL to Search Console for the property. Returns a plan for the user to approve; nothing changes until approved. Undo removes the sitemap if it wasn't there before.

Tag Manager: containers and workspaces

Lists the enabled Tag Manager containers (public id, type) and each container's workspaces with their ids. Workspace ids are the workspace_id values other gtm_ tools accept.

Tag Manager: audit a container

Audits a GTM container (the live version by default, or a workspace) and returns a scored checklist: conversion tags firing on All Pages, duplicate GA4 event tags, tags with no firing trigger, Universal Analytics leftovers, paused tags, unused triggers and unused variables. Score is out of 100.

Tag Manager: versions

Lists a container's versions (newest first) with tag/trigger/variable counts and marks which one is live.

Tag Manager: create a GA4 event tag

Proposes a GA4 event tag plus its trigger (a dataLayer custom event, or page views matching a path) in a GTM workspace. By default a workspace named 'MegaMCP <date>' is created at apply time. Nothing goes live until the workspace is published with gtm_publish_workspace. Returns a plan to approve.

Tag Manager: pause or unpause a tag

Proposes pausing (or unpausing) a GTM tag, identified by tag id or exact name. The change is made in a workspace ('MegaMCP <date>' by default) and goes live only when that workspace is published. Returns a plan to approve.

Tag Manager: publish a workspace

Proposes publishing a GTM workspace: creates a version from it and makes that version live. The plan lists every change in the workspace. Undo republishes the version that was live before. Returns a plan to approve.

Meta Ads account overview

Headline numbers for a Meta ad account: spend, impressions, reach, frequency, clicks, CTR, CPM, CPC, purchases, leads, revenue (purchase value), ROAS and CPA, with an optional previous-period comparison. Money is in the account currency (major units, e.g. dollars). Dates are in the account's timezone.

List Meta campaigns

Campaigns in a Meta ad account with status, objective, campaign budget (CBO; shown when the budget is set at campaign level) and performance for the period: spend, impressions, CTR, purchases, leads, ROAS, cost per result. Budgets and spend are in account currency major units.

List Meta ad sets

Ad sets with status, targeting summary (age, gender, locations, interests, audiences), budget (when set at ad set level), optimization goal and performance for the period: spend, frequency, CTR, purchases, leads, cost per result. Optionally filter by campaign. Money in account currency major units.

List Meta ads

Ads with creative name, status and performance for the period: spend, CTR, frequency, purchases, leads, cost per result. Filter by campaign or ad set. Money in account currency major units.

Meta Ads insights (flexible)

Flexible report from the Meta Marketing API Insights endpoint (https://developers.facebook.com/docs/marketing-api/insights). Choose the level (account, campaign, adset, ad), metrics from an allowlist, up to 2 breakdowns (age, gender, country, region, publisher_platform, platform_position, device_platform, impression_device) and a time increment (all_days, 1 = daily, 7 = weekly, monthly). 'actions' becomes Purchases and Leads columns; 'action_values' becomes purchase value. Money in account currency major units.

Find fatigued Meta creatives

Checks each ad for creative fatigue: 7-day frequency, CTR over the last 3 days vs the prior 14 days, and CPM trend. Flags 'fatigued' when CTR dropped by at least ctr_drop_pct AND frequency is at or above frequency_threshold or CPM rose 20%+; 'watch' when only one signal fires. Ads with too few impressions are marked not_enough_data.

Pause or activate Meta campaigns, ad sets or ads

Proposes pausing or activating Meta campaigns, ad sets or ads (all ids must be the same level). Returns a plan for the user to approve; nothing changes until approved. Activating counts against budget bumpers as an increase from 0 to the daily spend it restarts (its own budget, its active ad sets' budgets, or its parent's budget).

Change a Meta daily budget

Proposes a new daily budget for a campaign (when it uses campaign budget / CBO) or an ad set (when budgets are set per ad set). daily_budget is in the account currency's major units (e.g. 50 = $50.00/day), not cents. Lifetime budgets aren't supported. Subject to budget bumpers. Returns a plan to approve.

Duplicate a Meta ad set

Proposes copying an ad set (optionally with its ads, up to 3) into the same campaign. The copy is created PAUSED, so it spends nothing until someone turns it on. Undo deletes the copy. Returns a plan to approve.

Create a paused Meta ad

Proposes a new ad, created PAUSED, in an existing ad set. Either reuse an existing creative (creative_id) or build a single-image link ad from image_url + primary_text + headline + link_url (+ optional description and call_to_action). page_id is the Facebook Page the ad runs as; if omitted it's taken from an existing ad in the ad set. Undo deletes the ad (and the creative, if this created it). Returns a plan to approve.

List demo campaigns

Sandbox ad account (not real money). Lists campaigns with status, daily budget and last-30-day spend, clicks, conversions, CPA and ROAS.

Demo search terms report

Sandbox. Search terms from the last 30 days with spend, clicks and conversions. Optionally filter by campaign and a minimum spend with zero conversions.

Pause or enable demo campaigns

Sandbox. Proposes pausing or enabling campaigns. Returns a plan for the user to approve; nothing changes until approved.

Change a demo campaign's daily budget

Sandbox. Proposes a new daily budget (in account currency, not micros). Subject to budget bumpers. Returns a plan to approve.

Add demo negative keywords

Sandbox. Proposes adding negative keywords (exact match) to a campaign. Returns a plan to approve.