MCP tool reference
Cycles
MCP tools for cycles.
Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.
list_cycles
List cycles for a team. The active one has isActive=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
team | string | yes | Team key or id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
create_cycle
Create a cycle for a team. Defaults: starts now, length from team settings.
| Parameter | Type | Required | Description |
|---|---|---|---|
team | string | yes | Team key or id |
name | string | no | |
startsAt | string | no | ISO datetime |
endsAt | string | no | ISO datetime |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
update_cycle
Update a cycle's name or dates. Only provided fields change.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Cycle id |
name | string | null | no | Cycle name, or null to clear |
startsAt | string | no | ISO datetime or YYYY-MM-DD |
endsAt | string | no | ISO datetime or YYYY-MM-DD |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
delete_cycle
Delete a cycle.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Cycle id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |