Tag Manager tools
Containers, workspaces, tags, triggers, variables, version publishing and rollback.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools10 tools
list_gtm_accounts
קריאה1 creditsGoogle Tag Manager accounts the connected Google user can access (account id, name, path) and the selected container, if any. Read only.
This tool takes no parameters.
gtm_workspace_status
קריאה1 creditsWhat is waiting to be published in a GTM workspace: every added, updated or deleted tag/trigger/variable plus merge conflicts, with counts. Check before publish_gtm_version. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
list_gtm_containers
קריאה1 creditsGoogle Tag Manager accounts and containers the connected Google user can access (id, GTM-XXXX public id, name). Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | — |
list_gtm_workspaces
קריאה1 creditsWorkspaces of a GTM container. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
list_gtm_tags
קריאה1 creditsTags in a GTM workspace with type, parameters and firing triggers; flags tags that have no trigger (never fire) and paused tags. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
list_gtm_triggers
קריאה1 creditsTriggers in a GTM workspace with type and conditions. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
list_gtm_variables
קריאה1 creditsUser-defined and enabled built-in variables in a GTM workspace. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
list_gtm_versions
קריאה1 creditsContainer versions (newest first), each marked live or not, and the currently live version; details=true adds each version's tags, triggers and variables. Use before revert_gtm_version. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
limitOptional | integer (1–100) | — |
detailsOptional | boolean | also list tag/trigger/variable names of the newest 10 versions |
list_gtm_permissions
קריאה1 creditsWho has access to a GTM account and at which level per container (read, edit, approve, publish). Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | — |
verify_gtm_conversion_tag
קריאה3 creditsAudit: is there a Google Ads conversion tag (awct) attached to a thank-you-page trigger, and is a conversion linker present? Checks the live version by default. Read only.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
sourceOptional | live | workspace | — |
thank_you_pathOptional | string | URL fragment of the thank-you page, e.g. /tesekkurler |
Write tools14 tools
connect_tag_manager
כתיבה0 creditsStart connecting Google Tag Manager (containers, workspaces, tags, versions, publishing, user access): returns a one-time authorisation link the user opens (same flow as connect_account). Nothing is connected until the user signs in.
This tool takes no parameters.
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gtm_container
כתיבה5 creditsCreate a new, empty GTM container (own tags, triggers, variables and GTM-XXXX id) in an account. Approval item; nothing runs until its snippet is installed and a version is published.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
account_idOptional | string | GTM account id or name; optional with a single account |
usage_contextOptional | web | server | amp | android | ios | default web |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_gtm_container
כתיבהIrreversible3 creditsPERMANENTLY delete a whole GTM container with all its tags, triggers, variables and versions. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone; the container must be named explicitly.
| Parameter | Type | Description |
|---|---|---|
containerRequired | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_gtm_entity
כתיבה3 creditsEdit an existing GTM tag, trigger, variable or workspace by its path: rename, notes, parameters (merged by key or replaced), a tag's firing triggers or paused flag. Preview shows old and new values; applied directly; nothing is live until publish_gtm_version.
| Parameter | Type | Description |
|---|---|---|
kindRequired | tag | trigger | variable | workspace | — |
pathRequired | string | full path from list_gtm_tags / triggers / variables / workspaces |
nameOptional | string | — |
notesOptional | string | — |
descriptionOptional | string | workspace only |
parametersOptional | array<object> | raw GTM parameter objects, e.g. [{type: 'template', key: 'eventName', value: 'purchase'}] |
replace_parametersOptional | boolean | true replaces all parameters; default merges by key |
firing_trigger_idsOptional | array<string> | tag only; replaces the firing triggers |
pausedOptional | boolean | tag only |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_gtm_entity
כתיבהIrreversible3 creditsPERMANENTLY delete a GTM tag, trigger, variable or workspace by its path. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
kindRequired | tag | trigger | variable | workspace | — |
pathRequired | string | full path from list_gtm_tags / triggers / variables / workspaces |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gtm_workspace
כתיבה2 creditsCreate a GTM workspace. Created directly when the user asks; the result shows the preview.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
nameRequired | string | — |
descriptionOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gtm_tag
כתיבה2 creditsCreate a GTM tag (GA4 event, Google Ads conversion, conversion linker, Google tag, custom HTML, or any other tag type with kind=custom + tag_type + raw parameters) in a workspace. Preview shows the exact GTM body; applied directly; nothing is live until publish_gtm_version.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
nameRequired | string | — |
kindRequired | ga4_event | ads_conversion | conversion_linker | google_tag | html | custom | — |
tag_typeOptional | string | kind=custom: GTM tag type code (e.g. gaawc, img, sp) |
parametersOptional | array<object> | raw GTM parameter objects, e.g. [{type: 'template', key: 'eventName', value: 'purchase'}] |
firing_optionOptional | oncePerEvent | oncePerLoad | unlimited | — |
paramsOptional | object | ga4_event: event_name, measurement_id (G-…), event_parameters {name: value or {{Variable}}}, send_ecommerce_data. ads_conversion: conversion_id (AW-… or digits), conversion_label, value, currency, order_id. google_tag: tag_id. html: html. |
firing_trigger_idsOptional | array<string> | — |
firing_trigger_namesOptional | array<string> | trigger names (e.g. 'All Pages') resolved to ids on apply |
notesOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gtm_trigger
כתיבה2 creditsCreate a GTM trigger (page view, custom event, click, form submission, …) with optional conditions. Approval item with preview.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
nameRequired | string | — |
kindOptional | click | custom_event | dom_ready | element_visibility | form_submission | history_change | js_error | link_click | page_view | pageview | scroll_depth | timer | window_loaded | — |
event_nameOptional | string | for kind=custom_event |
page_pathOptional | string | shortcut: fire only when Page URL contains this |
conditionsOptional | array<object> | — |
wait_for_tagsOptional | boolean | — |
notesOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gtm_variable
כתיבה2 creditsCreate a user-defined GTM variable (data layer, constant, cookie, URL, JavaScript, DOM element, lookup table). Approval item with preview.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
nameRequired | string | — |
kindOptional | auto_event | constant | cookie | custom_js | data_layer | dom_element | javascript | lookup_table | url | — |
paramsOptional | object | data_layer: data_layer_name, version, default_value. constant: value. javascript/cookie: name. url: component, query_key. custom_js: javascript. dom_element: element_id or selector, attribute. lookup_table: input, table. |
variable_typeOptional | string | kind=custom: GTM variable type code (e.g. gas, r, f) |
parametersOptional | array<object> | raw GTM parameter objects, e.g. [{type: 'template', key: 'eventName', value: 'purchase'}] |
notesOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
enable_gtm_builtin_variables
כתיבה2 creditsEnable built-in GTM variables (Click URL, Form ID, Page Path, …) in a workspace. Approval item.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
variablesRequired | array<string> | e.g. ['Click URL', 'Form ID', 'Page Path'] |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
publish_gtm_version
כתיבהIrreversible2 creditsCreate a named container version from the workspace and publish it live. Riskiest GTM operation: only call it when the user asked; the result shows the version name and notes.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
workspaceOptional | string | workspace id or name; default: Default Workspace |
version_nameRequired | string | — |
notesOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
revert_gtm_version
כתיבהIrreversible2 creditsRe-publish an earlier container version (default: the one before the live version). Approval item; use list_gtm_versions first.
| Parameter | Type | Description |
|---|---|---|
containerOptional | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
version_idOptional | string | omit to go back to the version before the live one |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_gtm_permission
כתיבה2 creditsGrant or change a user's Google Tag Manager access: account level (user/admin) and per-container (read, edit, approve, publish, noAccess). Existing users are updated, new e-mails are invited. Preview shows current vs new access; applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | GTM account id or name; optional with a single account |
emailRequired | string | — |
account_permissionOptional | user | admin | noAccess | — |
containersOptional | array<object> | — |
replace_containersOptional | boolean | true: the list replaces all container access; default merges |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
remove_gtm_permission
כתיבהIrreversible2 creditsRemove a user from a Google Tag Manager account and all of its containers. Preview shows the access being removed; applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | — |
emailRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.