AXAG Standard — Agent Context Annotation 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

{
  "$schema": "https://axag.dev/schema/v1/manifest.json",
  "intent": "product.search",
  "entity": "product",
  "action_type": "read",
  "description": "Search the product catalogue",
  "parameters": {
    "required": [
      "query"
    ],
    "optional": [
      "category",
      "price_min",
      "price_max"
    ]
  },
  "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

🎯

Conformance Levels

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.

📋

Semantic Manifest

Annotations compile into a structured manifest exposing discoverable operations, parameters, and safety boundaries.

🔧

MCP Tool Generation

Manifests map directly to MCP-compatible tool definitions that agent runtimes consume deterministically.

🚫

Scraping Replacement

Eliminates brittle DOM scraping, CSS selector maintenance, and label inference. Agents read contracts, not layouts.

🛡️

Safety & Governance

Risk classification, confirmation gates, approval requirements, and tenant boundaries as first-class dimensions.

🏆

Standards-Grade

Conformance levels, versioned spec, 26 validation rules, CI linting, and a governance model for enterprise adoption.

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.

→🔄

Before & After

See scraping-based approaches vs AXAG semantic contracts side by side.

→

Ready to make your UI agent-accessible?

Start with a single annotation. Build to a full semantic contract.

Add Your First Annotation ⭐ Star on GitHub