get_work_item
One work item by id, with its reference, kind, title, prose, status, priority, people, estimates, the fields its kind adds, the components it touches and its acceptance criteria in order.
Return one work item: its reference, kind, title, description, status and resolution, priority, the people on it, its estimates and dates, the fields its kind adds (a story's persona and sentence, a bug's severity, environment, reproduction and results, a spike's time box and outcome), the ids of the components it touches and its acceptance criteria in order, each with its kind and its Given, When and Then. Read it before you implement, test or review an item, so the criteria and the expected behaviour are in front of you, and read the epic it hangs under with get_epic for the goal.
An item of a project the token may not see, or an item that is not agreed read through a guest token, is unknown rather than forbidden.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same actions as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
work_item_id*stringUUID of the work item to fetch.
What it returns
{ "data": { "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "number": 142, "reference": "CRM-142", "type": "story", "parent_id": null, "epic_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "title": "Tier upgrade email", "description": "<p>Tell a member they reached the next tier the day it happens.</p>", "status": "in_progress", "resolution": null, "priority": "high", "assignee_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "assignee_name": "Nimal Fernando", "reporter_id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70", "reporter_name": "Dilani Perera", "reviewer_id": null, "qa_owner_id": null, "story_points": "5", "estimate_minutes": null, "remaining_minutes": null, "due_on": "2026-11-20", "started_at": "2026-11-02T09:00:00+00:00", "completed_at": null, "persona_id": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a81", "as_a": "gold member", "i_want": "to be told the day I reach platinum", "so_that": "I use the new perks straight away", "business_value_points": 8, "severity": null, "environment_id": null, "component_id": null, "steps_to_reproduce": null, "expected_result": null, "actual_result": null, "reproducible": null, "timebox_minutes": null, "outcome": null, "component_ids": ["f6a7b8c9-d0e1-4f2a-8b3c-4d5e6f7a8b92"], "acceptance_criteria": [ { "id": "a7b8c9d0-e1f2-4a3b-8c4d-5e6f7a8b9c03", "work_item_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "position": 0, "title": "A member who crosses the platinum threshold gets the email within the hour", "given": "a gold member whose annual spend crosses the platinum threshold", "when": "the nightly tier job runs", "then": "the tier upgrade email is sent within the hour", "kind": "functional", "verified_at": null, "verified_by": null } ], "position": 3, "version": 0, "approved_at": null, "created_at": "2026-10-28T09:20:00+00:00", "updated_at": "2026-11-02T09:00:00+00:00" }}How it fails
RESOURCE_NOT_FOUNDunknown work_item_id, an item of a project outside the token's scope or the person's visibility, or an item that is not agreed read through a guest token.
TOKEN_MISSING_ABILITYtoken lacks work-item:view.
How is this guide?
Last updated on