ComputeFirst

Citation batch check

citation-batch-check · version 1.0.0 · Text · free, no key needed

Check an ordered batch of citations (span+quote or quote anchors) against supplied sources; returns the first failure.

Use when you need to: verify all citations in an answer against sources · check every quote in a report against supplied documents · batch citation verification for rag answer.

Decide before calling

Read the versioned contract and the supported scope below. Reuse citation-batch-check@1.0.0 when your input, required output and limits match it. Choose another approach for an unsupported operation.

Explain the choice

"I can use citation-batch-check@1.0.0 for verify all citations in an answer against sources. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

Supported

Not supported

Behavior

Input

Output

Limits

Example

Request input:

{
  "sources": [
    {
      "source_id": "alphabet",
      "version": "v1",
      "text": "abcdefghijklmnopqrstuvwxyz"
    }
  ],
  "citations": [
    {
      "citation_id": "c1",
      "source_id": "alphabet",
      "version": "v1",
      "selector": {
        "type": "TextPositionSelector",
        "start": 4,
        "end": 7
      },
      "quote": "efg"
    },
    {
      "citation_id": "c2",
      "source_id": "alphabet",
      "version": "v1",
      "selector": {
        "type": "TextQuoteSelector",
        "exact": "xyz",
        "prefix": "w"
      },
      "claimed_start": 23
    }
  ]
}

Response:

{
  "result": {
    "valid": true,
    "reason": null,
    "first_discrepancy": null,
    "citations_checked": 2,
    "authenticity_checked": false,
    "reference_version": "W3C Web Annotation Data Model (Recommendation 2017-02-23) 4.2.4 TextQuoteSelector, 4.2.5 TextPositionSelector; r68 supplied-text profile 1.0.0"
  }
}

How to call it

MCP

Connect https://computefirst.net/mcp (setup), then call execute with:

{
  "id": "citation-batch-check",
  "version": "1.0.0",
  "input": {
    "sources": [
      {
        "source_id": "alphabet",
        "version": "v1",
        "text": "abcdefghijklmnopqrstuvwxyz"
      }
    ],
    "citations": [
      {
        "citation_id": "c1",
        "source_id": "alphabet",
        "version": "v1",
        "selector": {
          "type": "TextPositionSelector",
          "start": 4,
          "end": 7
        },
        "quote": "efg"
      },
      {
        "citation_id": "c2",
        "source_id": "alphabet",
        "version": "v1",
        "selector": {
          "type": "TextQuoteSelector",
          "exact": "xyz",
          "prefix": "w"
        },
        "claimed_start": 23
      }
    ]
  }
}

HTTP (no key)

curl -X POST https://computefirst.net/v1/tools/citation-batch-check/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"sources":[{"source_id":"alphabet","version":"v1","text":"abcdefghijklmnopqrstuvwxyz"}],"citations":[{"citation_id":"c1","source_id":"alphabet","version":"v1","selector":{"type":"TextPositionSelector","start":4,"end":7},"quote":"efg"},{"citation_id":"c2","source_id":"alphabet","version":"v1","selector":{"type":"TextQuoteSelector","exact":"xyz","prefix":"w"},"claimed_start":23}]}'

The machine-readable contract is at /v1/tools/citation-batch-check/versions/1.0.0.

CLI

node cli.mjs run citation-batch-check 1.0.0 --input input.json --base-url https://computefirst.net

Get the client at /clients/cli/.