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 tools8 tools
list_gtm_containers
Leitura1 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
Leitura1 creditsWorkspaces of a GTM container. Read only.
| Parameter | Type | Description |
|---|---|---|
containerRequired | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
list_gtm_tags
Leitura1 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 |
|---|---|---|
containerRequired | 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
Leitura1 creditsTriggers in a GTM workspace with type and conditions. Read only.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Leitura1 creditsUser-defined and enabled built-in variables in a GTM workspace. Read only.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Leitura1 creditsContainer versions (newest first) and the currently live version. Use before revert_gtm_version. Read only.
| Parameter | Type | Description |
|---|---|---|
containerRequired | string | container id, GTM-XXXXXXX public id, name, or accounts/A/containers/C path |
account_idOptional | string | — |
limitOptional | integer (1–100) | — |
list_gtm_permissions
Leitura1 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
Leitura3 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 |
|---|---|---|
containerRequired | 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 tools9 tools
create_gtm_workspace
Escrita2 creditsCreate a GTM workspace. Opens an approval item with a preview; created only after approval.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Escrita2 creditsCreate a GTM tag (GA4 event, Google Ads conversion, conversion linker, Google tag or custom HTML) in a workspace. Preview shows the exact GTM body; applied after approval; nothing is live until publish_gtm_version.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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 | — |
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
Escrita2 creditsCreate a GTM trigger (page view, custom event, click, form submission, …) with optional conditions. Approval item with preview.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Escrita2 creditsCreate a user-defined GTM variable (data layer, constant, cookie, URL, JavaScript, DOM element, lookup table). Approval item with preview.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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. |
notesOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
enable_gtm_builtin_variables
Escrita2 creditsEnable built-in GTM variables (Click URL, Form ID, Page Path, …) in a workspace. Approval item.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Escrita2 creditsCreate a named container version from the workspace and publish it live. Riskiest GTM operation: always previewed with the version name and notes, applied only after approval.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Escrita2 creditsRe-publish an earlier container version (default: the one before the live version). Approval item; use list_gtm_versions first.
| Parameter | Type | Description |
|---|---|---|
containerRequired | 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
Escrita2 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 only after approval.
| 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
EscritaIrreversible2 creditsRemove a user from a Google Tag Manager account and all of its containers. Preview shows the access being removed; applied only after approval.
| 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.