nsip 0.7.0

NSIP Search API client for nsipsearch.nsip.org/api
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# `mcp/invalid-cursor` — Invalid pagination cursor

- **type**: `https://github.com/zircote/nsip/blob/main/docs/reference/errors/mcp/invalid-cursor.md`
- **status**: 400 · **exit_code**: 1 · **class**: caller
- **`suggested_fix` applicability**: `machine_applicable`
- **`retry_after`**: never

## When it occurs

A paginated MCP list request (`tools/list`, `resources/list`,
`resources/templates/list`, `prompts/list`) was given a `cursor` that could
not be decoded as an offset, or whose offset was past the end of the result
set. Cursors are opaque tokens returned in a prior page's `nextCursor`; they
must not be synthesized or mutated. (JSON-RPC code: `invalid_params` / -32602.)

## Recovery

Restart pagination without a cursor (begin from the first page), then follow
the `nextCursor` values verbatim. Deterministic — an agent may drop the bad
cursor and retry.

## Example

```json
{
  "type": "https://github.com/zircote/nsip/blob/main/docs/reference/errors/mcp/invalid-cursor.md",
  "title": "Invalid pagination cursor",
  "status": 400,
  "detail": "validation error: cursor could not be decoded as an offset",
  "instance": "urn:nsip:resources/list:5f6a7b8c-9d0e-1f2a-3b4c-5d6e7f8a9b0c",
  "exit_code": 1,
  "suggested_fix": "restart pagination without a cursor (begin from the first page)",
  "docs_url": "https://github.com/zircote/nsip/blob/main/docs/reference/errors/mcp/invalid-cursor.md"
}
```