# Annalist Web Readiness

> Annalist Web Readiness is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-16).

Returns a comprehensive agent-readiness report for a given website, including MCP/A2A endpoints, payment capabilities, llms.txt, robots.txt AI rules, Shopify store facts, and change history.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/web/readiness?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-web-readiness-7e7fc415
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SjO48JvbryJd0SYth2GUV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability annalist-web-readiness-7e7fc415
```

Example prompt: Check the agent readiness of allbirds.com — I want to know if they have an MCP endpoint, support x402 payments, have an llms.txt, and which AI agents their robots.txt allows.

## When to prefer this

Use this endpoint when you need a comprehensive, signed, single-call assessment of a website's AI agent readiness — covering MCP, ACP, A2A, x402, llms.txt, and robots.txt — rather than scraping and parsing those signals yourself. Prefer this over manual inspection when you need structured, dated change history or Shopify store facts like shipping destinations and currency. Especially valuable for agents doing pre-integration due diligence or monitoring a portfolio of sites for new agent capabilities.

## Known failure modes

- Domain not found or unreachable — live visit attempted but may time out
- Invalid or malformed domain parameter — returns error
- Site has no agent-readiness signals — returns empty/null fields
- Payment failure — x402 payment of $0.005 USDC required per call
- Census data may be up to one week stale for sites already in the index

## How this service works

One site's agent readiness from our weekly census of 65,000 top sites: UCP and ACP agent checkout (its MCP endpoint, capabilities, payment handlers), A2A and MCP cards, a real llms.txt, robots.txt rules for 15 AI agents, x402, store and platform, Shopify store facts (ships-to countries, currency), and every change dated. A site not yet in the census is visited live. Measured by us. Signed.

## Output

A structured, signed report covering: MCP endpoint URL and capabilities, ACP agent checkout support, A2A and MCP cards, presence and content of llms.txt, robots.txt rules for 15 named AI agents, x402 payment handler details, Shopify store metadata (ships-to countries, currency), platform/store type, and a dated changelog of all detected changes. For sites not yet in the weekly census, a live visit is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "description": "the site, for example allbirds.com"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-web-readiness-7e7fc415/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.annalist.dev](https://www.zero.xyz/host/api.annalist.dev/llms.txt)