@lightdash/common 2.211.1 → 2.211.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/.tsbuildinfo +1 -1
- package/dist/cjs/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +25 -25
- package/dist/cjs/ee/AiAgent/schemas/defineTool.test.js +5 -1
- package/dist/cjs/ee/AiAgent/schemas/defineTool.test.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts +2 -0
- package/dist/cjs/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js +5 -0
- package/dist/cjs/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.js +1 -1
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts +2 -0
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.test.js +21 -0
- package/dist/cjs/ee/AiAgent/schemas/toolSchemaBuilder.test.js.map +1 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +56 -56
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js +7 -2
- package/dist/cjs/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolGetMetadataArgs.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js +5 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +50 -50
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +12 -0
- package/dist/cjs/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js +6 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js.map +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js +1 -1
- package/dist/cjs/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js.map +1 -1
- package/dist/cjs/ee/AiAgent/utils.d.ts +28 -28
- package/dist/cjs/schemas/json/mcp-tools-1.0.json +6 -6
- package/dist/esm/.tsbuildinfo +1 -1
- package/dist/esm/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +25 -25
- package/dist/esm/ee/AiAgent/schemas/defineTool.test.js +5 -1
- package/dist/esm/ee/AiAgent/schemas/defineTool.test.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts +2 -0
- package/dist/esm/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js +2 -0
- package/dist/esm/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.js +1 -1
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts +2 -0
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.test.js +19 -0
- package/dist/esm/ee/AiAgent/schemas/toolSchemaBuilder.test.js.map +1 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +56 -56
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js +7 -2
- package/dist/esm/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolGetMetadataArgs.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js +5 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +50 -50
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +12 -0
- package/dist/esm/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js +6 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js.map +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js +1 -1
- package/dist/esm/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js.map +1 -1
- package/dist/esm/ee/AiAgent/utils.d.ts +28 -28
- package/dist/esm/schemas/json/mcp-tools-1.0.json +6 -6
- package/dist/types/.tsbuildinfo +1 -1
- package/dist/types/ee/AiAgent/chartConfig/web/getWebAiChartConfig.d.ts +25 -25
- package/dist/types/ee/AiAgent/schemas/defineTool.test.js +5 -1
- package/dist/types/ee/AiAgent/schemas/defineTool.test.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts +2 -0
- package/dist/types/ee/AiAgent/schemas/filterExpressions/mcpGuidance.d.ts.map +1 -0
- package/dist/types/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js +2 -0
- package/dist/types/ee/AiAgent/schemas/filterExpressions/mcpGuidance.js.map +1 -0
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.js +1 -1
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts +2 -0
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.test.d.ts.map +1 -0
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.test.js +19 -0
- package/dist/types/ee/AiAgent/schemas/toolSchemaBuilder.test.js.map +1 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolDashboardV2Args.d.ts +56 -56
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js +7 -2
- package/dist/types/ee/AiAgent/schemas/tools/toolDefinitions.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolGetMetadataArgs.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js +5 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolGetMetadataArgs.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolGetQueryResultArgs.js +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolRunMetricQueryArgs.d.ts +50 -50
- package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.js +12 -0
- package/dist/types/ee/AiAgent/schemas/tools/toolRunQueryArgs.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.d.ts.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js +6 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.js.map +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js +1 -1
- package/dist/types/ee/AiAgent/schemas/tools/toolSearchFieldValuesArgs.test.js.map +1 -1
- package/dist/types/ee/AiAgent/utils.d.ts +28 -28
- package/dist/types/schemas/json/mcp-tools-1.0.json +6 -6
- package/package.json +1 -1
|
@@ -22,18 +22,31 @@ export declare const parseVizConfig: (vizConfigUnknown: object | null, maxLimit?
|
|
|
22
22
|
tableCalculations: ({
|
|
23
23
|
name: string;
|
|
24
24
|
displayName: string;
|
|
25
|
-
type: "
|
|
25
|
+
type: "percent_of_column_total";
|
|
26
26
|
fieldId: string;
|
|
27
|
-
orderBy: {
|
|
28
|
-
fieldId: string;
|
|
29
|
-
order: "asc" | "desc" | null;
|
|
30
|
-
}[];
|
|
31
27
|
partitionBy: string[] | null;
|
|
32
28
|
} | {
|
|
33
29
|
name: string;
|
|
34
30
|
displayName: string;
|
|
35
|
-
type: "
|
|
36
|
-
|
|
31
|
+
type: "window_function";
|
|
32
|
+
windowFunction: import("../..").WindowFunctionType;
|
|
33
|
+
fieldId: string | null;
|
|
34
|
+
orderBy: {
|
|
35
|
+
fieldId: string;
|
|
36
|
+
order: "asc" | "desc" | null;
|
|
37
|
+
}[] | null;
|
|
38
|
+
partitionBy: string[] | null;
|
|
39
|
+
frame: {
|
|
40
|
+
frameType: "range" | "rows";
|
|
41
|
+
start: {
|
|
42
|
+
type: "current_row" | "following" | "preceding" | "unbounded_following" | "unbounded_preceding";
|
|
43
|
+
offset: number | null;
|
|
44
|
+
} | null;
|
|
45
|
+
end: {
|
|
46
|
+
type: "current_row" | "following" | "preceding" | "unbounded_following" | "unbounded_preceding";
|
|
47
|
+
offset: number | null;
|
|
48
|
+
};
|
|
49
|
+
} | null;
|
|
37
50
|
} | {
|
|
38
51
|
name: string;
|
|
39
52
|
displayName: string;
|
|
@@ -44,7 +57,7 @@ export declare const parseVizConfig: (vizConfigUnknown: object | null, maxLimit?
|
|
|
44
57
|
} | {
|
|
45
58
|
name: string;
|
|
46
59
|
displayName: string;
|
|
47
|
-
type: "
|
|
60
|
+
type: "percent_change_from_previous";
|
|
48
61
|
fieldId: string;
|
|
49
62
|
orderBy: {
|
|
50
63
|
fieldId: string;
|
|
@@ -54,8 +67,12 @@ export declare const parseVizConfig: (vizConfigUnknown: object | null, maxLimit?
|
|
|
54
67
|
} | {
|
|
55
68
|
name: string;
|
|
56
69
|
displayName: string;
|
|
57
|
-
type: "
|
|
70
|
+
type: "percent_of_previous_value";
|
|
58
71
|
fieldId: string;
|
|
72
|
+
orderBy: {
|
|
73
|
+
fieldId: string;
|
|
74
|
+
order: "asc" | "desc" | null;
|
|
75
|
+
}[];
|
|
59
76
|
partitionBy: string[] | null;
|
|
60
77
|
} | {
|
|
61
78
|
name: string;
|
|
@@ -65,25 +82,8 @@ export declare const parseVizConfig: (vizConfigUnknown: object | null, maxLimit?
|
|
|
65
82
|
} | {
|
|
66
83
|
name: string;
|
|
67
84
|
displayName: string;
|
|
68
|
-
type: "
|
|
69
|
-
|
|
70
|
-
fieldId: string | null;
|
|
71
|
-
orderBy: {
|
|
72
|
-
fieldId: string;
|
|
73
|
-
order: "asc" | "desc" | null;
|
|
74
|
-
}[] | null;
|
|
75
|
-
partitionBy: string[] | null;
|
|
76
|
-
frame: {
|
|
77
|
-
frameType: "range" | "rows";
|
|
78
|
-
start: {
|
|
79
|
-
type: "current_row" | "following" | "preceding" | "unbounded_following" | "unbounded_preceding";
|
|
80
|
-
offset: number | null;
|
|
81
|
-
} | null;
|
|
82
|
-
end: {
|
|
83
|
-
type: "current_row" | "following" | "preceding" | "unbounded_following" | "unbounded_preceding";
|
|
84
|
-
offset: number | null;
|
|
85
|
-
};
|
|
86
|
-
} | null;
|
|
85
|
+
type: "running_total";
|
|
86
|
+
fieldId: string;
|
|
87
87
|
})[] | null;
|
|
88
88
|
filters: import("../..").Filters;
|
|
89
89
|
};
|
|
@@ -509,7 +509,7 @@
|
|
|
509
509
|
"openWorldHint": false,
|
|
510
510
|
"readOnlyHint": true
|
|
511
511
|
},
|
|
512
|
-
"description": "Call this first to discover available projects, the agents you can access in each project, and Lightdash-configured context. Pass the selected projectUuid to every project-scoped tool call and
|
|
512
|
+
"description": "Call this first to discover available projects, the agents you can access in each project, and Lightdash-configured context. Pass the selected projectUuid to every project-scoped tool call. When agent-specific scope is useful and routing is available, use route_agent and pass its returned agentUuid explicitly. If routing is unavailable or full project scope is desired, omit agentUuid; use set_agent for manual selection. This tool reports context but does not establish implicit execution state. When the session is pinned to a project, activeProject is the only allowed project. Otherwise it is a stored default, not a restriction on projectUuid. Use the project the user requested; if none was specified, use activeProject if present or ask. If the requested project is unavailable or rejected, explain rather than substitute another project.",
|
|
513
513
|
"inputSchema": {
|
|
514
514
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
515
515
|
"properties": {},
|
|
@@ -731,7 +731,7 @@
|
|
|
731
731
|
"openWorldHint": false,
|
|
732
732
|
"readOnlyHint": true
|
|
733
733
|
},
|
|
734
|
-
"description": "Tool: get_metadata\n\nPurpose:\nGet the full metadata for specific explores and/or fields that you already know the IDs of (typically from grep_fields). grep_fields is lean — it tells you WHICH fields exist; get_metadata gives you the DETAIL you need to build a correct query: an explore's joined tables, table filters, and parameters, and a field's filter type, case-sensitivity, resolved default time dimension, parameter dependencies, hints, and whether it comes from a joined table. A field marked with required parameters returns different results depending on the parameter values the query runs with — unset parameters resolve to their default.\n\nCall this AFTER grep_fields, once you have narrowed down to the explore(s) and field(s) you intend to use, and BEFORE render_chart. You can ask for several explores and several fields across explores in a SINGLE call — batch everything you need at once instead of one request per item.\n\nEach entry in `requests` is one of:\n- `{ \"type\": \"explore\", \"exploreIds\": [\"orders\", \"customers\"] }` — full metadata for those explores (joined tables, table filters, field counts).\n- `{ \"type\": \"field\", \"fields\": [{ \"exploreId\": \"orders\", \"fieldId\": \"orders_status\" }] }` — full metadata for those specific fields.\n",
|
|
734
|
+
"description": "Tool: get_metadata\n\nPurpose:\nGet the full metadata for specific explores and/or fields that you already know the IDs of (typically from grep_fields). grep_fields is lean — it tells you WHICH fields exist; get_metadata gives you the DETAIL you need to build a correct query: an explore's joined tables, table filters, required filters, and parameters, and a field's filter type, case-sensitivity, resolved default time dimension, parameter dependencies, hints, and whether it comes from a joined table. A field marked with required parameters returns different results depending on the parameter values the query runs with — unset parameters resolve to their default.\n\nCall this AFTER grep_fields, once you have narrowed down to the explore(s) and field(s) you intend to use, and BEFORE render_chart. You can ask for several explores and several fields across explores in a SINGLE call — batch everything you need at once instead of one request per item.\n\nEach entry in `requests` is one of:\n- `{ \"type\": \"explore\", \"exploreIds\": [\"orders\", \"customers\"] }` — full metadata for those explores (joined tables, table filters, field counts).\n- `{ \"type\": \"field\", \"fields\": [{ \"exploreId\": \"orders\", \"fieldId\": \"orders_status\" }] }` — full metadata for those specific fields.\n",
|
|
735
735
|
"inputSchema": {
|
|
736
736
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
737
737
|
"properties": {
|
|
@@ -1243,7 +1243,7 @@
|
|
|
1243
1243
|
"openWorldHint": false,
|
|
1244
1244
|
"readOnlyHint": true
|
|
1245
1245
|
},
|
|
1246
|
-
"description": "Poll an existing run_sql or run_metric_query query. Use the exact queryUuid returned by the query tool; never invent it. This tool retrieves results without rerunning the query.\n\nIf running, follow the response's polling instructions and call get_query_result with the same queryUuid; never resubmit the query.\nStop on terminal errors and correct the request before retrying.\n\nReturns the original query's data on completion. For a visual, call render_chart after get_query_result returns done for a metric query. SQL results cannot be rendered by render_chart.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.",
|
|
1246
|
+
"description": "Poll an existing run_sql or run_metric_query query until done, error, cancelled, or expired. Use the exact queryUuid returned by the query tool; never invent it. This tool retrieves results without rerunning the query.\n\nIf running, follow the response's polling instructions and call get_query_result with the same queryUuid; never resubmit the query.\nStop on terminal errors and correct the request before retrying.\n\nReturns the original query's data on completion. For a visual, call render_chart after get_query_result returns done for a metric query. SQL results cannot be rendered by render_chart.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.",
|
|
1247
1247
|
"inputSchema": {
|
|
1248
1248
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1249
1249
|
"properties": {
|
|
@@ -1891,7 +1891,7 @@
|
|
|
1891
1891
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
1892
1892
|
"properties": {
|
|
1893
1893
|
"page": {
|
|
1894
|
-
"description": "
|
|
1894
|
+
"description": "Paginate results starting at 1. Pass a positive number (e.g. 1), never NaN or the string \"null\".",
|
|
1895
1895
|
"exclusiveMinimum": 0,
|
|
1896
1896
|
"type": "number"
|
|
1897
1897
|
},
|
|
@@ -2370,7 +2370,7 @@
|
|
|
2370
2370
|
"openWorldHint": false,
|
|
2371
2371
|
"readOnlyHint": true
|
|
2372
2372
|
},
|
|
2373
|
-
"description": "Render a completed run_metric_query result in Lightdash's built-in chart app in MCP App-capable clients.\n\nUse when the user wants a visual. If the query is running, call get_query_result first. This tool does not start, poll or rerun queries.\nPass the exact queryUuid returned for this query by run_metric_query or get_query_result (also available in the `queryUuid: <id>` text block). Never invent an ID or reuse one from another query or session. SQL Runner/run_sql results are not supported.\n\nThe full chart payload is app metadata; structuredContent contains only a lightweight placeholder. Custom artifacts should build visuals from query data instead.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.",
|
|
2373
|
+
"description": "Render a completed run_metric_query result in Lightdash's built-in chart app in MCP App-capable clients.\n\nUse when the user wants a visual. If the query is running, call get_query_result first. This tool does not start, poll or rerun queries.\nPass the exact queryUuid returned for this query by run_metric_query or get_query_result (also available in the `queryUuid: <id>` text block). Never invent an ID or reuse one from another query or session. SQL Runner/run_sql results are not supported.\n\nSupported types: table, bar, horizontal_bar, line, scatter, pie, funnel.\n- For time series: use `line` with `xAxisType: 'time'`.\n- For categorical comparisons: use `bar` or `horizontal_bar`.\n- For single values or detailed data: use `table`.\n- Always provide axis labels.\n\nThe full chart payload is app metadata; structuredContent contains only a lightweight placeholder. Custom artifacts should build visuals from query data instead.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.",
|
|
2374
2374
|
"inputSchema": {
|
|
2375
2375
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
2376
2376
|
"properties": {
|
|
@@ -3001,7 +3001,7 @@
|
|
|
3001
3001
|
"openWorldHint": false,
|
|
3002
3002
|
"readOnlyHint": true
|
|
3003
3003
|
},
|
|
3004
|
-
"description": "Run a governed metric query through the Lightdash semantic layer. Choose an explore and its metrics and dimensions (from grep_fields / get_metadata), add filters, sorts and a limit, and get consistent, centrally defined results. This is the preferred way to answer data questions and to reproduce a saved chart's query — prefer it over raw SQL whenever the fields exist in a modeled explore. For running queries, follow the polling instructions in the response.\n\nIf any selected field is marked \"requires parameters\" in field discovery or metadata, set the right values in queryConfig.parameters — an unset parameter silently resolves to its default, which can make the query return data that does not match the question.\n\nThis tool returns metric query data only. For a visual, call render_chart after run_metric_query returns done for a metric query.\n\nIf running, follow the response's polling instructions and call get_query_result with the same queryUuid; never resubmit the query.\nStop on terminal errors and correct the request before retrying.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.\n",
|
|
3004
|
+
"description": "Run a governed metric query through the Lightdash semantic layer. Choose an explore and its metrics and dimensions (from grep_fields / get_metadata), add filters, sorts and a limit, and get consistent, centrally defined results. This is the preferred way to answer data questions and to reproduce a saved chart's query — prefer it over raw SQL whenever the fields exist in a modeled explore. For running queries, follow the polling instructions in the response.\n\nIf any selected field is marked \"requires parameters\" in field discovery or metadata, set the right values in queryConfig.parameters — an unset parameter silently resolves to its default, which can make the query return data that does not match the question.\n\nIf the user mentions any time period, add an explicit date filter; never use sort + limit instead. Use inThePast for relative windows. Date fields from joined tables work identically in filters.\n\nBefore authoring table calculations, read the `table-calculations` skill. Use type `formula`.\n\nAdd a customMetrics entry only after grep_fields / get_metadata confirm no existing metric fits.\n\nThis tool returns metric query data only. For a visual, call render_chart after run_metric_query returns done for a metric query.\n\nIf running, follow the response's polling instructions and call get_query_result with the same queryUuid; never resubmit the query.\nStop on terminal errors and correct the request before retrying.\n\nWhen building an HTML/React artifact that calls MCP, load the mcp-artifact-integration skill (read_skill with name: \"mcp-artifact-integration\") for response parsing, polling, errors and chart data. This is not needed for ordinary chat or the built-in chart app.\n",
|
|
3005
3005
|
"inputSchema": {
|
|
3006
3006
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3007
3007
|
"properties": {
|