{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-22T21:15:08.873Z",
  "record_id": "VXI-EXT-PROCUREMENT-MCP-PAGINATION-EMPTY-CURSOR-INVENTORY-COMPLETENESS-01-v1",
  "record_kind": "external_reference",
  "title": "MCP discovery: Pagination and valid empty cursors",
  "system": "Model Context Protocol",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does one successful MCP tools/list response establish the complete tool inventory?",
  "near_questions": [
    "Can an empty MCP nextCursor still indicate another page?",
    "Must MCP clients follow tools/list pagination?",
    "Can a fixed expected page size prove the tool list is complete?",
    "What evidence establishes that an MCP tool inventory reached its end?"
  ],
  "supported_claims": [
    {
      "claim": "MCP specification 2026-07-28 supports cursor-based tools/list pagination. Servers choose page sizes and return nextCursor when more results exist. Cursors are opaque; an empty string is valid and must not be mistaken for end-of-results. A successful first page does not establish a complete inventory.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Complete server inventory or authority from a first-page response",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for existing INDEX executables"
  ],
  "public_summary": "MCP specification 2026-07-28 supports cursor-based tools/list pagination. Servers choose page sizes and return nextCursor when more results exist. Cursors are opaque; an empty string is valid and must not be mistaken for end-of-results. A successful first page does not establish a complete inventory.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "MCP pagination",
    "source_url": "https://modelcontextprotocol.io/specification/2026-07-28/server/utilities/pagination",
    "checked_on": "2026-10-22",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-MCP-PAGINATION-EMPTY-CURSOR-INVENTORY-COMPLETENESS-01-v1",
    "candidate_record_sha256": "c0f04ebda6559dedaa002bb9928c6e4e22299a45ee7c22ab278a3e40ed84895d",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "MCP specification 2026-07-28 supports cursor-based tools/list pagination. Servers choose page sizes and return nextCursor when more results exist. Cursors are opaque; an empty string is valid and must not be mistaken for end-of-results. A successful first page does not establish a complete inventory.",
    "required_buyer_context": "Protocol version and authorization context; All list responses and continuation cursors; Terminal response and reconciled tool identifiers. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-22",
    "claim_to_check": "Does one successful MCP tools/list response establish the complete tool inventory?",
    "documented_statement": {
      "status": "documented",
      "statement": "MCP specification 2026-07-28 supports cursor-based tools/list pagination. Servers choose page sizes and return nextCursor when more results exist. Cursors are opaque; an empty string is valid and must not be mistaken for end-of-results. A successful first page does not establish a complete inventory.",
      "source_ids": [
        "mcp-pagination"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Tool admission review needs a complete inventory for the applicable caller context.",
      "source_ids": [
        "mcp-pagination"
      ]
    },
    "buyer_evidence_required": [
      "Protocol version and authorization context",
      "All list responses and continuation cursors",
      "Terminal response and reconciled tool identifiers"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Refuse completeness when pagination stopped on a non-null cursor or used an assumed page size."
    },
    "unknowns": "Server honesty, inventory stability and deployment permissions are unobserved.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "Server honesty, inventory stability and deployment permissions are unobserved."
    },
    "evidence_sources": [
      {
        "source_id": "mcp-pagination",
        "url": "https://modelcontextprotocol.io/specification/2026-07-28/server/utilities/pagination",
        "final_url": "https://modelcontextprotocol.io/specification/2026-07-28/server/utilities/pagination",
        "title": "MCP pagination",
        "checked_on": "2026-10-22",
        "captured_at_utc": "2026-10-22T21:09:24.934Z",
        "version_context": "MCP specification 2026-07-28; opaque cursor and empty-string cursor semantics reviewed.",
        "sha256": "b4954b34647cdea666ab7c73193dadee6f1be5314e7938629f8298f271722e1b",
        "bytes": 345555,
        "hash_basis": "Decoded HTTP response body bytes; identifies captured content, not truth or certification",
        "reviewed_sections": [
          "Pagination model",
          "Response format",
          "Implementation guidelines"
        ],
        "capture_status": 200,
        "rights_review": "Factual paraphrase and source metadata only; response body retained privately and not redistributed."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Documentation review only; the buyer must establish applicability and actual outcomes. INDEX does not inspect or control the deployment.",
    "paid_value": {
      "decision_context": "Prevent an admission review from silently omitting tools on later pages.",
      "free": "Complete review, sources, practical questions and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Recheck the documented behavior, product version and buyer evidence before relying on a current outcome."
    },
    "buyer_relevance": "Prevent an admission review from silently omitting tools on later pages.",
    "refusal_conditions": [
      "Refuse completeness when pagination stopped on a non-null cursor or used an assumed page size."
    ]
  },
  "niche": {
    "niche_id": "agent-authority-action-evidence",
    "label": "Agent Authority & Action Evidence",
    "classification_id": "audit",
    "classification_label": "Audit, Provenance & Evidence Accountability",
    "topic_id": "audit",
    "buyer_intent": "Prevent an admission review from silently omitting tools on later pages.",
    "comparison_role": "supplementary_discovery"
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#mcp-pagination-empty-cursor-inventory-completeness",
  "machine_readable_record": "/varexis-index/records/mcp-pagination-empty-cursor-inventory-completeness.json"
}
