# AI Website Intelligence & Agent Readiness API

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

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

## Facts

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

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-d4becd34
```

Example prompt: Can you audit https://mycompany.com for AI agent readiness — I want to know if it exposes OpenAPI, llms.txt, or MCP endpoints, and what grade it gets overall with prioritized fixes?

## When to prefer this

Choose this endpoint when you need a comprehensive, structured AI-agent-readiness audit of a public website, especially when you want to check for MCP, llms.txt, OpenAPI discoverability, and agent commerce support in a single call. It is preferable over generic SEO or uptime tools when the primary concern is whether an AI agent can discover and interact with the target site. Best suited for developers, AI product teams, and automation pipelines evaluating third-party or their own sites for agent-compatibility.

## Known failure modes

- Invalid or unreachable URL returns an error — the target must be a publicly accessible HTTP/HTTPS URL
- Non-existent domains or URLs returning 4xx/5xx may result in partial results or audit failure
- Only passive checks are performed — authenticated endpoints or private APIs will not be fully audited
- The 'depth' parameter currently only supports 'quick' — deeper audits are not available
- Payment failure (x402) will block the request before any audit is performed

## 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 structured JSON object containing: an overall letter grade (e.g. 'C') and numeric score (0-100), subscores for api_readiness and discovery_and_documentation, a findings array with individual check results (id, title, status, severity, confidence, recommendation), a website_intelligence object with dimensional scores (callable, trustworthy, discoverable, understandable), a readiness_level (name and numeric level), discovered interfaces (e.g. OpenAPI URL), recommended_actions with effort/impact ratings, applicability flags for MCP and agent commerce, tested_coverage_percent, confidence score, and a limitations list.

## 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-d4becd34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from santosautomation.com](https://www.zero.xyz/host/santosautomation.com/llms.txt)