get_sprint
Fetches one sprint by id with everything the list gives and its scope, the work items it holds in the backlog's order with their status and points, plus the points planned and done.
Read one sprint in full before you pick up or add work. Beside the row list_sprints gives, the answer carries items: every work item the sprint holds, in the backlog's order, each with id, reference, title, type, status, priority, story_points and assignee_id; and points_planned and points_done, the points of all its items and of the ones done so far, so you can tell how a running sprint stands against the points it committed to. To move an item into or out of the sprint, change the item's own sprint_id with update_work_item; a sprint that is with the team for its commitment, completed or cancelled takes no more items. A client guest's token reads no sprints, so a sprint it asks for is unknown.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Annotations
It reads and never changes anything.
Arguments
sprint_id*stringUUID of the sprint to fetch.
What it returns
{ "data": { "id": "8b3f6a02-2d5c-4e9f-8c4b-7d8e9f0a1b22", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "number": 3, "name": "Sprint 3", "goal": "<p>Customers reset their password and see their orders.</p>", "starts_on": "2026-11-09", "ends_on": "2026-11-22", "duration_days": 14, "days_left": 9, "status": "active", "capacity_points": 21, "capacity_hours": 160, "committed_points": 21, "completed_points": null, "velocity": null, "retrospective": null, "item_count": 2, "points_planned": 8, "points_done": 5, "items": [ { "id": "4f1c2d3e-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "reference": "CRM-142", "title": "Reset a forgotten password", "type": "story", "status": "done", "priority": "high", "story_points": "5", "assignee_id": "3f8a1c2e-7b4d-4e5f-9a6b-1c2d3e4f5a6b" }, { "id": "5a2d3e4f-6b7c-4d8e-9f0a-1b2c3d4e5f60", "reference": "CRM-143", "title": "See my orders", "type": "story", "status": "in_progress", "priority": "medium", "story_points": "3", "assignee_id": null } ], "started_by": "3f8a1c2e-7b4d-4e5f-9a6b-1c2d3e4f5a6b", "starter_name": "Pat Manager", "started_at": "2026-11-09T09:00:00+00:00", "closed_by": null, "closer_name": null, "closed_at": null, "version": 1, "approved_at": "2026-11-09T09:00:00+00:00", "approved_revision_id": "0e1f2a3b-4c5d-4e6f-8a7b-9c0d1e2f3a4b", "created_at": "2026-11-03T08:00:00+00:00", "updated_at": "2026-11-09T09:00:00+00:00" }}How it fails
RESOURCE_NOT_FOUNDunknown sprint_id, a sprint of a project outside the token's scope, or a client guest's token.
FORBIDDENthe holder's role on the project does not carry sprint:view.
TOKEN_MISSING_ABILITYtoken lacks sprint:view.
How is this guide?
Last updated on