{
 "name": "Am I Ready for Agents? API",
 "version": "v1",
 "edition": "2026-11-04",
 "documentation": "https://amireadyforagents-preview.vercel.app/developers",
 "openapi": "https://amireadyforagents-preview.vercel.app/openapi.json",
 "api_catalog": "https://amireadyforagents-preview.vercel.app/.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://amireadyforagents-preview.vercel.app/developers"
 },
 "endpoints": [
  {
   "path": "/api/v1/list_sectors",
   "method": "GET",
   "summary": "List the eight sectors",
   "parameters": [
    "limit",
    "cursor"
   ],
   "example": {},
   "paginated": true
  },
  {
   "path": "/api/v1/get_sector_scorecard",
   "method": "GET",
   "summary": "One sector scorecard in full",
   "parameters": [
    "sector"
   ],
   "example": {
    "sector": "ecommerce"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/rank_sectors",
   "method": "GET",
   "summary": "Rank the sectors on one measure",
   "parameters": [
    "metric",
    "order"
   ],
   "example": {
    "metric": "allow_agents"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/get_self_check",
   "method": "GET",
   "summary": "The self-check questions",
   "parameters": [
    "sector",
    "area",
    "include_sources"
   ],
   "example": {
    "sector": "ecommerce",
    "area": "pay"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/get_definitions",
   "method": "GET",
   "summary": "What each measure counts and the crawl behind it",
   "parameters": [],
   "example": {},
   "paginated": false
  },
  {
   "path": "/ask",
   "method": "GET, POST",
   "summary": "NLWeb 0.55 ask",
   "example": {
    "query": "healthcare allow agents"
   }
  }
 ],
 "datasets": [
  {
   "key": "scorecards",
   "title": "Sector scorecards",
   "description": "Eight sectors with the sample size and the four shares as counts and percentages, the definitions and the baseline of every crawled domain.",
   "downloads": [
    {
     "url": "https://amireadyforagents-preview.vercel.app/data/scorecards-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://amireadyforagents-preview.vercel.app/data/scorecards-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "sectors",
   "title": "Sector index",
   "description": "The eight sectors with the id used in the scorecard file, the slug used in page paths and the four page URLs of each.",
   "downloads": [
    {
     "url": "https://amireadyforagents-preview.vercel.app/data/sectors-2026-11-04.json",
     "type": "application/json"
    }
   ]
  },
  {
   "key": "selfCheck",
   "title": "Self-check questions",
   "description": "The 18 core questions with the plain reason and the decision or fix behind each, the scoring rule, and the examples and two extra questions of each sector version.",
   "downloads": [
    {
     "url": "https://amireadyforagents-preview.vercel.app/data/self-check-2026-11-04.json",
     "type": "application/json"
    }
   ]
  },
  {
   "key": "decisions",
   "title": "Ten decisions",
   "description": "The ten decisions that sit with leadership, each with its options, their consequences and the dated sources.",
   "downloads": [
    {
     "url": "https://amireadyforagents-preview.vercel.app/data/decisions-2026-11-04.json",
     "type": "application/json"
    }
   ]
  }
 ],
 "mcp": {
  "endpoint": "https://amireadyforagents-preview.vercel.app/mcp",
  "transport": "streamable-http",
  "protocol_versions": [
   "2025-11-25",
   "2025-06-18",
   "2025-03-26"
  ],
  "server_card": "https://amireadyforagents-preview.vercel.app/mcp/server-card",
  "manifest": "https://amireadyforagents-preview.vercel.app/.well-known/mcp.json",
  "tools": [
   "list_sectors",
   "get_sector_scorecard",
   "rank_sectors",
   "get_self_check",
   "get_definitions"
  ]
 },
 "ask": {
  "endpoint": "https://amireadyforagents-preview.vercel.app/ask",
  "protocol": "NLWeb 0.55",
  "methods": [
   "GET",
   "POST"
  ],
  "streaming": "streaming=true or Accept: text/event-stream",
  "example": "healthcare allow agents"
 },
 "licence": null
}