Paginate MCP tool results

Dacă schema de intrare a unui instrument include size și cursor, continuați prin rezultatele sale prin trecerea returnatului next_cursor în următorul apel.

Pagination loop

1. Apelați la instrumentul de listă fără cursor.
2. Citiți elementele din câmpul de rezultate specific instrumentului.
3. Dacă rezultatul include next_cursor, apelați din nou același instrument cu valoarea cursor.
4. Opriți atunci când next_cursor este absent.

Tratează valorile cursorului ca fiind opace. Nu le decoda, edita sau construi.

Example with listRisks

Primul apel include organizația și, opțional, o dimensiune a paginii:

{
  "organization_id": "organization-id",
  "size": 50
}

listRisks returnează elementele sale în risks. Când o altă pagină este disponibilă, rezultatul include, de asemenea, next_cursor:

{
  "risks": [
    {
      "id": "risk-id",
      "name": "Unauthorized production access"
    }
  ],
  "next_cursor": "cursor-value"
}

Utilizați această valoare în următorul apel:

{
  "organization_id": "organization-id",
  "size": 50,
  "cursor": "cursor-value"
}

Continuați până când rezultatul nu mai include ___ZBT_I18N_RUNTIME_BLOCK_183__.

Keep the query unchanged

Păstrați organizarea, filtrele, ordinea și dimensiunea paginii neschimbate atunci când solicitați următoarea pagină:

{
  "organization_id": "organization-id",
  "size": 50,
  "filter": {
    "query": "access"
  },
  "cursor": "cursor-value"
}

Verificați schema de intrare a instrumentului în clientulMCPîn loc să presupuneți că fiecare instrument de listă acceptă aceleași câmpuri.

Result fields differ by tool

De exemplu, listRisks returnează risks, în timp ce listThirdParties returnează thirdParties. Utilizați schema de ieșire publicată de server pentru a determina câmpul pentru un instrument specific.

Pentru sarcinile de lungă durată, procesați fiecare pagină înainte de a solicita următoarea, în loc să acumulați rezultatul complet setat în memorie.