# Agent-Readiness Score

> Agent-Readiness Score is a paid API for AI agents from x402-v2-mint-agent-readiness.vercel.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-31).

Audits a public website for AI-agent compatibility signals (robots.txt bot rules, llms.txt, JSON-LD, OpenAPI/MCP, x402) and returns a deterministic 0–100 score with actionable fixes.

## Facts

- Endpoint: POST https://x402-v2-mint-agent-readiness.vercel.app/v1/agent-readiness?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-readiness-score-7220e036
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-WICSJvh2VmjF8yDgiccJ

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 agent-readiness-score-7220e036 -d '<json body>'
```

Example prompt: Can you run an agent-readiness audit on example.com and tell me the score plus what I need to fix to make it fully AI-agent compatible?

## When to prefer this

Use this endpoint when you need a fast, deterministic, standards-based audit of a public website's AI-agent compatibility — specifically checking robots.txt bot permissions, llms.txt, JSON-LD structured data, OpenAPI/MCP discovery endpoints, and x402 payment support. Prefer it over general SEO or crawlability tools when the goal is AI-agent discoverability and interoperability rather than search engine ranking.

## Known failure modes

- Bad or malformed URL returns HTTP 400 with charged:false
- Unreachable or non-existent host returns HTTP 422 with charged:false
- Rate limit: capped at 6 public GETs per call to avoid abuse
- Timeout if target site is extremely slow to respond
- Private or localhost URLs likely rejected as non-public

## How this service works

Agent-readiness check for a public site: robots.txt AI-bot rules, llms.txt, JSON-LD schema, OpenAPI/MCP discovery, /.well-known/x402. Deterministic 0-100 score + fixes. Max 6 capped public GETs. Bad url → 400, unreachable host → 422, both charged:false (checked before settle).

## Output

A JSON object with an overall 0–100 agent-readiness score, per-check results (robots.txt AI-bot rules, llms.txt presence, JSON-LD schema, OpenAPI/MCP endpoint discovery, /.well-known/x402), a list of concrete fix recommendations, and any errors encountered. The `charged` field indicates whether the call was billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "https URL or bare public domain"
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "url": "https://example.com",
   "fixes": [],
   "score": 25,
   "checks": {},
   "errors": []
  },
  "skill": "agent-readiness",
  "charged": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-readiness-score-7220e036/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-agent-readiness.vercel.app](https://www.zero.xyz/host/x402-v2-mint-agent-readiness.vercel.app/llms.txt)