{
  "entries": [
    {
      "identifier": "urn:air:agentexperience.tech:mcp:content",
      "displayName": "Agent Experience content MCP server",
      "type": "application/json",
      "url": "https://agentexperience.tech/api/mcp",
      "description": "Public, read-only MCP server over this site's own published content: keyword search across the guides, the full Markdown of any one of them, the machine-readable agent-readiness rubric, and the AX glossary. Streamable HTTP transport, stateless, POST only, no authentication.",
      "tags": [
        "mcp",
        "mcp-server",
        "documentation",
        "search",
        "glossary"
      ],
      "capabilities": [
        "search_guides",
        "get_guide",
        "get_readiness_rubric",
        "get_glossary_term"
      ],
      "metadata": {
        "transport": "streamable-http",
        "protocolVersion": "2026-07-28",
        "authentication": "none"
      },
      "representativeQueries": [
        "search the Agent Experience guides for how to write tool descriptions",
        "read the Agent Experience guide on agent-readiness scoring",
        "what does AX mean in the Agent Experience glossary",
        "get the Open Agent-Readiness Rubric as JSON"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:index",
      "displayName": "Agent Experience documentation index",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/llms.txt",
      "description": "Curated Markdown index of every Agent Experience guide, the field map, the glossary, and the machine-readable readiness rubric.",
      "tags": [
        "documentation",
        "index",
        "llms-txt"
      ],
      "representativeQueries": [
        "where is the Agent Experience documentation index",
        "show me the llms.txt for agentexperience.tech",
        "what guides does Agent Experience publish"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:full",
      "displayName": "Agent Experience guides, full text",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/llms-full.txt",
      "description": "One Markdown file containing the full text of all 21 Agent Experience guides, for agents that want to read rather than crawl.",
      "tags": [
        "documentation",
        "llms-txt",
        "full-text"
      ],
      "representativeQueries": [
        "give me the full text of every Agent Experience guide",
        "download all Agent Experience guides as one file"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:feed:rss",
      "displayName": "Agent Experience RSS feed",
      "type": "application/rss+xml",
      "url": "https://agentexperience.tech/rss.xml",
      "description": "New and updated Agent Experience guides, as an RSS feed.",
      "tags": [
        "feed",
        "rss",
        "updates"
      ],
      "representativeQueries": [
        "is there an RSS feed for Agent Experience",
        "how do I get notified when Agent Experience publishes a new guide"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:what-is-agent-experience",
      "displayName": "What is Agent Experience?",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/what-is-agent-experience/index.md",
      "description": "A practical definition of Agent Experience (AX): how to make products, documentation, tools, and workflows easier for AI agents to discover, understand, use, recover through, and act within.",
      "tags": [
        "agent experience",
        "foundations",
        "definition",
        "workflows"
      ],
      "representativeQueries": [
        "What is Agent Experience?",
        "What makes a product agent-friendly?",
        "How should a team start improving Agent Experience?",
        "Is Agent Experience the same as UX, DX, or GEO?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agent-experience-framework",
      "displayName": "An Agent Experience (AX) framework",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agent-experience-framework/index.md",
      "description": "A named, practical framework for Agent Experience work with AI agents: a five-part field map (orient, discover, act, collaborate, learn), a four-step method for applying it, and a rubric for taking inventory of what a product has declared.",
      "tags": [
        "agent experience",
        "foundations",
        "framework",
        "method",
        "evaluation"
      ],
      "representativeQueries": [
        "What is the AX framework?",
        "Is this the Ax framework on GitHub?",
        "How is an AX framework different from an agent framework?",
        "Where should a team start with the framework?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:tool-descriptions",
      "displayName": "Tool descriptions are product surfaces",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/tool-descriptions/index.md",
      "description": "How to write tool names, descriptions, and JSON schemas that help an AI agent choose correctly, and why tool text deserves review like any other interface copy.",
      "tags": [
        "tools",
        "documentation",
        "tool selection",
        "json schema"
      ],
      "representativeQueries": [
        "What makes a good tool description for an AI agent?",
        "How long should a tool description be?",
        "Do tool annotations like readOnlyHint keep an agent safe?",
        "Should tool descriptions be versioned and tested?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:make-documentation-legible",
      "displayName": "Make documentation legible to agents",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/make-documentation-legible/index.md",
      "description": "Practical guidance for making product documentation, tool instructions, and workflows easier for AI agents to understand and use.",
      "tags": [
        "documentation",
        "discovery",
        "tools"
      ],
      "representativeQueries": [
        "Make documentation legible to agents",
        "Good agent-facing documentation makes intent, constraints, and recovery paths easier to use."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agent-friendly-websites",
      "displayName": "Build websites agents can understand",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agent-friendly-websites/index.md",
      "description": "A practical guide to building an agent-friendly website: semantic structure, stable journeys, crawler policy, and the content AI agents need to finish a task.",
      "tags": [
        "discovery",
        "websites",
        "accessibility",
        "semantic html",
        "crawlers"
      ],
      "representativeQueries": [
        "What makes a website agent-friendly?",
        "Do I need an llms.txt file for AI agents to use my site?",
        "Should I block AI crawlers in robots.txt?",
        "Is building for agents different from accessibility work?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:ax-vs-ux-dx-geo",
      "displayName": "AX, UX, DX, and GEO: where each fits",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/ax-vs-ux-dx-geo/index.md",
      "description": "AX vs UX vs DX vs GEO, compared side by side: who the user is, what the interface is, how feedback arrives, and what success looks like in each discipline—plus the two competing meanings of Agent Experience.",
      "tags": [
        "foundations",
        "discovery",
        "definition",
        "ax vs ux",
        "agent experience design"
      ],
      "representativeQueries": [
        "What is the difference between Agent Experience and User Experience?",
        "How does Agent Experience relate to Developer Experience?",
        "Is GEO the same as Agent Experience?",
        "Is AX replacing UX?",
        "Does 'agent experience' mean AI agents or contact-centre agents?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agent-readiness-rubric",
      "displayName": "The Open Agent-Readiness Rubric",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agent-readiness-rubric/index.md",
      "description": "A vendor-neutral, versioned checklist and weighted scoring model for how ready a website or product is for AI agents, across discovery, structure, machine-readable content, action safety, recovery, and policy signals.",
      "tags": [
        "agent readiness",
        "evaluation",
        "discovery",
        "standards",
        "checklist"
      ],
      "representativeQueries": [
        "What is agent readiness?",
        "How is this rubric different from an agent-readiness score from a vendor?",
        "Does a high readiness score mean agents will succeed on my site?",
        "How often should the rubric be re-run?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:state-of-llms-txt",
      "displayName": "Does llms.txt actually work?",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/state-of-llms-txt/index.md",
      "description": "A sceptical review of the public evidence on llms.txt as of September 2026: what adoption studies actually measured, which bots fetch the file, what Google and Chrome each say, and whether you should ship one.",
      "tags": [
        "discovery",
        "standards",
        "evidence",
        "llms.txt",
        "geo"
      ],
      "representativeQueries": [
        "Does llms.txt improve AI search visibility?",
        "Do AI crawlers read llms.txt?",
        "Why does Chrome's Lighthouse check for llms.txt if Google Search ignores it?",
        "Should I still publish an llms.txt file?",
        "What is the difference between llms.txt and llms-full.txt?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agent-web-standards",
      "displayName": "The state of agent-web standards",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agent-web-standards/index.md",
      "description": "A maintained, vendor-neutral comparison of the files and protocols that claim to make a website legible to AI agents — what each one is, who is behind it, who actually reads it, and what we recommend.",
      "tags": [
        "standards",
        "discovery",
        "llms.txt",
        "mcp",
        "comparison"
      ],
      "representativeQueries": [
        "Does llms.txt actually work?",
        "Which agent-web standards are worth adopting in 2026?",
        "Is agents.txt a real standard?",
        "How is this page maintained?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agentic-resource-discovery",
      "displayName": "Agentic Resource Discovery, implemented",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agentic-resource-discovery/index.md",
      "description": "How the Agentic Resource Discovery specification works, why ai-catalog.json has been superseded by /.well-known/ard.json, and a worked example for publishing a manifest on a docs or content site.",
      "tags": [
        "discovery",
        "standards",
        "ard",
        "well-known",
        "mcp"
      ],
      "representativeQueries": [
        "What is Agentic Resource Discovery?",
        "Is the file called ai-catalog.json or ard.json?",
        "Does ARD replace llms.txt, AGENTS.md or MCP?",
        "Is anyone actually reading ARD manifests yet?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:agent-tool-catalogs",
      "displayName": "An agent’s tool catalog needs a pruning strategy",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/agent-tool-catalogs/index.md",
      "description": "Why a smaller, clearer tool catalog can make agent-facing workflows easier to select, understand, and operate.",
      "tags": [
        "tools",
        "tool selection",
        "workflows"
      ],
      "representativeQueries": [
        "An agent’s tool catalog needs a pruning strategy",
        "A smaller, clearer set of capabilities can be more useful than a long list of overlapping actions."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:start-with-workflows",
      "displayName": "Start with workflows, not autonomy",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/start-with-workflows/index.md",
      "description": "A practical way to decide where agentic behavior belongs in a product workflow.",
      "tags": [
        "workflows",
        "strategy",
        "autonomy"
      ],
      "representativeQueries": [
        "Start with workflows, not autonomy",
        "A bounded workflow is often the fastest way to learn where agentic behavior genuinely helps."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:evaluating-agent-workflows",
      "displayName": "Evaluate decisions, not just answers",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/evaluating-agent-workflows/index.md",
      "description": "Why evaluating an AI agent workflow means scoring the decisions along the path — tool selection, input formation, stopping, and recovery — not only the final answer.",
      "tags": [
        "evaluation",
        "workflows",
        "tool selection",
        "reliability"
      ],
      "representativeQueries": [
        "Why is final-answer accuracy not enough for agent evaluation?",
        "What should we measure in an agent workflow?",
        "What is pass^k and why does it matter?",
        "Can we compare our agent's score to a public benchmark number?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:measure-agent-experience",
      "displayName": "How do you measure agent experience?",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/measure-agent-experience/index.md",
      "description": "A practical guide to measuring Agent Experience: what construct you are actually measuring, the four families of AX measurement, the instrumentation a workflow needs before any number means anything, and the claims a measurement cannot support.",
      "tags": [
        "evaluation",
        "measurement",
        "instrumentation",
        "reliability",
        "workflows"
      ],
      "representativeQueries": [
        "How do you measure agent experience?",
        "What is the difference between an agent-readiness score and an agent-experience measurement?",
        "What should we instrument before we start measuring?",
        "Can we compare our agent's numbers to a public benchmark?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:run-an-ax-review",
      "displayName": "Run an Agent Experience review",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/run-an-ax-review/index.md",
      "description": "A step-by-step method for running an Agent Experience review: pick one workflow, map its surfaces, watch the decision points, and turn patterns into product changes.",
      "tags": [
        "evaluation",
        "review",
        "workflows",
        "decision points"
      ],
      "representativeQueries": [
        "How long does an Agent Experience review take?",
        "Who should run an AX review?",
        "What is the difference between an AX review and an eval suite?",
        "How do we know the review worked?"
      ],
      "updatedAt": "2026-09-02T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:approval-is-a-workflow",
      "displayName": "Human approval is a workflow, not a pop-up",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/approval-is-a-workflow/index.md",
      "description": "How to design meaningful human-in-the-loop approvals for AI agents: name the action and its consequence, offer more than allow or deny, and keep the task resumable.",
      "tags": [
        "delegated action",
        "workflows",
        "recovery",
        "permissions"
      ],
      "representativeQueries": [
        "When should an AI agent ask a human for approval?",
        "Why is a confirmation dialog not a real approval?",
        "Do tool safety annotations make an approval unnecessary?",
        "How do we keep an approval from blocking the whole workflow?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:design-for-recovery",
      "displayName": "Design for recovery, not perfect runs",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/design-for-recovery/index.md",
      "description": "How recovery paths, uncertainty, and clear handoffs improve agent-facing product workflows.",
      "tags": [
        "recovery",
        "reliability",
        "workflows"
      ],
      "representativeQueries": [
        "Design for recovery, not perfect runs",
        "A helpful system knows when to stop, explain what happened, and make the next safe step clear."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:show-the-next-decision",
      "displayName": "A good agent dashboard shows the next decision",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/show-the-next-decision/index.md",
      "description": "How to design agent-facing dashboards around decisions, status, and meaningful next steps.",
      "tags": [
        "interfaces",
        "delegated action",
        "reliability"
      ],
      "representativeQueries": [
        "A good agent dashboard shows the next decision",
        "Operational surfaces earn their place when they explain what needs attention, why, and what to do next."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:preserve-context-through-handoffs",
      "displayName": "Every handoff should preserve the reason for the work",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/preserve-context-through-handoffs/index.md",
      "description": "Why agent workflows need durable context at every handoff, review, and recovery point.",
      "tags": [
        "workflows",
        "delegated action",
        "recovery"
      ],
      "representativeQueries": [
        "Every handoff should preserve the reason for the work",
        "A handoff should carry the task, the decision, and the exact question that needs resolution."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:retries-are-product-history",
      "displayName": "Retries are product history, not a clean slate",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/retries-are-product-history/index.md",
      "description": "Why hiding an AI agent's retry history creates false confidence, and how to record attempts so a team can tell recovery from clean success.",
      "tags": [
        "reliability",
        "recovery",
        "evaluation",
        "observability"
      ],
      "representativeQueries": [
        "Should an AI agent's retries be shown to users?",
        "How many retries are too many?",
        "What is the difference between a retry and a recovery?",
        "How should retries be measured?"
      ],
      "updatedAt": "2026-09-01T06:30:00.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:build-a-reliable-agent-evaluation-loop",
      "displayName": "Build an evaluation loop that improves the product",
      "type": "text/markdown",
      "url": "https://agentexperience.tech/insights/build-a-reliable-agent-evaluation-loop/index.md",
      "description": "A practical framework for using agent workflow evaluation to drive meaningful product improvements.",
      "tags": [
        "evaluation",
        "reliability",
        "workflows"
      ],
      "representativeQueries": [
        "Build an evaluation loop that improves the product",
        "Use recurring workflow failures to guide durable product improvements instead of collecting a decorative score."
      ],
      "updatedAt": "2026-08-25T20:02:14.000Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:data:agent-readiness-rubric",
      "displayName": "The Open Agent-Readiness Rubric, machine-readable",
      "type": "application/json",
      "url": "https://agentexperience.tech/agent-readiness-rubric.json",
      "description": "The Open Agent-Readiness Rubric's criteria, checks and weights as JSON, kept in step with the prose guide it twins.",
      "tags": [
        "rubric",
        "evaluation",
        "json"
      ],
      "representativeQueries": [
        "score a site against the agent readiness rubric",
        "get the agent readiness rubric as JSON",
        "what criteria does the Open Agent-Readiness Rubric check"
      ],
      "updatedAt": "2026-09-01T00:00:00Z"
    },
    {
      "identifier": "urn:air:agentexperience.tech:docs:glossary",
      "displayName": "Agent Experience (AX) glossary",
      "type": "text/html",
      "url": "https://agentexperience.tech/glossary/",
      "description": "Forty-three Agent Experience terms defined, with origins and dates where a term has one.",
      "tags": [
        "documentation",
        "glossary",
        "reference"
      ],
      "representativeQueries": [
        "define Agent Experience terms",
        "what does AX mean",
        "is there a glossary for agent-facing product terms"
      ],
      "updatedAt": "2026-09-01T00:00:00Z"
    }
  ]
}