{
  "@context": "https://agenticresourcediscovery.org/context/v1",
  "specVersion": "0.91",
  "host": {
    "displayName": "Known Good",
    "identifier": "https://knowngood.sh"
  },
  "entries": [
    {
      "identifier": "urn:air:knowngood.sh:api:find",
      "displayName": "Known Good capability search",
      "type": "application/json",
      "url": "https://knowngood.sh/api/find",
      "description": "Search an index of websites whose agent-facing capabilities have been probed live and dated. Returns verified signals, the verification tier, and a citable report URL per result. Returns an honest zero rather than weak nearest neighbours.",
      "representativeQueries": [
        "buy perfume",
        "book scuba diving",
        "currency conversion API",
        "seo agency",
        "buy handmade soap"
      ],
      "capabilities": [
        "search",
        "capability-lookup",
        "site-verification"
      ],
      "tags": [
        "search",
        "agent-readiness",
        "mcp",
        "index"
      ],
      "metadata": {
        "apiCatalog": "https://knowngood.sh/.well-known/api-catalog",
        "rubric": "https://knowngood.sh/benchmark"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    },
    {
      "identifier": "urn:air:knowngood.sh:mcp:knowngood",
      "displayName": "Known Good MCP server",
      "type": "application/mcp-server-card+json",
      "url": "https://knowngood.sh/.well-known/mcp/server-card.json",
      "description": "MCP server exposing find_capability (search the index) and get_site_report (one site's probe results). Streamable HTTP at https://knowngood.sh/mcp.",
      "representativeQueries": [
        "buy perfume",
        "documentation",
        "developers.cloudflare.com",
        "siemens"
      ],
      "capabilities": [
        "find_capability",
        "get_site_report"
      ],
      "tags": [
        "mcp",
        "search",
        "site-report"
      ],
      "metadata": {
        "endpoint": "https://knowngood.sh/mcp",
        "transport": "streamable-http"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    },
    {
      "identifier": "urn:air:knowngood.sh:web:browse",
      "displayName": "Known Good index, browsable",
      "type": "text/html",
      "url": "https://knowngood.sh/browse",
      "description": "The whole index as pages: by category, country, entity type and platform. Every hub has a markdown twin at the same path with .md appended.",
      "representativeQueries": [
        "documentation",
        "shop",
        "hotel",
        "marketplace"
      ],
      "capabilities": [
        "browse",
        "faceted-index"
      ],
      "tags": [
        "index",
        "browse",
        "directory"
      ],
      "metadata": {
        "markdown": "https://knowngood.sh/browse.md"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    },
    {
      "identifier": "urn:air:knowngood.sh:web:agent-readiness-census",
      "displayName": "Agent-Readiness Census, September 2026",
      "type": "text/html",
      "url": "https://knowngood.sh/census/2026-09",
      "description": "The dated monthly measurement of how much of the web an agent can actually use, probed rather than declared, with the population beside every figure. September 2026: a live MCP endpoint on all 50 Wix tenants sampled, and on all 46 Shopify tenants that could be asked, against 14,351 sites in the index.",
      "representativeQueries": [
        "which website platforms give AI agents an endpoint",
        "how many sites use WebMCP",
        "what is agentic resource discovery",
        "does Shopify give AI agents an MCP endpoint"
      ],
      "capabilities": [
        "census",
        "adoption-statistics"
      ],
      "tags": [
        "census",
        "adoption",
        "measurement",
        "open-data"
      ],
      "metadata": {
        "markdown": "https://knowngood.sh/census/2026-09.md",
        "series": "https://knowngood.sh/census/",
        "repository": "https://github.com/knowngood-sh/agent-readiness-census",
        "snapshot": "2026-09"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    },
    {
      "identifier": "urn:air:knowngood.sh:data:agent-readiness-census-platforms",
      "displayName": "Census platform sample, September 2026",
      "type": "text/csv",
      "url": "https://raw.githubusercontent.com/knowngood-sh/agent-readiness-census/main/census/2026-09-platforms.csv",
      "description": "Ten website platforms, 50 sampled tenants each, custom domains only: how many serve an agent-actionable endpoint, whether it is platform-supplied, and a 95% Wilson interval on every rate. Measured September 2026.",
      "representativeQueries": [
        "what share of Shopify stores expose an MCP endpoint",
        "which website builders serve markdown to agents",
        "how many WordPress sites publish an llms.txt"
      ],
      "capabilities": [
        "census",
        "platform-attribution"
      ],
      "tags": [
        "census",
        "platforms",
        "mcp",
        "open-data"
      ],
      "metadata": {
        "repository": "https://github.com/knowngood-sh/agent-readiness-census",
        "rubric": "https://github.com/knowngood-sh/agent-readiness-census/blob/main/RUBRIC.md",
        "snapshot": "2026-09",
        "page": "https://knowngood.sh/census/2026-09"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    },
    {
      "identifier": "urn:air:knowngood.sh:data:agent-readiness-census-figures",
      "displayName": "Census standing figures, September 2026",
      "type": "text/csv",
      "url": "https://raw.githubusercontent.com/knowngood-sh/agent-readiness-census/main/census/2026-09-figures.csv",
      "description": "The index's own standing figures under rubric v1.1: how many listed sites pass each capability check, the population each was measured over, and the date each was last re-graded. Measured September 2026.",
      "representativeQueries": [
        "how many sites serve markdown when an agent asks",
        "how many MCP server cards point at nothing",
        "how many sites publish an llms.txt"
      ],
      "capabilities": [
        "census",
        "adoption-statistics"
      ],
      "tags": [
        "census",
        "adoption",
        "measurement",
        "open-data"
      ],
      "metadata": {
        "repository": "https://github.com/knowngood-sh/agent-readiness-census",
        "rubric": "https://github.com/knowngood-sh/agent-readiness-census/blob/main/RUBRIC.md",
        "snapshot": "2026-09",
        "page": "https://knowngood.sh/census/2026-09"
      },
      "trustManifest": {
        "identity": "https://knowngood.sh",
        "identityType": "https"
      }
    }
  ]
}