# BRAINIAC LLMs.txt Version Consistency Checker

> BRAINIAC LLMs.txt Version Consistency Checker is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Compares multiple versions of an llms.txt document to detect inconsistencies in API versions, semantic versions, updated dates, and link targets, returning a consistency score and detailed issue list.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/llms-txt/version-consistency?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-llms-txt-version-consistency-checker-fcfdf740
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_66Gc1dSqxCKD2-BptPFkE

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 brainiac-llms-txt-version-consistency-checker-fcfdf740 -d '<json body>'
```

Example prompt: Compare these two versions of my llms.txt — the March snapshot and the April snapshot — and tell me if any API versions, semantic versions, updated dates, or link targets are inconsistent between them.

## When to prefer this

Use this endpoint when you need automated, structured diff analysis of llms.txt documents specifically — particularly when you need a scored report of API version drift, semver inconsistencies, date mismatches, and link target changes across 2–8 snapshots. Prefer this over manual diffing or generic document comparison when you need machine-readable issue objects with severity ratings for downstream automation or CI checks.

## Known failure modes

- Fewer than 2 versions provided — validation error
- More than 8 versions provided — rejected by schema
- Text or document fields missing — parser may find no headings or links and return empty issues
- Non-markdown or non-llms.txt formatted text — parser silently skips unrecognized structure
- URLs in links are not fetched — link reachability cannot be confirmed
- Semantic versions outside the blockquote summary are not detected
- Payment not received — x402 payment required response before processing

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with a numeric consistency score (0–100, penalized per issue), a list of detected issues each with type, severity, evidence, location, and description, an analysis summary string, warnings, limitations, and recommendations. Issues include types such as api_version_mismatch, summary_semver_mismatch, updated_date_mismatch, and link_target_changed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "versions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "text": {
      "type": "string",
      "maxLength": 200000
     },
     "document": {
      "type": "object",
      "properties": {
       "title": {
        "type": "string",
        "maxLength": 200
       },
       "summary": {
        "type": "string",
        "maxLength": 5000
       },
       "sections": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "name",
          "links"
         ],
         "properties": {
          "name": {
           "type": "string",
           "maxLength": 200
          },
          "links": {
           "type": "array",
           "items": {
            "type": "object",
            "required": [
             "title",
             "url"
            ],
            "properties": {
             "url": {
              "type": "string",
              "maxLength": 2000
             },
             "title": {
              "type": "string",
              "maxLength": 200
             },
             "description": {
              "type": "string",
              "maxLength": 1000
             }
            },
            "additionalProperties": false
           },
           "maxItems": 200
          }
         },
         "additionalProperties": false
        },
        "maxItems": 50
       }
      },
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   },
   "maxItems": 8,
   "minItems": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 47,
  "issues": [
   {
    "type": "api_version_mismatch",
    "evidence": "v1 vs v2",
    "location": "march and april",
    "severity": "high",
    "description": "The versions mention different /api/vN/ major versions."
   },
   {
    "type": "summary_semver_mismatch",
    "evidence": "1.2.0 vs 1.3.0",
    "location": "march and april",
    "severity": "medium",
    "description": "The blockquote summaries contain different semantic versions."
   },
   {
    "type": "updated_date_mismatch",
    "evidence": "2026-03-01 vs 2026-04-01",
    "location": "march line 3; april line 3",
    "severity": "medium",
    "description": "The versions give different updated, as of, or last modified dates."
   },
   {
    "type": "link_target_changed",
    "evidence": "Create: /api/v1/widgets vs /api/v2/widgets",
    "location": "march line 6; april line 6",
    "severity": "medium",
    "description": "The same link title points at a different path in the other version. Neither URL was fetched."
   }
  ],
  "success": true,
  "analysis": "Compared 2 document versions for API major versions, summary semantic versions, updated dates, and link targets.",
  "warnings": [],
  "limitations": [
   "The parser reads ATX headings, a blockquote directly after the H1, and markdown list links. It does not fetch URLs, run HTML, or decide that a link works.",
   "API versions are /api/vN/ tokens. Semantic versions are compared only inside the blockquote summary. Dates must follow updated, as of, or last modified.",
   "Each mismatch subtracts 15, each mixed major version subtracts 10, and each changed link target subtracts 8.",
   "A difference is not a claim about which version is current."
  ],
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-llms-txt-version-consistency-checker-fcfdf740/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
