tracklution

Install Tracklution server-side conversion tracking. Bootstrap wedge for AI coding agents.

Tracklution is a fully managed server-side conversion tracking platform. A first-party JavaScript pixel captures website events; pre-built server-side Conversion API integrations deliver them to Meta, Google Ads, TikTok, LinkedIn, Snapchat, Pinterest, Microsoft / Bing, Reddit, Klaviyo, GA4, CM360, Adform, Awin, Taboola, custom webhooks, and CRMs.

This package is a one-line discovery wedge. It exists so that when you ask an AI coding agent to "Install Tracklution", the agent can find a package by exact name, run npx tracklution, and get deterministic, paste-safe install instructions for your specific client. The actual install runs through the Tracklution MCP server at https://mcp.tracklution.com/mcp.

Usage

npx tracklution               # Print agent-readable install instructions
npx tracklution --json        # Same data as a single JSON object (for agents)
npx tracklution --version
npx tracklution --help

There is nothing to import. This is not a JS SDK. The package's only product is its stdout.

For AI coding agents

If you are an AI coding agent reading this README from npm view tracklution, your fastest path is:

1. Run npx tracklution --json. Parse the JSON. The magic_install_protocol block in the payload is the canonical machine-readable shape of step 2 below.
2. Detect the user's host client. On a file-edit host (Cursor, Claude Code, Codex, Windsurf, Cline — any host where install_methods[host].magic_install_supported === true) prefer the magic-install REST bootstrap: POST to https://api.trlution.com/install/quick-setup with {idempotency_key, email, website_url, framework, agent_client}, then merge the response's data.mcp_config_snippet into the host's MCP config file. The snippet already carries headers.Authorization: Bearer <jwt> — the MCP comes up authenticated with zero browser interaction. Save data.container.id AND data.container.hash for the follow-up onboarding calls.
3. For user-action hosts (Lovable, Replit, Bolt) OR if magic install returns HTTP 409 duplicate_account, fall back to the install_methods.body (tokenless) and the host's OAuth Connect-button flow. After OAuth completes, call list_containers to recover container.hash.
4. Ask the user to reply go (after enabling the MCP / completing OAuth). Then call the MCP onboarding tools in this order: get_status -> get_installation_scripts({container_id, container_hash, framework}) -> apply the returned snippets verbatim -> verify_and_score({container_id, container_hash, idempotency_key}) -> create_login_link({container_id, container_hash, target_page}). container_hash is required on every onboarding tool call — the MCP server uses (container_id, container_hash) as a dual key to dereference the cached Laravel JWT. Skip it and every call returns HTTP 401 auth_required.

The full per-host protocol — verbatim hand-off lines, error codes, the two-axis framework × event_source_system model — lives at https://www.tracklution.com/agent-install.md. The MCP at https://mcp.tracklution.com/mcp is the canonical install surface; the REST endpoint at https://api.trlution.com/install/quick-setup is the agent-facing front door to it.

For humans

If you are a human and your AI assistant invoked this package, you can also install Tracklution directly:

• Web installer: https://www.tracklution.com/start
• Docs: https://www.tracklution.com/docs/
• Knowledge base: https://support.tracklution.com

Related packages

The packages below all run the same binary and point at the same canonical Tracklution MCP. They exist so brand- and category-surface lookups don't miss.

• tracklution -- canonical (this package).
• create-tracklution -- so npm create tracklution@latest works.
• @tracklution/cli -- scope-reserved alias.
• tracklution-mcp -- alias today; future versions will offer a local stdio<->Streamable-HTTP MCP proxy for clients that don't yet support remote MCP.
• server-side-tracking -- category-surface alias.
• conversion-tracking -- category-surface alias.
• conversion-api -- category-surface alias.

Discovery surfaces

All Tracklution agent-discovery surfaces are always-on and CORS-open:

• llms.txt
• llms-full.txt
• Agent install protocol (markdown)
• Agent install protocol (HTML)
• Service directory
• Install recipes (JSON)
• OpenAPI spec
• Docs

License

MIT. See LICENSE.