{"version":"3.0.0","version_changelog_url":"https://www.tracklution.com/agent-install.md#changelog","signup_url":"https://www.tracklution.com/start","dashboard_url":"https://www.tracklution.com/dashboard","agent_protocol_url":"https://www.tracklution.com/agent-install.md","mcp_url":"https://mcp.tracklution.com/mcp","api_base_url":"https://api.trlution.com/mcp-api/v1","pixel_snippet_instructions":"Each tracking container has its own install snippet (container-specific tracking key + first-party hostname). The canonical snippet is shown in the user's Tracklution dashboard at https://www.tracklution.com/dashboard after they create a tracking container. AI coding agents MUST use the Tracklution MCP at https://mcp.tracklution.com/mcp and call `get_installation_scripts` to receive the snippet programmatically. DO NOT construct the snippet yourself — the bootstrap IIFE that defines `tlq()`, the first-party hostname, and the tracking key are all account-specific and cannot be guessed from this manifest. Direct human installation: copy the snippet from the dashboard. See /docs/install-website-tracking-with-manual-code-installation/ for the manual flow.","mcp_install_methods":{"cursor":{"type":"file-edit","target_paths":[".cursor/mcp.json","~/.cursor/mcp.json"],"merge_key":"mcpServers.tracklution","body":{"url":"https://mcp.tracklution.com/mcp"},"deeplink":"cursor://anysphere.cursor-deeplink/mcp/install?name=tracklution&config=eyJ1cmwiOiJodHRwczovL21jcC50cmFja2x1dGlvbi5jb20vbWNwIn0=","post_install_message":"Open Cursor → Settings → MCP and toggle 'tracklution' on, then say 'go'.","min_version":"0.48.0","agent_client_value":"cursor"},"claude_code":{"type":"cli","command":"claude mcp add --transport http tracklution https://mcp.tracklution.com/mcp","post_install_message":"Run '/mcp' in Claude Code to confirm 'tracklution' is connected, then say 'go'.","agent_client_value":"claude-code"},"codex":{"type":"file-edit","target_paths":["~/.codex/config.toml","%USERPROFILE%/.codex/config.toml"],"merge_key":"mcp_servers.tracklution","body_toml":"[mcp_servers.tracklution]\nurl = \"https://mcp.tracklution.com/mcp\"\nenabled = true\n","post_install_message":"Restart your Codex CLI session, then say 'go'.","agent_client_value":"codex"},"windsurf":{"type":"file-edit","target_paths":["~/.codeium/windsurf/mcp_config.json","%USERPROFILE%/.codeium/windsurf/mcp_config.json"],"merge_key":"mcpServers.tracklution","body":{"serverUrl":"https://mcp.tracklution.com/mcp"},"post_install_message":"Fully restart Windsurf (close from system tray, then reopen). Then say 'go'.","agent_client_value":"windsurf"},"lovable":{"type":"user-action","ui_path":"Lovable Settings → Integrations → MCP servers → Add custom MCP server","value":"https://mcp.tracklution.com/mcp","instruction":"Open Lovable Settings → Integrations → MCP servers → Add custom MCP server. Use the URL https://mcp.tracklution.com/mcp (no authentication needed). Custom MCP servers are available on paid Lovable plans. Then say 'go'.","agent_client_value":"lovable"},"replit":{"type":"user-action","ui_path":"https://replit.com/integrations → MCP Servers → Add MCP server","value":"https://mcp.tracklution.com/mcp","instruction":"Go to https://replit.com/integrations → MCP Servers section → Add MCP server. Name it 'tracklution'. URL: https://mcp.tracklution.com/mcp (no authentication). Click Test & Save. Then say 'go'.","agent_client_value":"replit"},"bolt":{"type":"user-action","ui_path":"Bolt → Connectors → Add custom connector","value":"https://mcp.tracklution.com/mcp","instruction":"Open Bolt → Connectors → Add custom connector. URL: https://mcp.tracklution.com/mcp. Transport: HTTP. No authentication needed. Then say 'go'.","agent_client_value":"bolt"}},"frameworks":{"html":{"where_to_paste":" of every page, BEFORE any event-tracking scripts","doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-manual-code-installation/"},"nextjs":{"where_to_paste":"app/layout.tsx via next/script with strategy='afterInteractive'","doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-manual-code-installation/"}},"installation_methods":{"manual":{"agent_action":"manual_snippet","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-manual-code-installation/","description":"Agent pastes the snippet from get_installation_scripts into the project's HTML head or framework equivalent."},"shopify":{"agent_action":"platform_app","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-shopify-app/","description":"Hand off to user: install the official Tracklution Shopify app from the Shopify App Store. Agent prints the deeplink; user clicks. No code editing."},"woocommerce":{"agent_action":"platform_app","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-woocommerce-plugin/","description":"Hand off to user: install the Tracklution WooCommerce plugin via WordPress admin → Plugins → Add New."},"stripe":{"agent_action":"webhook","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/stripe-integration/","description":"Hand off to user: configure a Stripe webhook to POST to https://t./collect/hook?k= on payment_intent.succeeded."},"gtm":{"agent_action":"tag_manager","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/install-website-tracking-with-chtml-tags-in-gtm/","description":"Install via Google Tag Manager using cHTML tags. Agent guides the user through the GTM UI; agent itself cannot edit GTM containers."},"gtm-template":{"agent_action":"tag_manager","mcp_supported":true,"doc_url":"https://www.tracklution.com/docs/gtm-template/","description":"Install via the prebuilt Tracklution GTM community template. Lower friction than raw cHTML."},"affiliate":{"agent_action":"webhook","mcp_supported":false,"doc_url":"https://www.tracklution.com/docs/custom--affiliate-connector/","description":"Affiliate / postback URL configuration. Hand off to the user — the affiliate network UI is the source of truth."},"magic":{"agent_action":"auto_detect","mcp_supported":false,"doc_url":"https://www.tracklution.com/docs/magic-automatic-event-detection/","description":"Experimental: Tracklution auto-detects event triggers in the rendered page. Not user-facing today; agents should not select this method."}},"standard_events":[{"name":"PageView","required_params":[],"optional_params":["url"],"description":"Auto-fired on every page load by the main script. Manual firing rarely needed."},{"name":"Purchase","required_params":["event"],"optional_params":["value","currency","order_id","email","phoneNumber","content_ids","contents"],"description":"E-commerce purchase. value+currency strongly recommended for ROAS optimization."},{"name":"Lead","required_params":["event"],"optional_params":["value","currency","form_id","email","phoneNumber"],"description":"Lead-gen form submission. value optional; some advertisers assign a static lead value."},{"name":"AddToCart","required_params":["event"],"optional_params":["value","currency","content_ids","contents"],"description":"Item added to cart."},{"name":"ViewContent","required_params":["event"],"optional_params":["value","currency","content_ids","contents"],"description":"Product / content detail page view. Used for remarketing audiences."},{"name":"AddToWishlist","required_params":["event"],"optional_params":["value","currency","content_ids"],"description":"Item added to wishlist / favorites."},{"name":"InitiateCheckout","required_params":["event"],"optional_params":["value","currency","content_ids","contents"],"description":"Checkout flow started (before payment)."},{"name":"CompleteRegistration","required_params":["event"],"optional_params":["value","currency","email"],"description":"User registration completed."},{"name":"Subscribe","required_params":["event"],"optional_params":["value","currency","email"],"description":"Newsletter / SaaS subscription started."},{"name":"Search","required_params":["event"],"optional_params":["search_string"],"description":"On-site search performed."},{"name":"Contact","required_params":["event"],"optional_params":["email","phoneNumber"],"description":"Contact-form submission or phone/email click."}]}