@akson/cortex-gtm

Unified Google Tag Manager client with Terraform-like state management and MCP server integration.

Features

• 🏗️ Terraform-like State Management - Infrastructure as code for GTM
• 📡 MCP Server - Model Context Protocol server for Claude AI integration
• ⚡ CLI Tools - Command-line interface for GTM operations
• 🔧 Multi-format Support - Client, Terraform, and MCP exports
• 📊 State Tracking - Manage GTM configuration changes over time

Installation

npm install @akson/cortex-gtm

Usage

Basic Client

import { GTMClient } from '@akson/cortex-gtm/client';

const client = new GTMClient({
  containerId: 'GTM-XXXXXXX',
  serviceAccountKeyFile: 'path/to/key.json'
});

// Get container information
const container = await client.getContainer();

Terraform-like State Management

import { GTMTerraform } from '@akson/cortex-gtm/terraform';

const terraform = new GTMTerraform({
  containerId: 'GTM-XXXXXXX',
  serviceAccountKeyFile: 'path/to/key.json'
});

// Plan changes
const plan = await terraform.plan('gtm.config.yaml');

// Apply changes
await terraform.apply();

CLI Usage

# Basic GTM operations
gtm container list
gtm tags list
gtm triggers list

# Terraform-like operations
gtm plan --config gtm.config.yaml
gtm apply --config gtm.config.yaml

# MCP server
gtm-mcp

MCP Server Integration

# Start MCP server for Claude AI
gtm-mcp

Configuration

Create a gtm.config.yaml file:

container_id: "GTM-XXXXXXX"
workspace_id: 40

tags:
  - name: "GA4 Configuration"
    type: "googtag"
    parameters:
      - key: "tagId"
        value: "G-XXXXXXXXXX"

triggers:
  - name: "All Pages"
    type: "pageview"

Package Exports

• Main package - Core GTM functionality
• /client - GTM client implementation
• /terraform - Terraform-like state management
• /mcp - MCP server for Claude AI integration

Version History

• 3.0.0 - Current version with unified client and MCP server
• 2.x.x - Legacy versions

Contributing

Part of the Cortex packages ecosystem. Contributions welcome!

License

MIT

Support

For support, please open an issue in the Cortex Packages repository.