AI Tools Reference

This reference provides detailed information about all available Core Tools that AI Agents can use to interact with your geospatial data. Each tool entry includes a description, required parameters, and practical example showing how natural language requests translate into tool usage.

Map Tools

These tools let the Agent control the map position as well as extract the area of interest.

get_spatial_filter

Description

Get current area of interest (viewport or drawn polygon).

Example

"What's the total revenue for stores in this region?"
Agent uses this to get the current viewport bounds for spatial filtering.

lds_geocode

Description

Convert address to coordinates.

Input properties

  • address (string): Input address to geocode.

  • country_code (string, optional): ISO 3166-1 alpha-2 country code (e.g., US, ES).

  • limit (integer, optional): Maximum number of results to return.

Example

"Show me where 123 Main Street, New York is on the map"
Agent this tool to convert the address into coordinates.

set_map_center_and_zoom

Description

Center the map at specific coordinates with a defined zoom level.

Input properties:

  • center (array): Latitude and longitude coordinates [lat, lon].

  • zoom (number): Map zoom level as defined by Google Maps.

Example

"Center the map to 43.6532, -79.3832 at zoom level 12"
Agent uses this tool to reposition the map view to the specified location.

set_map_center_and_zoom_to_layer

Description

Zoom the map view to a specific layer extent.

Input properties:

  • layerId (string): ID of the layer to frame in the viewport.

Example

"Zoom to show all the Stores"
Agent uses this to automatically frame all features in the stores layer. 

get_map_coordinates

Description

Retrieve the current map view coordinates and zoom level.

Input properties:

  • None required

Example

"What coordinates am I currently looking at?"
Agent uses this tool to retrieve  the current map center and zoom level.

Layer Tools

These tools let the Agent add, style and display layers on the map.

add_layer

Description

Visualize source data as new AI-generated layer on the map. It can generate new layers from existing sources or if query sources capability is available, it can also generate layers from AI-generated sources.

Input properties:

  • datasetId (string): The ID of the dataset to visualize.

  • label (string): Human-readable name for the layer.

  • hooverColumns (array, optional): Column names to show on hover (max 5).

  • hooverColumnsAggregation (object, optional): Aggregation methods for hover columns.

Example

"Visualize the results on the map"
Agent uses this tool to add a new layer to the map using an existing source. 

AI-generated layers are temporal to the conversation. Once the conversation is deleted or the page is refreshed, AI-generated layers are removed.

If "Query sources" capability is enabled, Agent can generated a layer from an AI-generated source rather than existing source.


set_layer_style

Description

Style AI-generated layers.

Input properties:

  • layerId (string): The ID of the layer to style.

  • opacity (number, optional): Layer transparency (0.0 to 1.0)

  • fillColor (string, optional): Hex color for fill (e.g. '#FF0000')

  • fillColorColumn (string, optional): Custom color palette.

  • radius (integer, optional): Point size in pixels.

  • radiusColumn (string, optional): Column to determine point sizes.

  • outlineColor (string, optional): Border color

  • outlineWidth (integer, optional): Border width in pixels.

Example

"Color the stores by revenue using a green to red gradient"
Agent uses this tool to apply color styling based on the revenue column. 

set_layer_visibility

Description

Control layer visibility on the map.

Input properties:

  • layers (array): Array of objects with:

    • layerId (string): The layer to control

    • visibility (boolean): Show (true) or hide (false)

    • mapIndex (number, optional): For split maps (0=left, 1=right)

Example

"Hide the competitor locations layer"
Agent uses this tool to set the competitor layer visibility to false. 

remove_layer

Description

Removes a temporal AI-generated layer.

Input properties:

  • layerId (string): The ID of the layer to be remove.

Example

"Remove the top locations layer" 
Agent uses this tool to remove the specified layer from the map. 

Widget Tools

These tools let the Agent extract widget values and use them to filter data sources on the map.

filter_category_widget

Description

Filter by categories (e.g., type, region).

Input properties:

  • widgetId (string): The ID of the widget to filter.

  • categories (array): Selected category values to filter by.

Example

"Show only stores in California and Nevada"
Agent uses this tool to filter the category widget with the selected states.

filter_histogram_widget

Description

Filter by distribution ranges.

Input properties:

  • widgetId (string): The ID of the widget to filter.

  • intervals (array): Array of [min, max] ranges.

Example

"Filter to show revenue between 100k and 500k"
Agent uses this tool to apply the specified range to the histogram widget.

filter_range_widget

Description Filter by min/max values.

Input properties:

  • widgetId (string): The ID of the widget to filter

  • range (array): [min, max] values

Example

"Show stores with 50 to 200 employees"
Agent uses this tool to filter the data within the specified range. 

