{
 "name": "Agent Readiness Compare API",
 "version": "v1",
 "edition": "2026-11-04",
 "documentation": "https://agentreadinesscompare.com/developers/",
 "openapi": "https://agentreadinesscompare.com/openapi.json",
 "api_catalog": "https://agentreadinesscompare.com/.well-known/api-catalog",
 "auth": "none",
 "rate_limit": {
  "requests": 120,
  "window_seconds": 60
 },
 "versioning": {
  "current": "v1",
  "policy": "breaking changes ship under a new prefix; the old prefix stays for 180 days",
  "announcements": "https://agentreadinesscompare.com/developers/"
 },
 "endpoints": [
  {
   "path": "/api/v1/list_scanners",
   "method": "GET",
   "summary": "List the six scanners",
   "parameters": [],
   "example": {},
   "paginated": false
  },
  {
   "path": "/api/v1/get_domain_scores",
   "method": "GET",
   "summary": "One domain across the six scanners",
   "parameters": [
    "domain"
   ],
   "example": {
    "domain": "netlify.com"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/list_concordance",
   "method": "GET",
   "summary": "List and filter the Concordance",
   "parameters": [
    "category",
    "stratum",
    "scanner",
    "min_score",
    "max_score",
    "q",
    "limit",
    "cursor"
   ],
   "example": {
    "category": "Developer Tools",
    "scanner": "ora"
   },
   "paginated": true
  },
  {
   "path": "/api/v1/compare_scanners",
   "method": "GET",
   "summary": "Compare two scanners",
   "parameters": [
    "a",
    "b"
   ],
   "example": {
    "a": "ora",
    "b": "isitagentready"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/get_rubric",
   "method": "GET",
   "summary": "The scanner rubric with evidence",
   "parameters": [
    "scanner",
    "criterion",
    "rubric_edition"
   ],
   "example": {
    "criterion": "standards"
   },
   "paginated": false
  },
  {
   "path": "/ask",
   "method": "GET, POST",
   "summary": "NLWeb 0.55 ask",
   "example": {
    "query": "why scanners disagree"
   }
  }
 ],
 "datasets": [
  {
   "key": "concordance",
   "title": "Scanner Concordance",
   "description": "Sixty domains by six scanners: score, band, reason for an empty cell, fetch time, source URL and read date per cell, plus the spread per row.",
   "downloads": [
    {
     "url": "https://agentreadinesscompare.com/data/concordance-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentreadinesscompare.com/data/concordance-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "rubric",
   "title": "Scanner rubric, ten criteria (the rubric that ranks the scanners)",
   "description": "The ten criteria worth 100 points and, per scanner, the points on each part with its basis and source URL, the total and rank, the 5 November re-read log and the version 1.2 citation rule.",
   "downloads": [
    {
     "url": "https://agentreadinesscompare.com/data/scanner-rubric-2026-11-05.json",
     "type": "application/json"
    },
    {
     "url": "https://agentreadinesscompare.com/data/scanner-ranking-2026-11-05.csv",
     "type": "text/csv"
    },
    {
     "url": "https://agentreadinesscompare.com/data/scanner-rubric-cells-2026-11-05.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "rubric_superseded",
   "title": "Scanner rubric, seven criteria of 4 November (superseded)",
   "description": "Superseded for the ranking by the ten-criterion rubric. The seven criteria and, per scanner, the score or result, the evidence, the source URL and the read date, with a total of 25 and rank.",
   "downloads": [
    {
     "url": "https://agentreadinesscompare.com/data/rubric-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentreadinesscompare.com/data/rubric-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "standards",
   "title": "Standards Map",
   "description": "The 16 standards: maintainer, layer, what each is and does not do, the scanners that check it, the AgentReady identifiers and the source.",
   "downloads": [
    {
     "url": "https://agentreadinesscompare.com/data/standards-2026-11-04.json",
     "type": "application/json"
    }
   ]
  }
 ],
 "mcp": {
  "endpoint": "https://agentreadinesscompare.com/mcp",
  "transport": "streamable-http",
  "protocol_versions": [
   "2025-11-25",
   "2025-06-18",
   "2025-03-26"
  ],
  "server_card": "https://agentreadinesscompare.com/mcp/server-card",
  "manifest": "https://agentreadinesscompare.com/.well-known/mcp.json",
  "tools": [
   "list_scanners",
   "get_domain_scores",
   "list_concordance",
   "compare_scanners",
   "get_rubric"
  ]
 },
 "ask": {
  "endpoint": "https://agentreadinesscompare.com/ask",
  "protocol": "NLWeb 0.55",
  "methods": [
   "GET",
   "POST"
  ],
  "streaming": "streaming=true or Accept: text/event-stream",
  "example": "why scanners disagree"
 },
 "licence": {
  "name": "CC BY 4.0",
  "url": "https://creativecommons.org/licenses/by/4.0/"
 }
}