AXAG Standard — Agent Experience Accessibility Guidelines

How It Works

One annotation → one manifest → one tool → deterministic agent action. Click any stage to explore.

🏷️

HTML + AXAG

Annotate

📋

Semantic Manifest

Generate

🔧

MCP Tool

Map

🤖

Agent Runtime

Execute

Try It Live

Edit the HTML below — watch the Semantic Manifest and MCP Tool generate in real time.

index.html8 attributes detected

<button
  axag-intent="product.search"
  axag-entity="product"
  axag-action-type="read"
  axag-required-parameters='["query"]'
  axag-optional-parameters='["category","price_min","price_max"]'
  axag-risk-level="none"
  axag-idempotent="true"
  axag-description="Search the product catalogue"
>
  Search Products
</button>

generates

{
  "intent": "product.search",
  "entity": "product",
  "action_type": "read",
  "operation_id": "product_search",
  "description": "Search the product catalogue",
  "required_parameters": [
    {
      "name": "query",
      "type": "string"
    }
  ],
  "optional_parameters": [
    {
      "name": "category",
      "type": "string"
    },
    {
      "name": "price_min",
      "type": "string"
    },
    {
      "name": "price_max",
      "type": "string"
    }
  ],
  "risk_level": "none",
  "idempotent": true
}

💡 Try changing axag-action-type to "write" and adding axag-risk-level="high" — watch the safety metadata appear.

The Agent's Perspective

Toggle between what a scraper sees and what an AXAG-powered agent understands.

🕷️ Scraper View✨ AXAG View

🛍️ ShopDemo

Products Cart Account

📦

Wireless Headphones

$79.99

Hover over each button to see what the scraper targets.

📄

Documentation Pages

🏭

Industry Domains

✅

Validated Examples

🔍

Lint Rules

🏷️

Specification Attributes

📦

SDK Packages

Why AXAG?

A complete framework for making human interfaces agent-accessible.

📝

Semantic Contract

Every annotated element carries machine-readable intent, constraints, safety rules, and execution semantics.

⚡

One Attribute

axag="write:user.deactivate!critical?approval" says in one attribute what used to take five. Convert either way with axag fmt.

📋

Parameters From Your Forms

Names, types, constraints and labels are read from the form you already have — or from a Zod schema or OpenAPI operation.

🔧

Built Into Your App

A Vite or webpack plugin emits the manifest and WebMCP tools on every build; React, Vue and Angular bindings register them.

🛡️

Enforced, Not Just Declared

Confirmation, approval and tenant boundaries are checked in the page and again on the server, where an agent can't skip them.

🏆

Standards-Grade

A versioned spec, conformance levels, 37 lint rules with SARIF and baselines, and a governance model for enterprise adoption.

Install the SDK

Thirteen packages under the @web-axag scope, plus the axag and axag-lint commands. Take only the ones you need.

Check your annotationsnpx axag-lint src

No install needed — 37 rules over HTML, JSX, TSX and Vue.

Generate the manifest and toolsnpm install -D @web-axag/compiler

A Vite, webpack, Rollup, Rspack or esbuild plugin that runs on every build.

Plus @web-axag/react, /vue or /angular to register from components.

Enforce it on your servernpm install @web-axag/server

Confirmation tokens, approvals, roles and tenant boundaries an agent cannot skip.

Which package does what →

Domain-Agnostic

Works Across Every Domain

AXAG semantic contracts look the same whether you're building e-commerce, analytics, or enterprise admin. Explore 8 industries.

🛒

E-Commerce

Annotation

axag-intent="product.search"
axag-entity="product"
axag-action-type="read"

Generated Tool

product_search(query, category?)

📊

Analytics

Annotation

axag-intent="report.generate"
axag-entity="report"
axag-action-type="read"
axag-async="true"

Generated Tool

report_generate(date_range, metrics)

💼

Sales & CRM

Annotation

axag-intent="lead.create"
axag-entity="lead"
axag-action-type="write"
axag-risk-level="low"

Generated Tool

lead_create(name, email, company?)

✈️

Travel

Annotation

axag-intent="flight.search"
axag-entity="flight"
axag-action-type="read"

Generated Tool

flight_search(origin, dest, date)

📣

Marketing

Annotation

axag-intent="campaign.create"
axag-entity="campaign"
axag-action-type="write"
axag-risk-level="medium"

Generated Tool

campaign_create(name, audience, budget)

🎫

Support

Annotation

axag-intent="ticket.create"
axag-entity="ticket"
axag-action-type="write"

Generated Tool

ticket_create(subject, description)

🏢

Enterprise

Annotation

axag-intent="user.deactivate"
axag-entity="user"
axag-action-type="write"
axag-risk-level="critical"
axag-approval-required="true"

Generated Tool

user_deactivate(user_id) [approval]

💼

Jobs

Annotation

axag-intent="job.search"
axag-entity="job"
axag-action-type="read"

Generated Tool

job_search(keywords, location?)

🛒

E-Commerce

Annotation

axag-intent="product.search"
axag-entity="product"
axag-action-type="read"

Generated Tool

product_search(query, category?)

📊

Analytics

Annotation

axag-intent="report.generate"
axag-entity="report"
axag-action-type="read"
axag-async="true"

Generated Tool

report_generate(date_range, metrics)

💼

Sales & CRM

Annotation

axag-intent="lead.create"
axag-entity="lead"
axag-action-type="write"
axag-risk-level="low"

Generated Tool

lead_create(name, email, company?)

✈️

Travel

Annotation

axag-intent="flight.search"
axag-entity="flight"
axag-action-type="read"

Generated Tool

flight_search(origin, dest, date)

📣

Marketing

Annotation

axag-intent="campaign.create"
axag-entity="campaign"
axag-action-type="write"
axag-risk-level="medium"

Generated Tool

campaign_create(name, audience, budget)

🎫

Support

Annotation

axag-intent="ticket.create"
axag-entity="ticket"
axag-action-type="write"

Generated Tool

ticket_create(subject, description)

🏢

Enterprise

Annotation

axag-intent="user.deactivate"
axag-entity="user"
axag-action-type="write"
axag-risk-level="critical"
axag-approval-required="true"

Generated Tool

user_deactivate(user_id) [approval]

💼

Jobs

Annotation

axag-intent="job.search"
axag-entity="job"
axag-action-type="read"

Generated Tool

job_search(keywords, location?)

Dive Deeper

📖

Tutorials

Step-by-step guides from first annotation to agent action.

→🏭

Use Cases

E-commerce, CRM, marketing, travel — AXAG across industries.

→⚠️

Anti-Patterns

Common mistakes that break agent interaction and how to fix them.

→📦

The SDK

Compiler, WebMCP runtime, React, Vue and Angular bindings, server enforcement and a linter.

→

Ready to make your UI agent-accessible?

Start with a single annotation. Let your build turn it into tools an agent can use.

Add Your First Annotation ⚡ Install the SDK 📦 Explore the SDK ⭐ Star on GitHub