Skip to main content
Glama

Propose Google Analytics changes (applies nothing)

propose_analytics_changes
Idempotent

Checks Google Analytics setup changes against the live property and saves them as a plain-English proposal; nothing changes until the user approves and applies it.

Instructions

Checks Google Analytics setup changes against the live property and stores them as a proposal with a plain-English summary; nothing is changed. Show the summary to the user and apply only after they approve, with apply_changes (undo_changes reverses it). Supported: create_ga4_property (a property plus a web stream; the applied result gives the measurement ID and the tag the site needs), mark_key_event / unmark_key_event (GA4's conversions), set_key_event_counting (also recounts a Google Ads import of it), link_google_ads / unlink_google_ads, register_custom_dimension / register_custom_metric (make a parameter reportable), set_custom_metric_unit, archive_custom_dimension / archive_custom_metric. Point out any ⚠ line before they approve.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "changes": "<changes>"
    },
    "name": "propose_analytics_changes"
  }
}

Input Schema

NameRequiredDescriptionDefault
changesYesChanges to propose; several can go in one proposal

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.42.0
    • changedInput schema / properties / changes / items / oneOf
      Previous value: -[
      -  {
      -    "description": "Create a GA4 property with a web data stream for the site; the result gives the measurement ID and the tag to add to every page",
      -    "properties": {
      -      "account_id": {
      -        "description": "Google Analytics account id (from analytics_properties' accounts)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "currency": {
      -        "default": "USD",
      -        "description": "Currency for revenue, ISO 4217",
      -        "pattern": "^[A-Z]{3}$",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "Property name, usually the business or site",
      -        "maxLength": 100,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "time_zone": {
      -        "description": "IANA time zone reports use, e.g. America/New_York",
      -        "maxLength": 64,
      -        "minLength": 3,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "create_ga4_property",
      -        "type": "string"
      -      },
      -      "website_url": {
      -        "description": "The site's address, e.g. https://www.example.com",
      -        "format": "uri",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "account_id",
      -      "name",
      -      "website_url",
      -      "time_zone"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Mark an event as a key event (GA4's conversion), so it is counted and can be imported into Google Ads",
      -    "properties": {
      -      "counting": {
      -        "default": "ONCE_PER_EVENT",
      -        "description": "ONCE_PER_EVENT counts every time; ONCE_PER_SESSION counts one per visit (leads)",
      -        "enum": [
      -          "ONCE_PER_EVENT",
      -          "ONCE_PER_SESSION"
      -        ],
      -        "type": "string"
      -      },
      -      "event_name": {
      -        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      -        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "mark_key_event",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "event_name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Stop counting an event as a key event",
      -    "properties": {
      -      "event_name": {
      -        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      -        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "unmark_key_event",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "event_name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Recount an existing key event; a Google Ads action imported from it follows (ONCE_PER_SESSION is Ads' one per click)",
      -    "properties": {
      -      "counting": {
      -        "description": "ONCE_PER_EVENT: every time; ONCE_PER_SESSION: one per visit",
      -        "enum": [
      -          "ONCE_PER_EVENT",
      -          "ONCE_PER_SESSION"
      -        ],
      -        "type": "string"
      -      },
      -      "event_name": {
      -        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      -        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "set_key_event_counting",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "event_name",
      -      "counting"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Link a GA4 property to a Google Ads account, so Ads can import its key events and GA4 shows ad clicks and cost (the user must be an admin of both)",
      -    "properties": {
      -      "customer_id": {
      -        "description": "Google Ads customer ID, with or without dashes",
      -        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "link_google_ads",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "customer_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Remove the link between a GA4 property and a Google Ads account",
      -    "properties": {
      -      "customer_id": {
      -        "description": "Google Ads customer ID, with or without dashes",
      -        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "unlink_google_ads",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "customer_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "description": "Create a GA4 property with a web data stream for the site; the result gives the measurement ID and the tag to add to every page",
      +    "properties": {
      +      "account_id": {
      +        "description": "Google Analytics account id (from analytics_properties' accounts)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "currency": {
      +        "default": "USD",
      +        "description": "Currency for revenue, ISO 4217",
      +        "pattern": "^[A-Z]{3}$",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Property name, usually the business or site",
      +        "maxLength": 100,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "time_zone": {
      +        "description": "IANA time zone reports use, e.g. America/New_York",
      +        "maxLength": 64,
      +        "minLength": 3,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "create_ga4_property",
      +        "type": "string"
      +      },
      +      "website_url": {
      +        "description": "The site's address, e.g. https://www.example.com",
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "account_id",
      +      "name",
      +      "website_url",
      +      "time_zone"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Mark an event as a key event (GA4's conversion), so it is counted and can be imported into Google Ads",
      +    "properties": {
      +      "counting": {
      +        "default": "ONCE_PER_EVENT",
      +        "description": "ONCE_PER_EVENT counts every time; ONCE_PER_SESSION counts one per visit (leads)",
      +        "enum": [
      +          "ONCE_PER_EVENT",
      +          "ONCE_PER_SESSION"
      +        ],
      +        "type": "string"
      +      },
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "mark_key_event",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Stop counting an event as a key event",
      +    "properties": {
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "unmark_key_event",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Recount an existing key event; a Google Ads action imported from it follows (ONCE_PER_SESSION is Ads' one per click)",
      +    "properties": {
      +      "counting": {
      +        "description": "ONCE_PER_EVENT: every time; ONCE_PER_SESSION: one per visit",
      +        "enum": [
      +          "ONCE_PER_EVENT",
      +          "ONCE_PER_SESSION"
      +        ],
      +        "type": "string"
      +      },
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "set_key_event_counting",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name",
      +      "counting"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Link a GA4 property to a Google Ads account, so Ads can import its key events and GA4 shows ad clicks and cost (the user must be an admin of both)",
      +    "properties": {
      +      "customer_id": {
      +        "description": "Google Ads customer ID, with or without dashes",
      +        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "link_google_ads",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "customer_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Remove the link between a GA4 property and a Google Ads account",
      +    "properties": {
      +      "customer_id": {
      +        "description": "Google Ads customer ID, with or without dashes",
      +        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "unlink_google_ads",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "customer_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Register a parameter as a GA4 custom dimension so reports can use it (customEvent:<parameter_name>). Counted from registration on, in reports after 24-48 hours",
      +    "properties": {
      +      "display_name": {
      +        "description": "Name shown in GA4; defaults to parameter_name",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_ ]{0,81}$",
      +        "type": "string"
      +      },
      +      "parameter_name": {
      +        "description": "The parameter the site already sends, e.g. form_id",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "scope": {
      +        "default": "EVENT",
      +        "description": "EVENT: an event parameter; USER: a user property; ITEM: an ecommerce item parameter",
      +        "enum": [
      +          "EVENT",
      +          "USER",
      +          "ITEM"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "register_custom_dimension",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "parameter_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Register a numeric event parameter as a GA4 custom metric so reports can use it (customEvent:<parameter_name>). Counted from registration on, in reports after 24-48 hours",
      +    "properties": {
      +      "currency_data": {
      +        "description": "CURRENCY only: REVENUE_DATA (default) or COST_DATA",
      +        "enum": [
      +          "REVENUE_DATA",
      +          "COST_DATA"
      +        ],
      +        "type": "string"
      +      },
      +      "display_name": {
      +        "description": "Name shown in GA4; defaults to parameter_name",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_ ]{0,81}$",
      +        "type": "string"
      +      },
      +      "parameter_name": {
      +        "description": "The numeric event parameter the site already sends, e.g. order_weight",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "register_custom_metric",
      +        "type": "string"
      +      },
      +      "unit": {
      +        "default": "STANDARD",
      +        "description": "STANDARD for a plain number; CURRENCY for money; or a distance or time unit",
      +        "enum": [
      +          "STANDARD",
      +          "CURRENCY",
      +          "FEET",
      +          "METERS",
      +          "KILOMETERS",
      +          "MILES",
      +          "MILLISECONDS",
      +          "SECONDS",
      +          "MINUTES",
      +          "HOURS"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "parameter_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Change a registered custom metric's unit, or a money metric between revenue and cost data. Google fixes money at registration: to or from CURRENCY, archive and register again",
      +    "properties": {
      +      "currency_data": {
      +        "description": "CURRENCY only: REVENUE_DATA (default) or COST_DATA",
      +        "enum": [
      +          "REVENUE_DATA",
      +          "COST_DATA"
      +        ],
      +        "type": "string"
      +      },
      +      "parameter_name": {
      +        "description": "A registered custom metric's parameter",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "set_custom_metric_unit",
      +        "type": "string"
      +      },
      +      "unit": {
      +        "enum": [
      +          "STANDARD",
      +          "CURRENCY",
      +          "FEET",
      +          "METERS",
      +          "KILOMETERS",
      +          "MILES",
      +          "MILLISECONDS",
      +          "SECONDS",
      +          "MINUTES",
      +          "HOURS"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "parameter_name",
      +      "unit"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Archive a custom dimension (GA4 has no delete and can't restore it); the parameter can be registered again as a new one",
      +    "properties": {
      +      "parameter_name": {
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "resource_name": {
      +        "description": "Leave out",
      +        "type": "string"
      +      },
      +      "scope": {
      +        "default": "EVENT",
      +        "enum": [
      +          "EVENT",
      +          "USER",
      +          "ITEM"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "archive_custom_dimension",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "parameter_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Archive a custom metric (GA4 has no delete and can't restore it); the parameter can be registered again as a new one, e.g. to change it to or from money",
      +    "properties": {
      +      "parameter_name": {
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "resource_name": {
      +        "description": "Leave out",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "archive_custom_metric",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "parameter_name"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changedv0.20.0
    • changedInput schema / properties / changes / items / oneOf
      Previous value: -[
      -  {
      -    "description": "Create a GA4 property with a web data stream for the site; the result gives the measurement ID and the tag to add to every page",
      -    "properties": {
      -      "account_id": {
      -        "description": "Google Analytics account id (from analytics_properties' accounts)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "currency": {
      -        "default": "USD",
      -        "description": "Currency for revenue, ISO 4217",
      -        "pattern": "^[A-Z]{3}$",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "Property name, usually the business or site",
      -        "maxLength": 100,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "time_zone": {
      -        "description": "IANA time zone reports use, e.g. America/New_York",
      -        "maxLength": 64,
      -        "minLength": 3,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "create_ga4_property",
      -        "type": "string"
      -      },
      -      "website_url": {
      -        "description": "The site's address, e.g. https://www.example.com",
      -        "format": "uri",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "account_id",
      -      "name",
      -      "website_url",
      -      "time_zone"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Mark an event as a key event (GA4's conversion), so it is counted and can be imported into Google Ads",
      -    "properties": {
      -      "counting": {
      -        "default": "ONCE_PER_EVENT",
      -        "description": "ONCE_PER_EVENT counts every time; ONCE_PER_SESSION counts one per visit (leads)",
      -        "enum": [
      -          "ONCE_PER_EVENT",
      -          "ONCE_PER_SESSION"
      -        ],
      -        "type": "string"
      -      },
      -      "event_name": {
      -        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      -        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "mark_key_event",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "event_name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Stop counting an event as a key event",
      -    "properties": {
      -      "event_name": {
      -        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      -        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "unmark_key_event",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "event_name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Link a GA4 property to a Google Ads account, so Ads can import its key events and GA4 shows ad clicks and cost (the user must be an admin of both)",
      -    "properties": {
      -      "customer_id": {
      -        "description": "Google Ads customer ID, with or without dashes",
      -        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "link_google_ads",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "customer_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Remove the link between a GA4 property and a Google Ads account",
      -    "properties": {
      -      "customer_id": {
      -        "description": "Google Ads customer ID, with or without dashes",
      -        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      -        "type": "string"
      -      },
      -      "property_id": {
      -        "description": "GA4 property id (from analytics_properties)",
      -        "pattern": "^\\d+$",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "unlink_google_ads",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "property_id",
      -      "customer_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "description": "Create a GA4 property with a web data stream for the site; the result gives the measurement ID and the tag to add to every page",
      +    "properties": {
      +      "account_id": {
      +        "description": "Google Analytics account id (from analytics_properties' accounts)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "currency": {
      +        "default": "USD",
      +        "description": "Currency for revenue, ISO 4217",
      +        "pattern": "^[A-Z]{3}$",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Property name, usually the business or site",
      +        "maxLength": 100,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "time_zone": {
      +        "description": "IANA time zone reports use, e.g. America/New_York",
      +        "maxLength": 64,
      +        "minLength": 3,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "create_ga4_property",
      +        "type": "string"
      +      },
      +      "website_url": {
      +        "description": "The site's address, e.g. https://www.example.com",
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "account_id",
      +      "name",
      +      "website_url",
      +      "time_zone"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Mark an event as a key event (GA4's conversion), so it is counted and can be imported into Google Ads",
      +    "properties": {
      +      "counting": {
      +        "default": "ONCE_PER_EVENT",
      +        "description": "ONCE_PER_EVENT counts every time; ONCE_PER_SESSION counts one per visit (leads)",
      +        "enum": [
      +          "ONCE_PER_EVENT",
      +          "ONCE_PER_SESSION"
      +        ],
      +        "type": "string"
      +      },
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "mark_key_event",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Stop counting an event as a key event",
      +    "properties": {
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "unmark_key_event",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Recount an existing key event; a Google Ads action imported from it follows (ONCE_PER_SESSION is Ads' one per click)",
      +    "properties": {
      +      "counting": {
      +        "description": "ONCE_PER_EVENT: every time; ONCE_PER_SESSION: one per visit",
      +        "enum": [
      +          "ONCE_PER_EVENT",
      +          "ONCE_PER_SESSION"
      +        ],
      +        "type": "string"
      +      },
      +      "event_name": {
      +        "description": "GA4 event name, e.g. generate_lead, purchase, sign_up, or a custom event the site sends",
      +        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,39}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "set_key_event_counting",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "event_name",
      +      "counting"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Link a GA4 property to a Google Ads account, so Ads can import its key events and GA4 shows ad clicks and cost (the user must be an admin of both)",
      +    "properties": {
      +      "customer_id": {
      +        "description": "Google Ads customer ID, with or without dashes",
      +        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "link_google_ads",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "customer_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Remove the link between a GA4 property and a Google Ads account",
      +    "properties": {
      +      "customer_id": {
      +        "description": "Google Ads customer ID, with or without dashes",
      +        "pattern": "^\\d{3}-?\\d{3}-?\\d{4}$",
      +        "type": "string"
      +      },
      +      "property_id": {
      +        "description": "GA4 property id (from analytics_properties)",
      +        "pattern": "^\\d+$",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "unlink_google_ads",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "property_id",
      +      "customer_id"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Addedv0.15.0

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=false and idempotentHint=true, and the description reinforces this by stating twice that nothing is changed. It adds genuinely non-obvious behavior per change type — archived dimensions/metrics cannot be restored, registration counts only from that point and appears in reports after 24-48 hours, and money units are fixed at registration. It does not explain what identifier the stored proposal returns, which is the one gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core behavior and the no-op guarantee before the approval workflow and the type catalog. The type enumeration is a long run-on sentence, but each clause carries distinct information about scope rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a proposal-only mutation tool with no output schema, the description covers the safety model, the approval handoff, reversal, and the full supported change set. The only omission is how the resulting proposal is referenced by apply_changes or discard_proposal, which an agent may need to chain the next call.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and every oneOf variant carries its own description, so the schema already does the heavy lifting for the single `changes` array. The description's type list adds framing but no syntax or format detail beyond what the schema provides, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("checks Google Analytics setup changes against the live property and stores them as a proposal") and immediately delimits it from apply_changes and undo_changes. The enumerated supported change types let an agent confirm the tool covers the intended mutation without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit workflow: show the summary to the user, apply only after approval with apply_changes, and use undo_changes to reverse. It also names the alternative tools and adds a concrete pre-approval step ("Point out any ⚠ line before they approve"), leaving little to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.