Specification

.well-known/awi.json

Declare your source to the Agentic Web Index. Publishing awi.json improves your Openness & Accessibility score and helps agents discover and interact with your content correctly.

Schema

https://example.com/.well-known/awi.json

{
  "awi": {
    "version": "2026-02",
    "identity": {
      "name": "Your Service Name",
      "domain": "example.com",
      "operator": "Your Organization"
    },
    "content_categories": [
      "software.api_docs",
      "software.sdk_docs"
    ],
    "access": {
      "api": {
        "endpoint": "https://api.example.com",
        "auth": "api_key",
        "docs": "https://docs.example.com"
      }
    },
    "pricing": {
      "type": "freemium",
      "free_tier": "100 requests/day"
    },
    "provenance": {
      "type": "commercial",
      "operator_verified": true
    },
    "agent_policy": {
      "crawl_allowed": true,
      "rate_limit": "10/minute",
      "preferred_format": "json"
    }
  }
}

Fields

versionstringRequired. Schema version (currently '2026-02').

identity.namestringRequired. Human-readable name for your source.

identity.domainstringRequired. Primary domain.

identity.operatorstringOrganization operating the source.

content_categoriesstring[]AWI dot-notation categories (e.g., 'finance.macro').

access.api.endpointstringAPI base URL if applicable.

access.api.authstringAuthentication method: 'none', 'api_key', 'oauth2'.

pricing.typestringPricing model: 'free', 'freemium', 'paid', 'enterprise'.

provenance.typestringSource provenance: 'government', 'academic', 'commercial', etc.

agent_policy.crawl_allowedboolWhether automated crawling is permitted.

agent_policy.rate_limitstringRequested rate limit for agents.

Related files AWI detects

.well-known/awi.jsonAWI source declaration

agent-card.jsonGoogle A2A agent card

.well-known/webmcp.jsonGoogle WebMCP manifest

llms.txt / llms-full.txtMachine-readable site description for LLMs