get_epic
One epic by id, with its reference, goal, prose, owner, priority, status, dates and colour.
Return one epic: its reference, title, goal, summary, business value, hypothesis, success metrics, owner, MoSCoW priority, status, dates and colour. Read it when a story, a commit or a conversation names an epic by reference and you need the goal and the scope it was agreed with, or to check where it stands before you move work under it.
An epic of a project the token may not see, or an epic 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 action 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
epic_id*stringUUID of the epic to fetch.
What it returns
{ "data": { "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "number": 12, "reference": "CRM-12", "title": "Loyalty tiers", "summary": "<p>Members climb silver, gold and platinum tiers by annual spend.</p>", "goal": "Reward the top fifth of members so they keep buying from the client.", "business_value": "<p>Retention of the top tier is worth more than every acquisition campaign combined.</p>", "hypothesis": "A visible next tier raises repeat purchases within a quarter.", "success_metrics": "<p>Repeat purchase rate of gold members up ten points by the second quarter after launch.</p>", "owner_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "owner_name": "Nimal Fernando", "priority": "must", "status": "approved", "starts_on": "2026-11-02", "due_on": "2027-03-31", "color": "amber", "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 epic_id, an epic of a project outside the token's scope or the person's visibility, or an epic that is not agreed read through a guest token.
TOKEN_MISSING_ABILITYtoken lacks epic:view.
How is this guide?
Last updated on