Tools / Decisions

get_decision()

Key

The L2 drill-down for one decision: question, pinned as_of and context pack, recommendation, frozen expectation, approval trail, outcome and variance if recorded.

get_decision(decision_id)→ DECISION CARD

Callable over MCP as get_decision(decision_id). REST mirror GET /v1/decisions Planned — alpha is MCP-only

Why your agent calls it

The full card for one decision — pinned context, recommendation, frozen expectation, approvals, outcome. What an agent reads before citing a prior decision as precedent, and what a human reads in a post-mortem.

What it returns

get_decision() · The full decision card, by id.ILLUSTRATIVE

Call it from an agent

Over MCP, your agent invokes it on its own when the moment calls for it — just describe the situation. A Python SDK for headless runtimes is planned; this is what the call will look like.

agent · python sdkSDK · PLANNED — ALPHA IS MCP-ONLY

from cascadian import Cascadian

cx = Cascadian(api_key=os.environ["CASCADIAN_API_KEY"])

result = cx.get_decision(
    decision_id="dec_0142",
)

Parameters

Param	Type	Description
decision_idREQUIRED	string	The decision to load in full.

Example response

get_decision()JSON · ILLUSTRATIVE

{
  "id": "dec_0142",
  "question": "Cut the discount tier or raise onboarding spend?",
  "as_of": "2026-06-11T17:00:00Z",
  "recommendation": {
    "action": "act",
    "rationale": "margin gain outweighs the win-rate cost"
  },
  "expected_outcome": { "revenue_usd": 210000 },
  "status": "decided"
}

Related — Decisions

keyopen_decision()Open a decision and pin what is knowable now.keyrecord_recommendation()The full recommendation — expectation frozen.scopedrecord_decision()The immutable commit. Approval enforced server-side.keyrecord_outcome()Measured actuals against the frozen expectation.keypropose_learning()Queue what the variance taught — humans approve.keyreview_calibration()How good are the calls, over time and by type.