# Tag Pilot GTM

> Tag Pilot GTM is a free MCP server for marketing and seo. Read-only Google Tag Manager access with diffs against live and a container audit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://tagpilot.io/gtm-mcp
- **Repository:** https://github.com/tagpilot/ga4-mcp/tree/HEAD/packages/gtm-mcp
- **MCP Registry name:** io.github.tagpilot/gtm-mcp
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

Tag Pilot's GTM server needs no Google Cloud project, OAuth client or service account. The first question starts a device sign-in, like gh auth login, where you approve a code in a browser and grant the read-only tagmanager.readonly scope. Tag Manager data goes from your machine straight to Google and is not stored by Tag Pilot, which only brokers the token exchange.

Tools read the live published version by default, or a workspace or older version on request. Beyond listing accounts, containers and workspaces, it can show what references a variable or trigger, diff a workspace against live, and run audit_container, whose rule-of-thumb checks flag missing triggers, duplicate Google tags, tags without consent settings, unused triggers and paused tags. The server only sends GET requests.

## Features

- **Container inspection:** get_container returns tags, triggers, variables, templates and folders, compact by default.
- **Reference tracing:** find_references shows what uses a variable, trigger, tag, template or folder.
- **Diff against live:** diff lists entities added, changed or deleted compared with the live or another version.
- **Container audit:** audit_container flags missing triggers, duplicate Google tags and consent gaps.
- **Version history:** list_versions and get_live_version show history and the published contents.
- **Simple sign-in:** Device approval in the browser, or a tpk_ key for CI.

## Good for

- Audit a container before a publish
- See what changes a workspace would make live
- Find everything that depends on a variable
- Check which tags lack consent settings

## Install

### Claude Code (Terminal)

```sh
claude mcp add gtm-mcp --env TAGPILOT_API_KEY='<TAGPILOT_API_KEY>' -- npx -y @tagpilot/gtm-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gtm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/gtm-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gtm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/gtm-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gtm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/gtm-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gtm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/gtm-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gtm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/gtm-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_accounts`: Tag Manager accounts you can read.
- `list_containers`: Containers in an account.
- `list_workspaces`: Workspaces of a container.
- `get_container`: Tags, triggers, variables, templates and folders of a container.
- `get_tag`: One tag in full.
- `get_trigger`: One trigger in full.
- `get_variable`: One variable in full.
- `find_references`: What uses a variable, trigger, tag, template or folder.
- `list_versions`: Versions, newest first.
- `get_live_version`: The published version.
- `diff`: Workspace versus live version or another version.
- `audit_container`: Offline checks over one read of the container.
- `connect`: Starts the device connection.
- `connection_status`: Reports connection state.

## FAQ

### Can it edit my container?

No. It requests only tagmanager.readonly and sends only GET requests.

### Do I need a Google Cloud project?

No GCP project, OAuth client or service account is needed.

### What about CI?

Create a gtm:mcp key and set TAGPILOT_API_KEY in the environment.

### Does Tag Pilot see my data?

Data goes from your machine to Google; Tag Pilot only brokers the token exchange and stores no Google tokens.

### Is Tag Pilot GTM free?

Yes. Tag Pilot GTM is free to use.

### How do I add Tag Pilot GTM to Claude Code?

Run this command in your terminal: claude mcp add gtm-mcp --env TAGPILOT_API_KEY='<TAGPILOT_API_KEY>' -- npx -y @tagpilot/gtm-mcp

### What are the best alternatives to Tag Pilot GTM?

The closest alternatives to Tag Pilot GTM are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/tag-pilot-gtm
