list_statuses

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

added 2026-10-01

List a project's statuses (board columns) in board order with their key, name and category (todo, in_progress, review, done). Keys are what create_issue, update_issue_status, move_issue and search_issues take as status. The category says what a status means: done = finished, everything else is open. Answers are compact JSON; pass format="text" for a readable Markdown answer. 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.

  • 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
  • formatenumoptional
    Answer format: "json" (default) is one compact JSON document; "text" is a readable Markdown answer
    jsontext
  • limitintegeroptional
    How many statuses per page (1–200, default 50)
  • projectstringrequired
    Project key, e.g. ITR

Returns

One of these shapes, depending on the arguments:

Shape 1

  • countintegerrequired
  • limitintegerrequired
  • statusesarray of object | nullrequired

Shape 2

    Optional fields, when present

    • cursorstringoptional
    • defaultstringoptional
      The status key new issues start in
    • notestringoptional
    • pageintegeroptional
    • pagesintegeroptional
    • totalintegeroptional
    • totalApproximatebooleanoptional
    • 2026-10-02 — Answers are compact JSON by default (one document, no Markdown, nothing said twice); format="text" gives the readable Markdown without the json block. Each status is {key, name, category, color (when set)}, `default` is the key new issues start in.
    • 2026-10-02 — Paged: new optional limit and cursor arguments. The answer carries the paging (total, totalApproximate, page, pages, count, limit, cursor; a missing cursor means the last page); format="text" opens with a header (Page N of M · X items · showing a–b) and ends with the next cursor or Last page.
    • 2026-10-03 — Also answers structuredContent (see outputSchema); a failed call adds structuredContent.error. Text unchanged. Details: /docs/mcp, "Structured results and errors".
    • 2026-10-04 — Claude Code 2.1.288+ (clientInfo claude-code): the text of a successful answer is itself up to 512 bytes, else "Result in structuredContent (N bytes)."; structuredContent and errors are unchanged. See /docs/mcp.
    • 2026-10-04 — format="text" now also answers structuredContent {"text": the Markdown} (it was the JSON document), so a client that reads only structuredContent gets the Markdown it asked for.