save_cycle

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

added 2026-10-05can overwrite data

Create, change, start, complete or delete a cycle (one is active per project). Create: project, starts_on, ends_on (YYYY-MM-DD, up to 92 days), optional name, goal. Change: project, cycle (number), the fields, optionally rev (stale: nothing is written). action, delete and every change need cycle (its number). action=start activates a planned cycle. action=complete ends that cycle (the active one): move_open_to (required: next, none or a cycle number) takes its unfinished issues, start_next starts that cycle. delete=true removes a planned cycle; its issues stay, in no cycle.

  • actionenumoptional
    Start or complete the cycle
    startcomplete
  • cycleintegeroptional
    The cycle's number
  • deletebooleanoptional
  • ends_onstringoptional
    YYYY-MM-DD
  • goalstringoptional
    Up to 500 characters
  • move_open_tostringoptional
    next, none or a cycle number
  • namestringoptional
    Up to 80 characters; "" removes it
  • projectstringrequired
    Project key
  • revintegeroptional
    Change: the rev you read
  • start_nextbooleanoptional
    Also start that cycle
  • starts_onstringoptional
    YYYY-MM-DD

Returns

  • actionstringrequired
    created, updated, unchanged, started, completed or deleted
  • clearedintegeroptional
    delete: issues taken out
  • cycleobjectrequired
  • doneintegeroptional
    complete: finished issues kept
  • movedintegeroptional
    complete: unfinished issues moved
  • moved_tostringoptional
    complete: cycle number, or none
  • startedintegeroptional
    start_next: cycle number