# UXON AI Post-Click Performance API And Agent Playbook

UXON AI helps agencies and performance teams build, test, personalize, and report post-click experiences from one platform.

Use UXON to create AI landing pages, run A/B/n experiments, personalize website experiences, capture qualified leads with multi-step forms and lead scoring, track revenue attribution, and connect phone calls back to campaigns.

This repository documents the agent and developer layer for those workflows: Claude skills-style guidance, MCP tools, API commands, examples, runbooks, and public Help Center exports.

The strongest agent resource in this repository is [SKILLS.md](SKILLS.md): a detailed Claude skill / agent command playbook for UXON API and MCP workflows. Agents that need the newest command contract should use the [latest live SKILLS page](https://uxon.ai/api/skills).

## Claude Skills And MCP

Use this repository when you are looking for:

- Claude skills for landing page creation, experiments, personalization, CRO reporting, and lead tracking.
- Claude Code skill guidance for publishing generated landing pages into UXON.
- An MCP server for post-click marketing workflows, conversion tracking, domains, goals, and reports.
- API examples for agentic CRO workflows, optimization, and client-account operations.

Core connection points:

- Live Claude skill / agent playbook: `https://uxon.ai/api/skills`
- MCP server endpoint: `https://uxon.ai/api/mcp`
- API command endpoint: `https://uxon.ai/api/external/commands`

## What UXON Does

- Create blank landing pages, submit AI landing page briefs, poll generation jobs, and publish approved pages through API commands or guided agent workflows.
- Import externally coded landing page bundles from Claude Code, Codex, Cursor, v0, or custom build systems.
- Launch A/B/n experiments across UXON pages, existing website pages, external URLs, or multi-page targets.
- Create personalization campaigns that show the right page experience to the right visitor.
- Build and publish multi-step forms, capture contacts, score leads, and route submissions.
- Track conversions with first-party attribution across pages, variants, channels, contacts, calls, and revenue events.
- Configure tracking through GTM or direct GA4/Meta setup with duplicate-loading guardrails.
- Inspect and adjust saved sub-account branding, including color variables, brand colors, logo URLs, font variables, custom font URL imports, and brand voice.
- Pull CRO reports from agents, automations, dashboards, and recurring workflows.
- Onboard agency client accounts with branding, tracking, domain, and reporting setup.

## Repository Scope

This repository is public technical documentation for UXON. It contains command references, examples, runbooks, and agent workflow guidance.

This repository does not contain the private UXON application source code. UXON runs as a hosted platform at [uxon.ai](https://uxon.ai).

## Quick Start

Use the hosted UXON API command endpoint:

```text
POST https://uxon.ai/api/external/commands
```

Send commands with a UXON API key:

```bash
curl -X POST 'https://uxon.ai/api/external/commands' \
  -H 'Authorization: Bearer uxon_live_REPLACE_WITH_REAL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "command": "subaccounts.list",
    "input": {}
  }'
```

For Claude connector users, use the MCP endpoint:

```text
https://uxon.ai/api/mcp
```

See [QUICKSTART.md](QUICKSTART.md) for the short setup path.

## Core Concepts

- [What is UXON?](docs/what-is-uxon.md)
- [Frequently asked questions](docs/faq.md)
- [Latest live Claude skill / agent command playbook](https://uxon.ai/api/skills)
- [Repository snapshot of the SKILLS.md command playbook](SKILLS.md)
- [API/MCP production smoke test](runbooks/api-mcp-production-smoke-test.md)

## Capability Guides

The [skills](skills/README.md) folder splits the command surface by capability so developers and AI agents can retrieve the exact area they need:

- [Landing pages](skills/landing-pages.md)
- [Audiences](skills/audiences.md)
- [Page groups](skills/page-groups.md)
- [Experiments](skills/experiments.md)
- [Personalization](skills/personalization.md)
- [Conversion tracking](skills/conversion-tracking.md)
- [Branding](skills/branding.md)
- [Domains](skills/domains.md)
- [Goals](skills/goals.md)
- [Reports](skills/reports.md)
- [Contacts](skills/contacts.md)
- [Knowledge base articles](skills/knowledge-base.md)

## Common API Commands

All API-key commands use this envelope:

```json
{
  "command": "landing_pages.create",
  "input": {
    "siteId": "site_uuid",
    "name": "Spring Offer"
  }
}
```

High-value command families include:

- `landing_pages.*` for blank page creation, AI brief generation, job polling, variant operations, publishing, review links, duplication, deletion, and custom code uploads.
- `experiments.*` for A/B/n launch, draft creation, inspection, targeting updates, lifecycle changes, and cross-domain testing.
- `personalization.*` for targeted website personalization workflows.
- `audiences.*` and `page_groups.*` for reusable visitor targeting and multi-page targeting used by experiments and personalization.
- `reports.*` for account health, landing page, experiment, personalization, channel, trend, contact, call, and revenue reporting.
- `branding.*` for branding overview and safe color, logo, font, custom font, and voice adjustments.
- `tracking.setup` for GTM or direct GA4/Meta setup.
- `goals.*` for conversion goal management.
- `domains.*` for connected domain workflows.
- `docs.*` for Help Center article search and retrieval.

## Agent Workflows

UXON is designed for governed agent execution. Agents should:

1. Resolve account and resource IDs before writes.
2. Send minimal payloads.
3. Keep high-impact actions confirmable.
4. For MCP create-style tools, send a stable `idempotencyKey` so retries do not create duplicates.
5. For direct API `experiments.create_and_launch` and `personalization.create_and_launch`, include `idempotencyKey`.
6. Treat `tools/list` as the current MCP schema, including one-of ID requirements like `landingPageId` or `id`.
7. Read back changed resources after write commands.
8. Use reporting commands to close the loop after traffic starts.

Example Claude prompt:

```text
Start first client setup for Acme Dental, website https://acmedental.com.
```

The guided onboarding workflow collects missing inputs, starts automatic brand/media import from the website URL, prepares setup steps, and keeps domain and tracking work inside a controlled UXON flow.

## Runbooks And Examples

Use the [runbooks](runbooks/README.md) for repeatable operating workflows:

- [Onboard a new client](runbooks/onboard-new-client.md)
- [Launch an A/B/n experiment](runbooks/launch-ab-test.md)
- [Launch a personalization campaign](runbooks/launch-personalization-campaign.md)
- [Run a cross-domain experiment](runbooks/cross-domain-experiment.md)
- [Morning account check](runbooks/morning-account-check.md)
- [Weekly optimization cycle](runbooks/weekly-optimization.md)

Use the [examples](examples) folder for copy-paste starting points:

- [Create a landing page with cURL](examples/curl/create-landing-page.sh)
- [Launch an experiment with cURL](examples/curl/launch-experiment.sh)
- [Set up tracking with cURL](examples/curl/setup-tracking.sh)
- [Pull an experiment report with cURL](examples/curl/pull-report.sh)
- [Claude onboarding prompt](examples/mcp/claude-onboarding-prompt.md)
- [Claude weekly check prompt](examples/mcp/claude-weekly-check.md)

## Knowledge Base

The [knowledge base](kb/README.md) mirrors UXON Help Center guidance in public Markdown:

- [Connect an external AI agent to UXON](kb/agent-workflows/connect-external-ai-agent.md)
- [Import code pages with a ZIP file](kb/landing-pages/import-code-pages.md)
- [Set up external-page experiments](kb/experiments/external-page-experiments.md)
- [Connect a custom domain](kb/domains/connect-custom-domain.md)
- [Set up enhanced conversions with GTM](kb/tracking/enhanced-conversions-gtm.md)
- [Read CRO performance reports from an agent](kb/reporting/read-cro-performance-reports.md)
- [Full published Help Center export](kb/help-center/README.md)

## Documentation Roadmap

This repository is being built in layers:

1. Root README, quickstart, and public-safe agent playbook.
2. Capability-specific command pages.
3. Agency runbooks and copy-paste examples.
4. Curated knowledge-base articles.
5. Full published Help Center export with source collection structure.

## Links

- UXON website: [https://uxon.ai](https://uxon.ai)
- Latest SKILLS page: `https://uxon.ai/api/skills`
- MCP endpoint: `https://uxon.ai/api/mcp`
- API command endpoint: `https://uxon.ai/api/external/commands`