Insights
Every Insights tool, with the scope it needs, its arguments and the API operation it calls.
10 tools
Run insight adhoc reports
Changes dataatlas_insights_adhoc_reports_run
Run an ad-hoc report against a dataset without saving a definition. Provide a dataset key and a report spec; returns tabular JSON. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Run a one-off report of deals by stage without saving it.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
dataset | string | Yes | |
spec | object | Yes | Report spec: dimensions/measures/filters/dateRange/limit. |
Get insight dashboards
Read onlyatlas_insights_dashboards_get
Get one dashboard by id, including its widgets. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Show me the widgets on the delivery dashboard.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The report or dashboard id. |
List insight dashboards
Read onlyatlas_insights_dashboards_list
List the caller-visible dashboards with their widgets. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Which dashboards can I see?
Arguments
This tool takes no arguments.
Render insight dashboards
Changes dataatlas_insights_dashboards_render
Render a dashboard by id: execute every widget query and return the dashboard plus all widget results as JSON. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Render the delivery dashboard with current data.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The report or dashboard id. |
List insight datasets
Read onlyatlas_insights_datasets_list
List the reportable datasets and their dimensions/measures. Use this first to discover what can be queried before running an ad-hoc query or building a report spec. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- What datasets can I report on?
Arguments
This tool takes no arguments.
Run insight queries
Changes dataatlas_insights_queries_run
Run an ad-hoc aggregation query against a dataset and return tabular JSON (columns + rows). Tenant-scoped. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Count tasks completed per week for the last quarter.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
dataset | string | Yes | |
dimensions | array of any | No | |
measures | array of any | No | |
filters | array of any | No | |
dateRange | any | No | |
limit | integer | No |
Export insight reports
Read onlyatlas_insights_reports_export
Execute a saved report by id and return the result as CSV text (header row + data rows). Handy for spreadsheets/ETL. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Export the weekly delivery report as CSV.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The report or dashboard id. |
Get insight reports
Read onlyatlas_insights_reports_get
Get one saved report definition by id. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Show me the definition of the weekly delivery report.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The report or dashboard id. |
List insight reports
Read onlyatlas_insights_reports_list
List the caller-visible saved report definitions, one page at a time; pass the nextCursor of a page as cursor to read the next one. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- List the saved reports I can run.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "updatedAt" | "createdAt" | "name" | No | The field to sort on: updatedAt, createdAt, name. updatedAt by default. |
order | "asc" | "desc" | No | asc or desc. desc by default. |
Run insight reports
Changes dataatlas_insights_reports_run
Execute a saved report by id and return the result rows as JSON. Requires the reports:read scope.
- Scope
reports:read- Calls
- Example prompt
- Run the weekly delivery report.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The report or dashboard id. |