get_business_rule
One business rule by id, with its reference, name, kind, statement, condition and action, exceptions, worked examples, authority, priority, dates in force, status and owner.
Return one business rule: its reference, name, kind, the rule in plain words, when it applies and what follows, the exceptions, the worked examples in order, the stakeholder and the words its authority rests on, MoSCoW priority, the dates it is in force, status and owner. Read it when a story, a requirement or a conversation names a rule by reference and you need the exact decision the business made, with its examples, before you code the calculation or write the test.
A rule 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
business_rule_id*stringUUID of the business rule to fetch.
What it returns
{ "data": { "id": "d5e6f7a8-b9c0-4d1e-8f2a-3b4c5d6e7f80", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "number": 7, "reference": "CRM-BR-7", "name": "Platinum tier threshold", "type": "inference", "statement": "<p>A member whose spend over the last twelve months reaches 5,000 is a platinum member.</p>", "condition": "When a member's rolling twelve-month spend reaches 5,000", "action": "then the member moves to the platinum tier on the first of the next month", "exceptions": "<p>Spend refunded within thirty days does not count.</p>", "examples": [ { "input": "Spend 4,999 on 30 November", "expected": "Stays gold" }, { "input": "Spend 5,000 on 30 November", "expected": "Platinum from 1 December" } ], "authority_stakeholder_id": "d6e7f8a9-b0c1-4d2e-9f3a-4b5c6d7e8f90", "authority_stakeholder_name": "Amal Jayasuriya", "authority": "Loyalty programme terms, section 4", "priority": "must", "effective_from": "2027-01-01", "effective_to": null, "status": "approved", "owner_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "owner_name": "Nimal Fernando", "position": 6, "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 business_rule_id, a rule 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 business-rule:view.
How is this guide?
Last updated on