index-ai / Specification

index-ai — An Open Specification Proposal for Agent-Readable Web Content

The normative text of the specification, versioned and navigable. This site documents version 1.0-rc2 — check the changelog for the latest published version.

Version: 1.0-rc2
Status: REQUEST FOR COMMENTS
License: MIT · CC-BY-4.0
Reference impl: @hardmachinelabs/index-ai-validator

Conformance levels

The standard is organized in three progressive levels. Level 2a and 2b share the same file; 2b extends 2a with optional relation fields. The full normative text lives in the canonical specification — these cards link to the exact sections.

AI ManifestIdentity, publisher, freshness, policy — one HTTP call answers: “What is this site?”/.well-known/index-ai.json (or scoped, §5.2)Agent IndexA flat list of content nodes — each with a clean-text endpoint and an exact measured size./agent-index.json Agent GraphTyped relationships between nodes — from “hotels” to “hotels-casablanca-luxury”, without parsing HTML./agent-index.json + relations Query InterfaceA typed API over the Agent View — the agent sends a query with filters and receives exactly the data requested.MCP server

Read the specification

Open SPEC-v1.0-rc2

Terminology · discovery · token economics · conformance · security · privacy · compatibility · governance — the canonical text, versioned.