list_pages

A tool of the Sprintree MCP server. All MCP docs · Back to the tool list

added 2026-10-08

List a project's page tree. Without parent: the top level; parent (page number): its children; depth="all": the whole subtree, flattened (500 at most); query: full-text search instead. Rows: number, title, parent, children. Results are paged: if the answer has a cursor, call again with it (a missing cursor means the last page) — never assume the first page is everything. Answers are compact JSON; pass format="text" for a readable Markdown answer.

  • cursorstringoptional
    Cursor from `Next page` of an earlier result of this call (omit for the first page); pass it unchanged, with the same other arguments
  • depthenumoptional
    "1" (default) or "all" (whole subtree)
    1all
  • formatenumoptional
    Answer format: "json" (default) is one compact JSON document; "text" is a readable Markdown answer
    jsontext
  • limitintegeroptional
    Pages per page (1–200, default 50)
  • parentintegeroptional
    Page whose children to list (omit: top level)
  • projectstringrequired
    Project key
  • querystringoptional
    Search the project's pages instead of the tree

Returns

One of these shapes, depending on the arguments:

Shape 1

  • countintegerrequired
  • limitintegerrequired
  • nodesarray of object | nullrequired
  • projectstringrequired

Shape 2

    Optional fields, when present

    • cursorstringoptional
    • notestringoptional
    • pageintegeroptional
    • pagesintegeroptional
    • totalintegeroptional
    • totalApproximatebooleanoptional
    • 2026-10-08 — New format argument: Answers are compact JSON by default ({project, count, limit, page, pages, total, cursor, nodes: [{number, title, parent, children}]}; a missing cursor means the last page); format="text" is the readable Markdown the tool answered before (SPD-849).