Make any website agent-ready
agent.json is a machine-readable manifest that tells AI agents what your service does, how to authenticate, and what actions are available — in a single file at your domain root.
Like robots.txt told crawlers where to go, agent.json tells agents what to do.
Quick start
Place an agent.json file at your domain root. That's it. Any AWP-compatible agent can discover your service and understand how to interact with it.
Describe your service
Set your domain, intent, and capabilities.
Define your actions
List API endpoints agents can call, with parameters and return types.
Serve at yourdomain.com/agent.json
Agents discover it automatically. No registration needed.
{
"awp_version": "0.1",
"domain": "example.com",
"intent": "Example service — search and retrieve items. Agents can help users find what they need.",
"capabilities": {
"streaming": false,
"pagination": "cursor",
"idempotency": true
},
"auth": {
"required_for": ["create_item"],
"optional_for": ["search"],
"type": "api_key"
},
"actions": [
{
"id": "search",
"description": "Search for items by keyword",
"auth_required": false,
"inputs": {
"query": { "type": "string", "required": true }
},
"outputs": {
"items": "array[item]",
"total": "integer"
},
"endpoint": "/api/search",
"method": "POST",
"rate_limit": "60/minute",
"execution_model": "sync"
}
],
"agent_status": {
"operational": true,
"status_endpoint": "/api/status"
}
}Discovery
Agents fetch /agent.json from any domain — no registry, no middleman. Decentralized by design.
Self-describing
Natural-language intent plus structured schemas. Agents understand both what you do and how to do it.
Auth-aware
Declare your auth method once. OAuth 2.0, API keys, bearer tokens — agents know what to bring.
Action-oriented
Every endpoint is an action with typed parameters. Agents can plan and execute multi-step workflows.
Error contracts
Domain-specific error codes with retry hints. Agents handle failures gracefully.
Status signals
Active, beta, maintenance, deprecated — agents adapt their behavior to your service state.