present_query_data_grid

Open one saved data result in the query-data-grid app when a visual view is requested or materially useful. Use view=‘query_data’ with query_result_ref from query_data, or view=‘list_data_sources’ with source_listing_ref from list_data_sources. The reference resolves to server-owned rows, schema, and source provenance. The presenter rechecks the current principal, workspace/model grant, and each referenced source. Provides view: query-data-grid (ui://apps/query-data-grid) renders this tool’s result when MCP Apps are available.

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_query_data_grid",
  "arguments": {
    "view": "query_data",
    "result_ref": "opaque-result-reference-from-query_data"
  }
}

Response

{
  "view": "query_data",
  "checked_at": "2026-04-28T10:00:00+00:00",
  "freshness": {
    "captured_at": "2026-04-28T10:00:00+00:00",
    "expires_at": "2026-04-28T10:05:00+00:00",
    "age_seconds": 12,
    "fresh": true,
    "model_name": "forecasts",
    "source_count": 1,
    "presentation_truncated": false
  },
  "data": {
    "columns": [
      "month",
      "revenue"
    ],
    "column_types": [
      "DATE",
      "DECIMAL(18, 2)"
    ],
    "rows": [
      [
        "2026-01-01",
        100.0
      ],
      [
        "2026-02-01",
        110.0
      ],
      [
        "2026-03-01",
        121.0
      ]
    ],
    "row_count": 3,
    "truncated": false,
    "next_cursor": null,
    "sources": [
      {
        "source_name": "actuals",
        "source_type": "parquet",
        "tables": [
          "actuals"
        ],
        "snapshot_taken_at": null,
        "snapshot_age_seconds": null,
        "data_source_id": "88888888-8888-8888-8888-888888888888",
        "source_updated_at": "2026-04-28T10:00:00+00:00"
      }
    ],
    "workspace_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  }
}

Notes

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