Sprintree
Sign inGet started

list_issue_files

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

added 2026-09-30

List the files attached to an issue: id, name, size, type, who uploaded it and when, and the download URL (open it with the same token). Content is not returned. 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
  • keystringrequired
    Issue key, e.g. ITR-12
  • limitintegeroptional
    How many files per page (1–200, default 50)

Returns

One of these shapes, depending on the arguments:

Shape 1

  • countintegerrequired
  • filesarray of object | nullrequired
  • limitintegerrequired

Shape 2

    Optional fields, when present

    • cursorstringoptional
    • 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 file is {id, name, size (bytes), type, by (username), at, url}.
    • 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.