# Agent Card Discovery Audit

> Agent Card Discovery Audit is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Passively fetches public evidence from a target URL and audits it for agent card discoverability, returning observations, verdicts, evidence sources, and recommended actions.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/agent-card-audit?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-card-discovery-audit-5c2c41ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eRpWFXzhl5yqI0LKIBk_j

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-card-discovery-audit-5c2c41ec -d '<json body>'
```

Example prompt: Can you audit https://myservice.example.com for agent card discoverability and tell me whether it passes, what evidence was found, and what I should fix?

## When to prefer this

Use this endpoint when you need a passive, non-invasive audit of whether a public URL or domain exposes a correctly formatted and discoverable agent card. It is the right choice when you want a structured verdict with evidence provenance rather than a generic HTTP probe. Prefer it over manual inspection or generic crawlers when you need the specific agent card criterion evaluated with a documented threshold and actionable repair guidance.

## Known failure modes

- Target URL is unreachable or returns non-200 status — audit cannot fetch evidence
- Domain normalization fails for malformed or private URLs
- Baseline comparison returns diff errors if baseline schema is incompatible
- Rate limiting or network timeouts on the target side cause incomplete evidence collection
- Private or auth-gated agent cards cannot be evaluated since no login is attempted

## How this service works

Agent card discovery audit fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns a structured audit result including the observation (what was found), the threshold being evaluated, the verdict (pass/fail), the exact evidence source URL, known limitations of the passive check, and a mode-specific action the site owner should take. Context labels passed in are returned unchanged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-card-discovery-audit-5c2c41ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)