Open Standard — Draft v0.2

One manifest.
Every protocol.

Agent Web Protocol defines agent.json — a single machine-readable file at the root of any website that tells agents what it does, how to authenticate, and — new in v0.2 — which agent protocols it speaks (MCP, A2A, AP2, x402, and more).

What robots.txt did for crawlers, agent.json does for agents. One URL, every capability, no guessing.

Get StartedRead the SpecLive example → LaClawClawView on GitHub
/.well-known/agent.json
{
  "awp_version": "0.2",
  "domain": "example.com",
  "intent": "Online store with search and checkout",
  "actions": [
    { "id": "search", "method": "GET", "endpoint": "/api/search" },
    { "id": "purchase", "method": "POST", "endpoint": "/api/purchase" }
  ]
}
The Pattern

A familiar evolution

Every era of the web introduced a simple, declarative file that unlocked a new layer of machine interaction. AWP continues this pattern for the age of AI agents.

1994
robots.txt
Told crawlers where they could go
2011
schema.org
Told search engines what things meant
2026
agent.json
Tells AI agents what they can do
Why AWP

What the protocol defines

New in v0.2

Speaks every agent protocol

Declare every sibling agent standard — A2A, MCP, ACP, AP2, x402, Skyfire — in one manifest. AWP is the front door; the protocols block tells agents every room they can enter.

Discovery

Well-known endpoint

Agents discover capabilities via /.well-known/agent.json — no scraping, no guessing, no prompt injection.

Capabilities

Structured actions

Declare what actions are available — search, book, purchase, submit — with typed parameters and descriptions. Route actions through any declared protocol via the new `via` field.

Auth

Secure by default

OAuth 2.0, API keys, bearer tokens, and session-based auth with explicit scope declarations per action.

Schema

Machine-readable

JSON schema-based format easy for agents to parse and humans to write. Validates against agent-json@0.2.1, zero external deps.

Tooling

npx agent-json

Generate with `npx agent-json init`, validate local files or remote URLs with `npx agent-json validate <file-or-url>`. Claude Code support via the AWP MCP server.

Open

Community-driven

MIT-licensed, open-source specification. Spec, validator, reference implementation — all developed in public on github.com/agentwebprotocol.

In the wild

See AWP v0.2 running.

LaClawClaw is the first live commerce deployment of AWP v0.2 — an agent-only Shopify store declaring MCP, A2A, and Stripe payment in a single manifest. Fetch it, validate it, shop it.

$ npx -y agent-json@latest validate https://laclawclaw.com/.well-known/agent.json
Validating: https://laclawclaw.com/.well-known/agent.json
  ✓ Valid agent.json — no issues found.
View the live manifest →How it works

The agentic web starts with a file.

Add agent.json to your site and let AI agents understand what you offer.

Generate yours nowRead the Specification