BRAINIAC Pagination Contract Check is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).
Analyzes an OpenAPI spec or workflow definition to detect pagination anti-patterns that would cause AI agents to miss pages, loop infinitely, or skip records
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.
A JSON object containing a numeric score (0-100), a boolean success flag, an analysis summary string, a list of issues each with type, severity, location, evidence, description, agent_impact, and suggested_fix fields, plus a warnings array and limitations list explaining what was and was not checked.
POSThttps://www.brainiac.software/api/v1/agent-contracts/pagination-contract-check?utm_source=zero.xyzUse this endpoint when you need automated, agent-readable feedback on whether your API contract is safe for AI agents to paginate through — particularly when you suspect missing continuation fields, unclear termination conditions, or conflicting cursor/offset styles. Prefer it over manual review when building agent pipelines that call list endpoints, or before deploying an agent that must traverse multi-page results without human supervision.
| Field | Type | Description |
|---|---|---|
| openapi | object | |
| workflows | array | |
| operations | array |
{
"type": "json",
"example": {
"score": 48,
"issues": [
{
"type": "missing_continuation",
"evidence": "cursor",
"location": "openapi.paths[/orders].get",
"severity": "high",
"description": "The contract describes a page or a cursor and does not name the response field that leads to the next page.",
"agent_impact": "An agent can stop after the first page or loop because it has no declared continuation field.",
"suggested_fix": "Name the response field, such as next_cursor, and the request field that receives it."
},
{
"type": "unclear_cursor",
"evidence": "Page cursor.",
"location": "openapi.paths[/orders].get.parameters.cursor",
"severity": "medium",
"description": "A cursor parameter is named, and the text does not say whether it is opaque, how the first page is requested, or when it expires.",
"agent_impact": "An agent may parse the cursor, omit it incorrectly, or reuse it after it stops working.",
"suggested_fix": "Say to omit it for the first page, whether it is opaque, and whether it expires."
},
{
"type": "unclear_termination",
"evidence": "list_orders",
"location": "openapi.paths[/orders].get",
"severity": "high",
"description": "The contract does not say how the agent knows the last page has been reached.",
"agent_impact": "An agent can keep requesting pages after the list has ended.",
"suggested_fix": "State the end condition, such as a null next cursor, has_more false, or an empty page."
},
{
"type": "conflicting_pagination",
"evidence": "cursor, offset",
"location": "openapi.paths[/orders].get",
"severity": "medium",
"description": "Both a cursor and an offset or page parameter are declared, and the text does not say which one to follow.",
"agent_impact": "An agent can send both and skip or repeat records.",
"suggested_fix": "Tell the agent to use one continuation style and ignore the other."
}
],
"success": true,
"analysis": "Checked 1 operations that mention a page, cursor, or offset.",
"warnings": [],
"limitations": [
"Checks read only the supplied operations, workflows, and OpenAPI document. No URL is fetched and no model reads the text.",
"A missing sentence is an undocumented contract. It is not a confirmed defect in a running implementation.",
"A contradiction is two statements in the supplied text. It is not proof of how a server behaves.",
"The HTTP method is not evidence that an operation is safe to retry or that it is idempotent.",
"Matches are fixed phrases and field names. They do not infer a business rule that the text does not state.",
"A continuation field is next, next_cursor, next_page, continuation_token, or next_page_token. A bare limit is not a continuation.",
"Termination is has_more, total, or a sentence such as null next cursor or last page.",
"Missing continuation or termination subtracts 15. An unclear cursor subtracts 10. Cursor plus offset subtracts 12. The score is omitted when nothing describes a page."
],
"recommendations": []
}
}No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"