# Mekler AI x402 Service Conformance Scanner

> Mekler AI x402 Service Conformance Scanner is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Scans an x402-enabled API origin and its endpoint paths to produce a graded compliance and linting report, including protocol checks, documentation coverage, and directory listings.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/services/conformance/scan-origin?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-x402-service-conformance-scanner-b7aa6148
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q9-IZ5XXaCaWhxnS1piNu

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 mekler-ai-x402-service-conformance-scanner-b7aa6148 -d '<json body>'
```

Example prompt: Can you run an x402 conformance scan on my API at https://api.myservice.com and check these paths: /v1/pay and /v1/status — I want the full compliance grade and any findings I need to fix?

## When to prefer this

Use this endpoint when you need to audit or certify that an x402-enabled API correctly implements the x402 payment protocol — covering protocol headers, documentation presence, and directory listings. Prefer it over generic HTTP health checks or manual inspection when you need a structured, graded compliance report with actionable findings and fix suggestions, especially before launching a new x402 service or diagnosing client-facing rejection issues.

## Known failure modes

- Invalid or unreachable origin URL returns an error or failing HTTP-reachable finding
- Paths exceeding 50 items or 1024 characters are rejected by schema validation
- Non-public or private IP addresses blocked by public-address checks
- Malformed idempotency key pattern causes request rejection
- Origin returns unexpected content types that prevent protocol evaluation
- Timeout when origin is slow to respond, resulting in partial or inconclusive evaluation

## How this service works

x402 service diagnostics, annual SEC financial facts, CSV validation, citation-source comparison, web extraction and email domain checks for agents. Retrieve six annual US-GAAP USD fields by CIK with filing links, same-filing growth checks and optional observed revisions; check supplied CSV and citations; extract public page text, rendering JavaScript in a headless browser when needed; inspect email address syntax and mail-domain DNS. Pay per call with native USDC on Base or Solana via x402, without a separate API key. Wallet-first free trials cover CSV, column-spec, citation and static-page operations.

## Output

Returns a JSON report containing: a linter grade (A-F) and numeric score with per-category breakdowns (docs, protocol, directory), a compliance grade and score, a list of findings each with an ID, title, status (pass/fail), severity, category, and suggested fix, plus coverage metadata (paid routes probed, head observations, delivery verified flag), a unique report_id, scan timestamp, and expiry timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "paths": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^/",
    "maxLength": 1024
   },
   "maxItems": 50,
   "uniqueItems": true
  },
  "origin": {
   "type": "string",
   "format": "uri",
   "maxLength": 2048
  },
  "quote_mode": {
   "enum": [
    "fast"
   ],
   "type": "string"
  },
  "idempotency_key": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{22,128}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "linter": {
   "grade": "B",
   "score": 89,
   "total": 25,
   "evaluated": 20,
   "categories": {
    "docs": 68,
    "protocol": 100,
    "directory": 100
   },
   "provisional": true,
   "rules_version": "mekler-2026-10-07.1"
  },
  "coverage": {
   "chain_checks": "not_evaluated",
   "delivery_verified": false,
   "head_observations": 1,
   "paid_routes_probed": 1,
   "raw_content_published": false
  },
  "findings": [
   {
    "id": "P1",
    "fix": "Serve a reachable public HTTP endpoint.",
    "title": "http-reachable",
    "status": "pass",
    "category": "protocol",
    "evidence": "criterion_satisfied",
    "severity": "critical"
   }
  ],
  "report_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "compliance": {
   "grade": "A",
   "score": 100,
   "total": 14,
   "evaluated": 14,
   "provisional": false,
   "rules_version": "mekler-2026-10-07.1"
  },
  "expires_at": 1791417600,
  "scanned_at": 1791331200,
  "checks_version": "mekler-2026-10-07.1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mekler-ai-x402-service-conformance-scanner-b7aa6148/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mekler.ai](https://www.zero.xyz/host/api.mekler.ai/llms.txt)