get_formula_widget

Description Retrieve calculated metrics (KPIs).

Input properties:

  • widgetId (string): The ID of the widget to read

Example

"What's the total revenue shown in the dashboard?"
Agent uses this tool to retrieve the calculated value from the revenue widget. 

get_category_widget

Description Get category breakdowns.

Input properties:

  • widgetId (string): The ID of the widget to read.

Example

"What store types are available in the data?"
Agent uses this tool to retrieve the calculated value from the revenue widget. 

get_histogram_widget

Description Get distribution data.

Input properties:

  • widgetId (string): The ID of the widget to read.

Example

"Show me the revenue distribution across stores"
Agent uses this tool to retrieve histogram data showing the distribution pattern. 

get_time_series_widget

Description Get temporal patterns.

Input properties:

  • widgetId (string): The ID of the widget to read.

  • timeRange (array): [start, end] timestamps in seconds since epoch.

Example

"What were the sales trends for Q1 2024?"
Agent uses this tool to retrieve time series data for the specified period. 

Parameter Tools

These tools let the Agent update parameter values on the map.

set_sql_parameter_text

Update text parameter values.

Input properties:

  • parameterId (string): ID of the parameter to update.

  • values (array): Array of text values to set.

Example

"Filter the analysis to only premium and standard customer types"
Agent uses this tool to set the customer type parameter with the specified values. 

set_sql_parameter_date_range

Description Update date parameter values.

Input properties:

  • parameterId (string): ID of the parameter to update.

  • min (string, optional): Start date in ISO-8601 format (YYYY-MM-DD).

  • max (string, optional): End date in ISO-8601 format (YYYY-MM-DD).

Example

"Analyze data from January to March 2024"
Agent uses this tool to set the date range for the analysis period. 

set_sql_parameter_numeric

Description Update numeric parameter value.

Input properties:

  • parameterId (string): ID of the parameter to update.

  • value (number): Numeric value to set.

Example

"Set the minimum order value to 1000"
Agent uses this tool to update the numeric threshold parameter. 

set_sql_parameter_numeric_range

Description Update numeric range parameter values.

Input properties:

  • parameterId (string): ID of the parameter to update.

  • min (number, optional): Minimum value.

  • max (number, optional): Maximum value.

Example

"Show transactions between $500 and $2000"
Agent uses this tool to set both minimum and maximum values for the range. 

Data Tools

These tools let the Agent extract insights by generated SQL that is executed against your map connections. These can be used to provide insights in a conversational manner as well as for adding sources that then can be used to add AI-generated layers on the map.

add_source

Description Load data from tables or queries that can be used.

Input properties:

  • type (string): Type of source (table, tileset, query, raster).

  • source (string): Table name or SQL query.

  • connection (string): Database connection name.

  • provider (string): Database provider type.

  • geoColumn (string, optional): Column containing geometry/geography.

Example

"Display the top 5 locations to open a new store"
Agent uses this tool to add an AI-generated source that can be used to add an AI-generated layer to render insights on the mpa. 

execute_query

Description Run SQL analysis (sync mode - immediate results).

Input properties:

  • connection_name (string): Connection name to execute against

  • sql (string): The SQL query to execute (SELECT statements only)

Example

"Calculate the average revenue per store in California"
Agent uses this tool to run SQL analysis and return the results conversationally. 

remove_source

Description Remove AI-generated data sources.

Input properties:

  • datasetId (string): The ID of the dataset to remove.

Example

"Remove the added source from the map"
Agent uses this tool to clean up the AI-generated data source.

Workflows Output Tools

If a Workflows MCP Tool is provided to your Agent, your Agent automatically gets access to the following tools:

async_workflows_check_results

Description Check job status from Asynchronous Workflows execution. This is automatically invoked after async workflows execution.

Input properties:

  • jobId (string): The job Id to check status for.

Example

Agent uses this tool automatically after workflows async execution to check jobId status. No action is required by user.

async_workflows_get_results

Description Get the results from Asynchronous Workflows execution.

Input properties:

  • jobId (string): The ID of the dataset to remove.

  • connection (string): Connection name for the output table.

Example

Agent uses this tool automatically after workflows async execution to get results from executed workflows such as the output qualified table name. 

add_source_from_workflows

Description After workflows execution, this tool allows adding a new source on the map using the fully-qualified table result of Workflows, either Sync or Async modes.

Input properties:

  • source (string): The fully-qualified table name from Workflows output.

  • connection (string): Connection name for the output table.

Example

"Obtain 5 top locations to open new store"
Agent executes Workflows MCP Tool to identify top 5 locations, after obtaining the results, it can use output table name to add a new source.

Last updated

Was this helpful?