# AI Website Intelligence & Agent Readiness API

> AI Website Intelligence & Agent Readiness API is a paid API for AI agents from api.santosautomation.com, paid per call via x402, $0.075/call, status unknown (last checked 2026-09-16).

Audits any public website URL for AI agent readiness, MCP support, llms.txt, OpenAPI discovery, SEO, accessibility, and security, returning a structured JSON report with scores and prioritized fixes.

## Facts

- Endpoint: HEAD https://api.santosautomation.com/api/agent-readiness
- Price: $0.075/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ai-website-intelligence-agent-readiness-api-006156f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ACPaHEx7WWTxFSpTBFw0S

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 ai-website-intelligence-agent-readiness-api-006156f3 -d '<json body>'
```

Example prompt: Can you audit https://stripe.com for AI agent readiness and tell me its score, grade, and what the highest-priority fixes are to make it more callable by AI agents?

## When to prefer this

Choose this endpoint when you need a structured, evidence-backed audit of a specific website's readiness for AI agent interaction — especially when you want to assess MCP support, llms.txt presence, OpenAPI discoverability, and get prioritized remediation guidance in a single call. Prefer it over generic SEO or security scanners when the goal is specifically AI/agent-layer readiness rather than traditional web performance.

## Known failure modes

- Non-public or unreachable URL returns an error or empty findings
- Private/authenticated endpoints cannot be tested (passive checks only)
- Very large or slow sites may result in incomplete coverage
- Malformed URL input causes a validation error
- Rate limiting or payment failure (x402) blocks the request

## How this service works

Audit any website for AI Agent Readiness, MCP, llms.txt, OpenAPI, SEO, accessibility and security. Structured JSON with evidence and prioritized fixes.

## Output

Returns a JSON object containing an overall letter grade (e.g. C), numeric score (0-100), readiness level name and tier, categorized findings with pass/fail status and severity, subscores by dimension (api_readiness, discovery_and_documentation, etc.), website intelligence dimensions (callable, trustworthy, discoverable, understandable), discovered interfaces (OpenAPI URL, MCP, etc.), applicability flags, prioritized recommended actions with effort and impact ratings, tested coverage percent, and confidence score.

## 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": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public HTTP or HTTPS target URL."
      },
      "depth": {
       "enum": [
        "quick"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "grade": "C",
  "score": 79,
  "target": {
   "final_url": "https://example.com/",
   "requested_url": "https://example.com",
   "canonical_origin": "https://example.com"
  },
  "profile": "api_provider",
  "findings": [
   {
    "id": "agent.openapi.discovery",
    "title": "OpenAPI document discovered and parsed",
    "status": "pass",
    "category": "api_readiness",
    "severity": "moderate",
    "confidence": "high",
    "recommendation": "No action needed."
   }
  ],
  "subscores": {
   "api_readiness": 75,
   "discovery_and_documentation": 80
  },
  "confidence": 0.91,
  "interfaces": {
   "openapi": {
    "url": "https://example.com/openapi.json",
    "discovered": true
   }
  },
  "limitations": [
   "Passive checks only; no authenticated or transactional testing performed."
  ],
  "applicability": {
   "mcp_readiness": "tested",
   "agent_commerce": "not_applicable"
  },
  "schema_version": "1.0.0",
  "readiness_level": {
   "name": "Tool-invokable",
   "level": 3
  },
  "recommended_actions": [
   {
    "id": "agent.capabilities.manifest",
    "effort": "medium",
    "impact": "high"
   }
  ],
  "website_intelligence": {
   "score": 82,
   "dimensions": {
    "callable": 73,
    "trustworthy": 86,
    "discoverable": 91,
    "understandable": 78
   },
   "schema_version": "1.0.0"
  },
  "tested_coverage_percent": 90,
  "website_intelligence_score": 82
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ai-website-intelligence-agent-readiness-api-006156f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.santosautomation.com](https://www.zero.xyz/host/api.santosautomation.com/llms.txt)