query_visual
Create one read-only visual from LeapView semantic model fields. Data is queried from semantic models; do not provide inline data.
Machine-readable: focused JSON · complete manifest
Contract
| Property | Value |
|---|---|
| Authorization | RESOURCE_USE |
| Effect | read |
| Operation | manual |
| Tags | analytics, visualization |
| Defaults | {"limit":50} |
| MCP annotations | read-only, idempotent, non-destructive, closed-world |
Input schema
This closed schema is too large to inline usefully. Read the exact generated schema in the focused JSON contract.
Output schema
{
"additionalProperties": false,
"properties": {
"completeness": {
"additionalProperties": false,
"properties": {
"limit": {
"type": "integer"
},
"returnedRows": {
"type": "integer"
},
"status": {
"enum": [
"complete",
"limit_reached",
"empty"
],
"type": "string"
}
},
"required": [
"limit",
"returnedRows",
"status"
],
"type": "object"
},
"datasetId": {
"type": "string"
},
"diagnostics": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"fieldId": {
"type": "string"
},
"message": {
"type": "string"
},
"severity": {
"enum": [
"info",
"warning",
"error"
],
"type": "string"
}
},
"required": [
"code",
"message",
"severity"
],
"type": "object"
},
"type": "array"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"alias": {
"type": "string"
},
"dataType": {
"type": "string"
},
"fieldId": {
"type": "string"
},
"format": {
"type": "string"
},
"label": {
"type": "string"
},
"role": {
"enum": [
"dimension",
"series",
"metric",
"table_field",
"table_row"
],
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"fieldId",
"label",
"role"
],
"type": "object"
},
"type": "array"
},
"filters": {
"items": {
"additionalProperties": false,
"properties": {
"expression": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"unfiltered"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"operator": {
"enum": [
"isNull",
"isNotNull",
"in",
"notIn",
"equals",
"notEquals",
"contains",
"notContains",
"startsWith",
"endsWith",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual"
],
"type": "string"
},
"type": {
"enum": [
"nullCheck"
],
"type": "string"
}
},
"required": [
"operator",
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"operator": {
"enum": [
"isNull",
"isNotNull",
"in",
"notIn",
"equals",
"notEquals",
"contains",
"notContains",
"startsWith",
"endsWith",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual"
],
"type": "string"
},
"type": {
"enum": [
"set"
],
"type": "string"
},
"values": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"string"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"boolean"
],
"type": "string"
},
"value": {
"type": "boolean"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"integer"
],
"type": "string"
},
"value": {
"description": "Precision-safe integer representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"decimal"
],
"type": "string"
},
"value": {
"description": "Canonical decimal representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"date"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"timestamp"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
}
]
},
"type": "array"
}
},
"required": [
"operator",
"type",
"values"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"operator": {
"enum": [
"isNull",
"isNotNull",
"in",
"notIn",
"equals",
"notEquals",
"contains",
"notContains",
"startsWith",
"endsWith",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual"
],
"type": "string"
},
"type": {
"enum": [
"comparison"
],
"type": "string"
},
"value": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"string"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"boolean"
],
"type": "string"
},
"value": {
"type": "boolean"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"integer"
],
"type": "string"
},
"value": {
"description": "Precision-safe integer representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"decimal"
],
"type": "string"
},
"value": {
"description": "Canonical decimal representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"date"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"timestamp"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
}
]
}
},
"required": [
"operator",
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"lower": {
"additionalProperties": false,
"properties": {
"inclusive": {
"type": "boolean"
},
"value": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"string"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"boolean"
],
"type": "string"
},
"value": {
"type": "boolean"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"integer"
],
"type": "string"
},
"value": {
"description": "Precision-safe integer representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"decimal"
],
"type": "string"
},
"value": {
"description": "Canonical decimal representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"date"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"timestamp"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
}
]
}
},
"required": [
"inclusive",
"value"
],
"type": "object"
},
"type": {
"enum": [
"range"
],
"type": "string"
},
"upper": {
"additionalProperties": false,
"properties": {
"inclusive": {
"type": "boolean"
},
"value": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"string"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"boolean"
],
"type": "string"
},
"value": {
"type": "boolean"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"integer"
],
"type": "string"
},
"value": {
"description": "Precision-safe integer representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"decimal"
],
"type": "string"
},
"value": {
"description": "Canonical decimal representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"date"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"timestamp"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
}
]
}
},
"required": [
"inclusive",
"value"
],
"type": "object"
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"anchor": {
"enum": [
"currentTime",
"firstAvailable",
"lastAvailable",
"fixed"
],
"type": "string"
},
"anchorValue": {
"oneOf": [
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"string"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"boolean"
],
"type": "string"
},
"value": {
"type": "boolean"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"integer"
],
"type": "string"
},
"value": {
"description": "Precision-safe integer representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"decimal"
],
"type": "string"
},
"value": {
"description": "Canonical decimal representation.",
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"date"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"allOf": [
{
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
],
"properties": {
"type": {
"enum": [
"timestamp"
],
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
}
]
},
"count": {
"type": "integer"
},
"direction": {
"enum": [
"previous",
"current",
"next"
],
"type": "string"
},
"includeCurrent": {
"type": "boolean"
},
"type": {
"enum": [
"relativePeriod"
],
"type": "string"
},
"unit": {
"enum": [
"minute",
"hour",
"day",
"week",
"month",
"quarter",
"year"
],
"type": "string"
}
},
"required": [
"anchor",
"count",
"direction",
"includeCurrent",
"type",
"unit"
],
"type": "object"
}
]
},
"fieldId": {
"description": "Filtered semantic field.",
"type": "string"
},
"path": {
"description": "Zero-based nested group path. Omitted for a root-level filter.",
"items": {
"type": "integer"
},
"type": "array"
},
"resolvedDatasetId": {
"description": "Semantic dataset selected to resolve a conformed dimension.",
"type": "string"
}
},
"required": [
"expression",
"fieldId"
],
"type": "object"
},
"type": "array"
},
"freshness": {
"additionalProperties": false,
"properties": {
"lastSuccessfulRefreshAt": {
"description": "Completion time of the last successful publish or refresh. This is not an upstream event-time watermark.",
"type": "string"
},
"servingStateId": {
"description": "Serving state that produced the successful data version.",
"type": "string"
},
"snapshotId": {
"description": "DuckLake snapshot ID recorded for the successful data version.",
"type": "string"
},
"source": {
"description": "Whether the data version came from publish or refresh.",
"enum": [
"publish",
"refresh"
],
"type": "string"
},
"status": {
"description": "current when the successful data version belongs to the queried serving snapshot; stale otherwise.",
"enum": [
"current",
"stale"
],
"type": "string"
}
},
"required": [
"lastSuccessfulRefreshAt",
"servingStateId",
"snapshotId",
"source",
"status"
],
"type": "object"
},
"id": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"queryId": {
"type": "string"
},
"semanticModelRef": {
"additionalProperties": false,
"properties": {
"id": {
"maxLength": 256,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"type": "string"
},
"kind": {
"enum": [
"project",
"connection",
"source",
"model",
"semantic_model",
"pipeline",
"dashboard"
],
"type": "string"
}
},
"required": [
"id",
"kind"
],
"type": "object"
},
"servingSnapshot": {
"type": "string"
},
"signal": {
"type": "string"
},
"status": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"idle",
"loading",
"ready",
"no_data",
"partial",
"error"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"completeness",
"datasetId",
"diagnostics",
"fields",
"filters",
"id",
"ok",
"queryId",
"semanticModelRef",
"servingSnapshot",
"signal",
"status",
"summary",
"title",
"type"
],
"type": "object"
}