MCP Reference

cycle_list

List Cycles

Beschreibung

Lists cycles the caller can see. Cycles are per-workspace sprint windows with a monotonic number per workspace (never reused across deletions) and a status (planned / active / completed / cancelled). At most one cycle per workspace is active at a time.

Filter by workspace_id, status, or bucket (current / upcoming / past, computed from today's date). Sorted by start date ascending. Archived rows are excluded.

Zugriff

Zugriffsprofil: gated. Module: projects_tasks. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name	Typ	Pflicht	Beschreibung
`account_id`	string	Ja
`workspace_id`	string	Nein	Workspace prefix ID or key (e.g. ENG).
`status`	string	Nein
`bucket`	string	Nein	Time-window relative to today.
`limit`	integer	Nein

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string",
      "description": "Workspace prefix ID or key (e.g. ENG)."
    },
    "status": {
      "type": "string",
      "enum": [
        "planned",
        "active",
        "completed",
        "cancelled"
      ]
    },
    "bucket": {
      "type": "string",
      "enum": [
        "current",
        "upcoming",
        "past"
      ],
      "description": "Time-window relative to today."
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "cycles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Cycle prefix ID (cyc_…)."
          },
          "number": {
            "type": "integer",
            "description": "Auto-increment per workspace, monotonic across deletions."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional label; falls back to 'Cycle #<number>'."
          },
          "status": {
            "type": "string",
            "enum": [
              "planned",
              "active",
              "completed",
              "cancelled"
            ]
          },
          "starts_on": {
            "type": "string",
            "format": "date"
          },
          "ends_on": {
            "type": "string",
            "format": "date"
          },
          "workspace": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "key": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "bucket": {
            "type": "string",
            "enum": [
              "current",
              "upcoming",
              "past"
            ],
            "description": "Computed from today's date."
          }
        },
        "required": [
          "id",
          "number",
          "status",
          "starts_on",
          "ends_on",
          "workspace",
          "bucket"
        ]
      }
    }
  },
  "required": [
    "cycles"
  ],
  "type": "object"
}