present_scenario_compare

Open the scenario-compare app for a completed comparison when the user asks to see it. Pass comparison_ref returned by compare_branches or compare_runs; optional run IDs, compare_group_id, commit SHAs, and output_name are exact-match checks. The presenter rechecks access to both persisted runs and reads the bounded server snapshot. It never starts model runs or computes a comparison. Missing or expired snapshots return an actionable error instead of recomputing. Provides view: scenario-compare (ui://apps/scenario-compare) renders this tool’s result when MCP Apps are available.

read-only

Parameters

This tool takes no parameters.

Returns

Returns a structured object. Top-level fields:

• view (string)
• checked_at (string)
• freshness (object)
• data (object)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "present_scenario_compare",
  "arguments": {
    "comparison_ref": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

Response

{
  "view": "compare_runs",
  "checked_at": "2026-04-28T10:00:00+00:00",
  "freshness": {
    "captured_at": "2026-04-28T10:00:00+00:00",
    "expires_at": "2026-04-28T10:20:00+00:00",
    "age_seconds": 0,
    "fresh": true,
    "model_name": "forecasts",
    "base_run_id": "66666666-6666-6666-6666-666666666666",
    "comparison_run_id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
    "compare_group_id": null,
    "base_commit_sha": "0123456789abcdef0123456789abcdef01234567",
    "comparison_commit_sha": "abc1234def5678901234567890abcdef12345678",
    "output_name": "revenue"
  },
  "data": {
    "comparison_ref": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "base_run_id": "66666666-6666-6666-6666-666666666666",
    "comparison_run_id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
    "model_name": "forecasts",
    "base_status": "success",
    "comparison_status": "success",
    "base_commit_sha": "0123456789abcdef0123456789abcdef01234567",
    "comparison_commit_sha": "abc1234def5678901234567890abcdef12345678",
    "output_name": "revenue",
    "diff": [
      {
        "metric": "revenue",
        "base_value": 100,
        "comparison_value": 120,
        "absolute_delta": 20,
        "pct_delta": 0.2,
        "significant": true
      }
    ],
    "summary": {
      "total_diff": 20,
      "rows_compared": 1
    }
  }
}

Notes

• Module: Scenario Comparison
• Requires an authenticated Bridge Town session (OAuth) or an API token.