get_requirement
One requirement by id, with its reference, kind, category, statement, rationale, source, priority, measure, verification method, status and owner.
Return one requirement: its reference, kind, the category and the measure of a non-functional one, title, statement, rationale, the stakeholder and the words it came from, MoSCoW priority, how it will be shown to be met, status and owner. Read it when a story, a test case or a conversation names a requirement by reference and you need the exact sentence the client agreed, or to check where it stands before you build against it.
A requirement of a project the token may not see, or a draft 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
requirement_id*stringUUID of the requirement to fetch.
What it returns
{ "data": { "id": "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "type": "functional", "number": 12, "reference": "CRM-FR-12", "category": null, "title": "Password reset by email", "statement": "<p>The system shall let a member reset their password from the sign-in page by email.</p>", "rationale": "<p>Support spends an hour a day resetting passwords by hand.</p>", "source_stakeholder_id": "d6e7f8a9-b0c1-4d2e-9f3a-4b5c6d7e8f90", "source_stakeholder_name": "Amal Jayasuriya", "source": "Discovery workshop, 14 October", "priority": "must", "measure": null, "verification_method": "demonstration", "status": "approved", "owner_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "owner_name": "Nimal Fernando", "position": 0, "version": 0, "approved_at": "2026-11-05T15:00:00+00:00", "approved_revision_id": null, "created_at": "2026-10-28T09:20:00+00:00", "updated_at": "2026-11-05T15:00:00+00:00" }}How it fails
RESOURCE_NOT_FOUNDunknown requirement_id, a requirement of a project outside the token's scope or the person's visibility, or a draft read through a guest token.
TOKEN_MISSING_ABILITYtoken lacks requirement:view.
How is this guide?
Last updated on