Tracking Plan MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tracking Plan MCP Server Create an ecommerce GA4 tracking plan."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tracking Plan MCP Server
Beginner-friendly Model Context Protocol (MCP) server built with TypeScript + Node.js to create, list, inspect, and validate tracking plans for Ecommerce and Lead-Generation / Service Businesses.
š Project Overview
The Tracking Plan MCP Server allows AI assistants (such as Cursor, Claude Desktop, and Antigravity) to manage analytics tracking specifications locally.
It supports two distinct business models out-of-the-box:
Ecommerce Businesses: Product views, cart activity, checkout steps, payment info, revenue, and purchase transactions.
Lead Generation & Service Businesses: Service views, form starts, form submissions, lead generation, phone clicks, email clicks, WhatsApp clicks, appointment bookings, and quote requests.
Related MCP server: Orchestration MCP
šļø Architecture & Data Flow
AI Assistant (Cursor / Claude Desktop / Antigravity)
ā
MCP Client
ā
MCP Server (stdio transport)
ā
MCP Tools (create_tracking_plan, get_tracking_plan, list_tracking_plans, validate_tracking_event)
ā
Tracking Plan Service (Business logic & Validation)
ā
JSON Storage (fs/promises)
ā
data/tracking-plans.jsonš¼ Supported Business Types
š 1. Ecommerce
Tracks:
Product page views (
view_item)Cart interactions (
add_to_cart,remove_from_cart,view_cart)Checkout flow (
begin_checkout,add_payment_info)Purchases & revenue (
purchase)
Purchase Event Required Parameters: transaction_id, value, currency, items.
š 2. Lead Generation / Service Businesses
Tracks:
Service page views (
view_service)Form interactions (
form_start,form_submit)Lead submissions (
generate_lead)Direct contacts (
contact,phone_click,email_click,whatsapp_click)Appointment bookings (
appointment_start,appointment_booked)Quote requests (
quote_request)
Lead Submission Required Parameters: form_id, form_name.
š ļø MCP Tools Reference
Tool Name | Parameters | Description |
|
| Creates a new tracking plan after validating business_type and checking duplicate IDs. |
|
| Retrieves complete tracking plan definition. |
|
| Lists all tracking plans, optionally filtered by |
|
| Validates a tracking payload against plan schemas, returning errors and warnings. |
š Project Structure
tracking-plan-mcp/
āāā data/
ā āāā tracking-plans.json # JSON persistence storage
āāā dist/ # Compiled JavaScript output
āāā src/
ā āāā index.ts # MCP Server entry point & tool registration
ā āāā models/
ā ā āāā tracking.ts # TypeScript types, Zod schemas, & ErrorCodes
ā āāā services/
ā ā āāā trackingPlanService.ts # Business logic & event validator
ā āāā storage/
ā ā āāā jsonStorage.ts # Safe JSON storage reader/writer
ā āāā tools/
ā āāā createTrackingPlan.ts # create_tracking_plan tool handler
ā āāā getTrackingPlan.ts # get_tracking_plan tool handler
ā āāā listTrackingPlans.ts # list_tracking_plans tool handler
ā āāā validateTrackingEvent.ts # validate_tracking_event tool handler
āāā tests/
ā āāā createTrackingPlan.test.ts
ā āāā getTrackingPlan.test.ts
ā āāā listTrackingPlans.test.ts
ā āāā validateTrackingEvent.test.ts
āāā .gitignore
āāā package.json
āāā tsconfig.json
āāā vitest.config.ts
āāā README.mdš Quick Start & Development
1. Installation
npm install2. Run Vitest Unit Tests
npm test3. Build Project
npm run build4. Start Server
npm startāļø MCP Client Configuration
Cursor IDE Configuration
Add to .cursor/mcp.json or Cursor MCP settings:
{
"mcpServers": {
"tracking-plan-mcp": {
"command": "node",
"args": ["C:/Users/FLS/.gemini/antigravity/scratch/tracking-plan-mcp/dist/index.js"]
}
}
}Antigravity Configuration
Add to .gemini/antigravity/mcp_config.json:
{
"mcpServers": {
"tracking-plan-mcp": {
"command": "node",
"args": ["C:/Users/FLS/.gemini/antigravity/scratch/tracking-plan-mcp/dist/index.js"]
}
}
}š¬ Example AI Prompts
"Create an ecommerce GA4 tracking plan."
"Create a lead generation tracking plan for an HVAC business."
"Show me all ecommerce tracking plans."
"Show me all lead generation tracking plans."
"Validate this purchase event against the ecommerce tracking plan:
{ name: 'purchase', value: 99.99, currency: 'USD' }""Validate this lead form submission against the lead generation tracking plan:
{ name: 'generate_lead', form_id: 'f1', form_name: 'Contact Form' }"
š License
Licensed under the MIT License.
Available Tools
4 toolscreate_tracking_planC
Creates a new tracking plan specification for an ecommerce or lead-generation business.
Inputs: id (required), name (required), events (required), platform (required), +2 more.
get_tracking_planB
Retrieves a complete tracking plan definition by plan_id.
Inputs: plan_id (required).
list_tracking_plansB
Lists all available tracking plans with optional filtering by business_type ('ecommerce' or 'lead_generation').
Inputs: business_type.
validate_tracking_eventC
Validates an analytics tracking event payload against a target tracking plan schema.
Inputs: event (required), plan_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 4 tools
Each tool has a distinct purpose: retrieve a single plan, list plans, create a plan, and validate an event. No overlapping functionality, and the boundaries are clear from names and descriptions.
All tools follow a consistent snake_case verb_noun pattern (get_, list_, create_, validate_). No deviations or mixed conventions.
Four tools is a lean and well-scoped set for tracking plan operations. Each tool serves a clear role without redundancy.
Core operations (create, read/list, validate event) are present, but missing update and delete operations leaves a notable gap in lifecycle management. Agents cannot modify or remove tracking plans.
Maintenance
Related MCP Connectors
Hosted MCP server for marketing analytics: plan tracking, draft GTM tags, audit tags. Free in beta
MCP server for Modern Treasury ā payment orders, transactions, counterparties and ledgers.
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
Cross-product MCP server for CRM, LeadKit, ProjectKit, Bookio. 10 action types, MIT open spec.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA TypeScript MCP server for managing persistent knowledge graphs with entities, directional relations, and time-based observations. It enables users to create, search, and track structured information with built-in concurrency control and JSON file storage.MIT
- FlicenseAqualityDmaintenanceA TypeScript MCP server for launching, tracking, and managing external coding-agent runs across local and remote backends like Codex and Claude Code. It allows top-level agents to orchestrate subagents through tools for spawning tasks, polling events, and handling interactive sessions.72-
- FlicenseNot gradedqualityDmaintenanceA TypeScript MCP server that validates codebases against configurable rules. It analyzes files for violations and generates JSON reports, supporting custom rule definitions and file extensions.-
- AlicenseAqualityDmaintenanceA production-ready MCP server for Google Tag Manager, GA4 Measurement Protocol, DataLayer schema validation, Meta CAPI auditing, and tracking code snippet generation.4MIT