Mapbox is a platform that provides mapping, navigation, and location data services for developers to integrate into their applications.
Mapbox is a platform that provides mapping, navigation, and location data services for developers to integrate into their applications. On Nagent, Mapbox is exposed as a fully-configurable developer tools integration that any agent can call — 32 actions, and API key authentication. No code is required to wire Mapbox into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Mapbox to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Mapbox into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Mapbox, with input parameters and output schema. Drop these into any step of an agent built in Helix.
MAPBOX_GEOCODE_BATCH_V6Tool to perform batch geocoding with up to 1000 queries in a single request. Use when you need to geocode multiple locations efficiently (forward, reverse, or structured). Supports mixing query types in the same batch.
Input parameters
Array of geocoding queries (1-1000 queries). Each query can be forward, reverse, or structured geocoding.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODE_FORWARD_V5Tool to search for places by name or address using Mapbox Geocoding v5 API (forward geocoding). Use when you need to convert place names or addresses to geographic coordinates using the v5 endpoint.
Input parameters
Bounding box to limit results. Format: minLon,minLat,maxLon,maxLat
Maximum number of results (max 10).
Filter by feature types (country, region, place, address, etc.).
ISO 3166 alpha 2 country codes, comma-separated.
Include routable point metadata for addresses.
Either 'mapbox.places' or 'mapbox.places-permanent'. Use mapbox.places for user-triggered queries, mapbox.places-permanent for batch/permanent geocoding.
IETF language tags, comma-separated.
Include building entrance data (public preview).
Bias results near coordinates. Format: longitude,latitude or 'ip'
Geopolitical perspective (ar, cn, in, jp, ru, tr, us, etc.).
Allows approximate matching.
The feature to look up (address, city, etc.). URL-encoded UTF-8, no semicolons, max 20 words, max 256 characters.
Returns results starting with query string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODING_BATCHTool to perform batch forward or reverse geocoding for multiple locations. Use when you need consistent geocoding of up to 50 queries in one call.
Input parameters
Bounding box to restrict results: minLon,minLat,maxLon,maxLat.
Maximum number of results per query (1–10).
Comma-separated list of feature types to limit results.
Filter results to one or more ISO 3166 alpha-2 country codes (comma-separated).
List of search text strings for forward geocoding (up to 50 entries).
Include routable point metadata for address features.
IETF language tag(s) for returned text (comma-separated).
Bias results toward a geographic location: lon,lat or 'ip'.
Viewworld to bias results (e.g., 'us', 'cn').
List of \[lon, lat\] pairs for reverse geocoding (up to 50 entries).
Whether to allow approximate string matching (forward only; default true).
Whether to return autocomplete results (forward only; default true).
Reverse geocoding mode: 'distance' or 'score' (reverse only).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODING_FORWARDTool to convert free-form or structured address into geographic coordinates and place features. Use when you need forward geocoding from text or address components.
Input parameters
Free-form search text (URL-encoded, ≤256 chars, ≤20 tokens, no semicolons). Required if no structured fields are provided.
Limit results to a bounding box: 'minLon,minLat,maxLon,maxLat'.
Block component (used in some countries like Japan).
Maximum number of results (default 5, max 10).
City or municipality component for structured input.
Comma-separated filter of feature types: country, region, postcode, district, place, locality, neighborhood, street, address.
Response format: 'geojson' (default) or 'v5' for backward compatibility.
State or region component for structured input.
Street name component for structured input.
ISO 3166-1 alpha-2 country code or full country name for structured input, or comma-separated list of codes to filter results.
Comma-separated IETF language tags affecting response text and ranking.
Postal code component for structured input.
Whether results may be stored permanently (default false).
Bias results to this 'lon,lat' or 'ip' for IP-based biasing.
Boundary worldview for results (default 'us').
Return autocomplete results (default true).
Combined house number and street name for structured input.
House number component for structured input.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODING_PERMANENT_FORWARDTool to perform permanent forward geocoding. Use when you need enterprise-grade permanent geocoding after confirming account privileges.
Input parameters
Limit results to bounding box: minLon,minLat,maxLon,maxLat; cannot cross 180th meridian.
Maximum number of results to return (1-10).
Comma-separated list of feature types: country,region,postcode,district,place,locality,neighborhood,address.
Comma-separated ISO 3166-1 alpha-2 country codes to limit results.
Request routable points metadata for address features.
Comma-separated IETF language tags (up to 20 unique) controlling language of results.
Bias results toward this location: 'lon,lat' or 'ip'.
Return features according to worldview; one of ar,cn,in,jp,ma,rs,ru,tr,us.
Allow approximate (fuzzy) matching.
URL-encoded UTF-8 search text (max 256 chars, max 20 tokens, no semicolons).
Include autocomplete results that start with the query string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODING_PERMANENT_REVERSETool to perform permanent reverse geocoding. Use after obtaining coordinates to get cacheable place data. Example: lon=-73.989, lat=40.733
Input parameters
Max number of results; default=1; max=10. If >1, must specify exactly one types value.
Filter by one or more feature types: country, region, postcode, district, place, locality, neighborhood, address.
Limit results to one or more countries; comma-separated ISO 3166-1 alpha-2 codes.
If true, include navigation metadata for address features; adds 'routable_points'.
IETF language tags (ISO 639-1 + optional subtags); comma-separated; up to 20 unique values.
Latitude in decimal degrees for the coordinate pair.
Longitude in decimal degrees for the coordinate pair.
Regional/political boundary perspective. One of: ar, cn, in, jp, ma, rs, ru, tr, us.
Sorting when multiple results requested: 'distance' (closest first, default) or 'score' (prominence based).
Mapbox access token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GEOCODING_REVERSETool to reverse geocode coordinates into place names. Use after obtaining coordinates.
Input parameters
Maximum number of results to return; default 1, max 10. If >1, exactly one 'types' value must be set.
Comma-separated feature types to include. Options: country, region, postcode, district, place, locality, neighborhood, address.
ISO 3166-1 alpha-2 country codes to limit results, comma-separated.
Include metadata for recommended navigation destination; only applicable for address features.
IETF BCP 47 language tags, comma-separated, controlling response language.
Latitude of the location to reverse geocode.
Longitude of the location to reverse geocode.
Boundary worldview for disputed areas; one of ar, cn, in, jp, ma, rs, ru, tr, us.
Sort strategy when multiple results requested; 'distance' (default) or 'score'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_ACCESS_TOKENTool to extract and validate Mapbox access token from connection metadata. Use when you need a valid token for downstream actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_ISOCHRONETool to calculate areas reachable within a specified amount of time or distance from a location. Use when you need to visualize travel time or distance zones for routing analysis.
Input parameters
Removes smaller contours. Range: 0.0-1.0, default: 1.0.
Comma-separated exclusions: 'motorway', 'toll', 'ferry', 'unpaved', 'cash_only_tolls'. Available only for driving profiles.
Routing profile: 'mapbox/driving-traffic', 'mapbox/driving', 'mapbox/walking', or 'mapbox/cycling'.
Return GeoJSON polygons (true) or linestrings (false, default).
ISO 8601 formatted timestamp for traffic-aware routing (YYYY-MM-DDThh:mm:ssZ). Example: '2024-12-01T09:00:00Z'.
Douglas-Peucker generalization tolerance in meters (positive floating-point number).
Longitude,latitude coordinate pair around which to center the isochrone lines (e.g., '-118.22258,33.99038').
Comma-separated hexadecimal color codes without # prefix (e.g., 'ff0000,00ff00,0000ff'). Must match the quantity of contours.
Comma-separated list of 1-4 distance values in meters (1-100000) in increasing order. Required if contours_minutes is not provided. Example: '1000,2000,3000'.
Comma-separated list of 1-4 time values in minutes (1-60) in increasing order. Required if contours_meters is not provided. Example: '5,10,15'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_MAP_MATCHINGTool to snap fuzzy GPS traces to roads on the road network. Use when you need to clean up inaccurate location traces for display or analysis.
Input parameters
Remove clusters and provide uniform sample rate to improve match quality.
Include turn-by-turn instructions in the response.
Routing profile: mapbox/driving, mapbox/driving-traffic, mapbox/walking, or mapbox/cycling.
Semicolon-separated maximum snap distances in meters (0-50) for each coordinate. Use 'unlimited' for no limit.
Response geometry format: geojson, polyline, or polyline6 (default: polyline).
Semicolon-separated Unix timestamps (in seconds) corresponding to each coordinate, used to improve matching.
Comma-separated list of additional metadata: distance, duration, speed, congestion.
Semicolon-separated longitude,latitude coordinate pairs (2-100 coordinates). Format: lon1,lat1;lon2,lat2;lon3,lat3
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_OPTIMIZATION_V1Tool to calculate optimal driving routes and trips that visit a set of waypoints. Use when you need to find the best order to visit multiple locations with optimized routing.
Input parameters
Include turn-by-turn step instructions.
Starting waypoint: 'any' allows any coordinate as start, 'first' uses first coordinate.
Routing profile: driving-traffic, driving, walking, or cycling.
Semicolon-separated bearing pairs (angle,degrees) to influence direction. Requires radiuses parameter.
Language for instructions (requires steps=true).
Level of overview geometry detail.
Semicolon-separated snap distances in meters per coordinate, or 'unlimited' for any distance.
Return to starting point (default true). If false, requires source=first and destination=last.
Semicolon-separated approach sides for waypoints: 'unrestricted' or 'curb'. Requires steps=true.
Format of route geometry in response.
Return metadata annotations (duration, distance, speed). Requires overview=full.
Ordered list of 2–12 longitude/latitude waypoints for optimization.
Ending waypoint: 'any' allows any coordinate as end, 'last' uses last coordinate.
Semicolon-separated pick-up/drop-off pairs as coordinate indices (e.g., '0,1;2,3'). Max 25 per request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_SPRITETool to retrieve a sprite image or its JSON document from a Mapbox style. Use when you need sprite assets for rendering map icons. Sprites are collections of small icons used in map styles. The JSON format returns metadata about icon positions and dimensions within the sprite sheet, while the PNG format returns the actual image. Sprite sheets optimize performance by combining multiple icons into a single image.
Input parameters
Scale factor for high-density displays. Use '' (standard) for 1x resolution, '@2x' for 2x retina displays, or '@3x' for 3x displays. Only applicable for high-DPI screens.
Return format: 'json' returns sprite metadata with icon positions and dimensions, 'png' returns the actual sprite image.
The ID of the style to which the sprite belongs. Common Mapbox styles include: 'streets-v12', 'dark-v11', 'light-v11', 'satellite-v9', 'outdoors-v12'.
The username of the account to which the style belongs. Use 'mapbox' for official Mapbox styles like 'streets-v12', 'dark-v11', 'light-v11', 'satellite-v9'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_STATIC_IMAGERequest a static map image from a Mapbox Studio style. Returns a PNG or JPEG image of the specified map area with customizable parameters including location, zoom level, camera angle, and optional overlays like markers or GeoJSON features. Use when you need to generate static map images for embedding in documents, emails, or web pages without interactive map functionality.
Input parameters
Latitude coordinate for the center of the map image, must be between -85.0511 and 85.0511 (Web Mercator limits).
Longitude coordinate for the center of the map image, must be between -180 and 180.
Zoom level for the map, must be between 0 (world view) and 22 (maximum detail).
Camera pitch (tilt) in degrees, must be between 0 (looking straight down) and 60 (maximum tilt). Default is 0.
Image width in pixels, must be between 1 and 1280.
Image height in pixels, must be between 1 and 1280.
Request a retina (@2x) resolution image. When true, returns an image with double the specified width and height for high-DPI displays. Default is false.
Camera bearing (rotation) in degrees, must be between 0 and 359. Default is 0 (north-up).
Optional overlay to add to the map, such as GeoJSON features, markers, paths, or polygons. Must be properly URL-encoded. Examples: markers (pin-s-l+f00(lon,lat)), GeoJSON (geojson({...})), paths (path-5+f00-0.5(...)).
Unique identifier of the style to use for the map. Common Mapbox styles include: 'streets-v12' (detailed street map), 'dark-v11' (dark theme), 'light-v11' (light theme), 'satellite-v9' (satellite imagery), 'outdoors-v12' (topographic), 'navigation-day-v1', 'navigation-night-v1'.
Mapbox account username that owns the style. Use 'mapbox' for official Mapbox styles like 'streets-v12', 'dark-v11', 'light-v11', 'satellite-v9'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_STATIC_TILESTool to retrieve raster tiles from a Mapbox Studio style. Use when you need map tiles for specific coordinates and zoom levels. Returns PNG or JPG raster tiles that can be assembled to create map visualizations. Tiles follow the XYZ tiling scheme where the world is divided into a grid at each zoom level. Supports retina/high-DPI displays via the @2x suffix.
Input parameters
Tile X coordinate at the specified zoom level. Valid range depends on zoom level (0 to 2^z - 1).
Tile Y coordinate at the specified zoom level. Valid range depends on zoom level (0 to 2^z - 1).
Zoom level for the tile. Valid range is 0 to 22, where 0 is the most zoomed out (world view) and 22 is the most zoomed in.
If true, return high-DPI/retina display tile (@2x). This doubles the resolution of the returned tile.
The ID of the style. Common styles include 'satellite-v9' (satellite imagery), 'streets-v12' (detailed streets), 'dark-v11' (dark theme), 'light-v11' (light theme), 'outdoors-v12' (topographic).
Size of the returned raster tile in pixels. Must be one of: 256 or 512. Default is 512.
The username of the style owner. Use 'mapbox' for official Mapbox styles.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_TOKENTool to retrieve information about a Mapbox access token and validate its status. Use when you need to check token validity or retrieve token metadata.
Input parameters
The access token to retrieve and validate. Must be a valid Mapbox token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_GET_VECTOR_TILESTool to retrieve vector tiles from Mapbox-hosted vector tilesets. Use when you need tile data for mapping applications at specific zoom levels and coordinates.
Input parameters
The x-coordinate of the tile
The y-coordinate of the tile
The zoom level for the tile (0-22)
Optional style URL to optimize vector tiles for a specific style
The file format for the tile (mvt for Mapbox Vector Tile format, vector.pbf for legacy format, pbf for protocol buffer format)
The identifier for the Mapbox-hosted vector tileset (e.g., mapbox.mapbox-streets-v8)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_POST_MAP_MATCHINGTool to snap GPS coordinates to the road network using POST method for longer coordinate lists. Use when you have GPS traces to match to roads (2-100 coordinates).
Input parameters
Remove clusters and resample traces for smoother matching.
Include turn-by-turn instructions in response.
Comma-separated restrictions to ignore: access, oneways, restrictions.
Routing profile: mapbox/driving, mapbox/driving-traffic, mapbox/walking, or mapbox/cycling.
Language code for instructions (requires steps=true).
Level of geometry detail: full, simplified (default), or false.
Semicolon-separated max snap distances in meters per coordinate (0-50, use 'unlimited' for no limit).
ISO 8601 departure time for traffic-aware routing (requires driving-traffic profile).
Semicolon-separated zero-based indices of coordinates to treat as waypoints.
Semicolon-separated approach sides per waypoint: 'unrestricted' or 'curb'.
Format of route geometry: geojson, polyline (default), or polyline6.
Semicolon-separated Unix timestamps matching each coordinate for time-based matching.
Comma-separated metadata to include: distance, duration, speed, congestion, maxspeed. Requires overview=full.
Semicolon-separated longitude,latitude pairs (2-100 coordinates). Example: '-117.17282,32.71204;-117.17288,32.71225'
OpenLR specification format: tomtom (default) or here.
Unit system for voice instructions: imperial, british_imperial, or metric.
Mapbox access token for authentication.
Binary format for OpenLR: tomtom (default).
Semicolon-separated custom names for waypoints.
Emit separate instructions for roundabout entry and exit.
Return OpenLR location references for matched segments.
Return SSML voice guidance instructions.
Return banner instruction objects (requires steps=true).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_QUERY_TILE_FEATURESTool to retrieve data about specific features from vector tilesets based on a location. Use when you need to query tileset features at a geographic point, such as finding buildings, roads, or points of interest near coordinates.
Input parameters
Latitude coordinate to query.
Longitude coordinate to query.
Comma-separated list of band names for filtering rasterarray tileset results.
Number of features to return, between 1 and 50. Default is 5.
Whether to de-duplicate features by ID. Default is true.
Comma-separated list of layer IDs to query. If not specified, queries all layers.
Approximate distance in meters to query for features. Default is 0 for point-in-polygon queries.
Filter by feature geometry type. If not specified, queries all geometry types.
The tileset ID to query (e.g., 'mapbox.mapbox-streets-v8'). Can be comma-separated list for compositing.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_REQUEST_STYLE_EMBED_HTMLRetrieve embeddable HTML for a Mapbox style that can be embedded in an iframe. Returns a complete HTML document with Mapbox GL JS code that renders an interactive map with the specified style. Useful for quickly embedding Mapbox maps into web pages without custom JavaScript code.
Input parameters
Display a title box at the bottom of the map: 'copy' shows a button to copy the style to your account, 'view' shows a sign-up button. Leave null to hide the title box.
Style ID for which to return the embeddable HTML. Common Mapbox styles include streets-v12, satellite-streets-v12, outdoors-v12, light-v11, and dark-v11.
Serve a fallback raster map (true) or not (false).
Mapbox account username that owns the style. Use 'mapbox' for Mapbox's standard public styles like streets-v12, satellite-v9, etc.
Enable mouse-wheel zoom (true) or disable (false).
Specific version of Mapbox GL JS library to use (e.g., '3.0.0'). Leave null to use the default latest stable version.
Specific version of the Mapbox GL Geocoder plugin for the search box (e.g., '5.0.0'). Leave null to use the default version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_DIRECTIONSTool to retrieve directions between waypoints. Use when you need navigation routes with optional turn-by-turn instructions after confirming origin and destination.
Input parameters
Include turn-by-turn step instructions.
Routing profile: driving-traffic, driving, walking, or cycling.
Language for instructions (requires steps=true).
Level of overview geometry detail.
Format of route geometry in response.
Ordered list of 2–25 longitude/latitude waypoints.
Mapbox access token for authentication.
Return up to two alternative routes if available.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_FONT_GLYPH_RANGESTool to retrieve font glyph ranges as PBF tiles. Use when you have confirmed the font name, codepoint range, and valid token.
Input parameters
End of codepoint range; must equal start + 255
Font name or comma-separated list (max 10 faces)
Start of codepoint range; must be a multiple of 256
Mapbox account username that owns the font
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_MARKERTool to retrieve a standalone marker image without any background map. Returns a PNG image file of the specified marker type. Use when you need to obtain marker icons for display or reference purposes.
Input parameters
The marker type identifier. Common values: 'pin-s' (small pin), 'pin-m' (medium pin), 'pin-l' (large pin). The marker name determines the size and style of the marker image.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_MATRIXRetrieve a travel time and distance matrix between multiple locations. Use this tool when you need to calculate travel times and/or distances between many origin-destination pairs efficiently (e.g., comparing routes from multiple starting points to multiple destinations, finding the nearest location from a set, or optimizing multi-stop routing). Returns matrices showing durations (in seconds) and distances (in meters) between all coordinate pairs.
Input parameters
Transportation mode for routing: 'mapbox/driving' (car), 'mapbox/walking' (pedestrian), 'mapbox/cycling' (bicycle), or 'mapbox/driving-traffic' (car with live traffic, max 10 coords).
Which coordinates to use as origins (starting points). Use 'all' (default) for all coordinates, or semicolon-separated 0-based indices (e.g., '0;2;4' for coords at index 0, 2, and 4).
Semicolon-separated 'angle,deviation' pairs per waypoint; angle 0–360, deviation in degrees; skip with ';'.
BETA: desired departure time in ISO 8601 format (e.g., YYYY-MM-DDThh:mm:ssZ).
Semicolon-separated list per waypoint: 'unrestricted' or 'curb'. Count must match number of coordinates; skip entries with ';'.
Data to return in the matrix: 'duration' (travel time in seconds), 'distance' (travel distance in meters), or 'duration,distance' (both). Default: 'duration'.
List of 2-25 geographic points (longitude, latitude pairs). The API calculates travel times/distances between these points. Maximum 10 for 'mapbox/driving-traffic' profile.
Mapbox access token (optional; auto-provided by auth).
Which coordinates to use as destinations (ending points). Use 'all' (default) for all coordinates, or semicolon-separated 0-based indices (e.g., '1;3;5' for coords at index 1, 3, and 5).
Speed in km/h for straight-line distance estimates when no routable path exists between points (e.g., across water). Must be > 0 if specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_SEARCHBOX_PLACETool to retrieve full details for a specific place by its Mapbox ID. Use when you have a mapbox_id from a search suggestion and need complete place information.
Input parameters
IETF language tag or comma-separated list of language codes to specify the language for results.
The Mapbox ID of the feature to retrieve, obtained from a /suggest endpoint response.
Session token to group requests together for billing purposes (UUID format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_STYLERetrieves the complete Mapbox style specification as JSON, including all layers, sources, sprites, and configuration. A Mapbox style defines how a map is rendered, including data sources, layer styling, fonts, and sprites. This action returns the full style specification conforming to the Mapbox Style Specification, which can be used with Mapbox GL JS, mobile SDKs, or for analyzing map configurations. Use this action when you need to: - Inspect or analyze a map style's configuration - Retrieve style definitions for programmatic rendering - Examine layers, sources, and styling rules - Get complete style specifications for custom map implementations
Input parameters
Unique identifier of the style to retrieve. Common Mapbox styles include: 'streets-v12' (detailed street map), 'dark-v11' (dark theme), 'light-v11' (light theme), 'satellite-v9' (satellite imagery), 'outdoors-v12' (topographic), 'navigation-day-v1', 'navigation-night-v1'.
Mapbox account username that owns the style. Use 'mapbox' for official Mapbox styles like 'streets-v12', 'dark-v11', 'light-v11', 'satellite-v9'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_STYLE_WMTSRetrieve a WMTS (Web Map Tile Service) capabilities document for a Mapbox style. This action returns an OGC-compliant WMTS XML document that describes how to access map tiles for the specified style. The document includes tile matrix sets, supported coordinate systems (EPSG:3857), and tile URL templates. Use this when integrating Mapbox styles with desktop GIS applications (ArcGIS, QGIS, CARTO, Tableau) or any WMTS-compliant mapping client. The WMTS endpoint works with both Mapbox's official styles (e.g., streets-v12, satellite-v9) and custom styles created in Mapbox Studio.
Input parameters
Style ID for which to return the WMTS document. Common Mapbox styles include: streets-v12 (vector streets), satellite-v9 (raster satellite imagery), outdoors-v12 (outdoor/terrain), dark-v11, light-v11, and navigation-day-v1.
Mapbox account username that owns the style. Use 'mapbox' for Mapbox's official styles like streets-v12, satellite-v9, or outdoors-v12.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_RETRIEVE_TILESET_METADATATool to retrieve metadata for a Mapbox tileset. Use when you need TileJSON details including bounds, zooms, and layer info.
Input parameters
If true, return HTTPS URLs in the TileJSON 'tiles' array.
Tileset identifier in the format 'username.tilesetid'. For multiple tilesets, provide a comma-separated list (max 15).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_REVERSE_GEOCODE_V6Tool to convert geographic coordinates to place names using Geocoding v6 API. Use when you need to perform reverse geocoding from latitude/longitude coordinates.
Input parameters
Comma-separated filter of feature types: country, region, postcode, district, place, locality, neighborhood, street, address.
Filter results by ISO 3166-1 alpha-2 country codes, comma-separated.
Specify the IETF BCP 47 language tag for results, comma-separated.
The latitude coordinate of the location to reverse geocode.
The longitude coordinate of the location to reverse geocode.
Specify the worldview for disputed boundaries: ar, cn, in, jp, ma, rs, ru, tr, us.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_REVERSE_SEARCHBOXTool to convert coordinates to places using the Search Box API (reverse geocoding). Use when you need to find place names, addresses, or points of interest for given coordinates.
Input parameters
Quantity of results to return (maximum 10).
Comma-separated list of feature types to filter results: country, region, postcode, district, place, city, locality, street, address, etc.
Comma-separated list of ISO 3166 alpha-2 country codes to limit results.
ISO language code for results (default: English). Use IETF language tags.
The latitudinal coordinate for the reverse query.
The longitudinal coordinate for the reverse query.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_SEARCH_BOX_FORWARDTool to search for places by name or address using the Search Box API. Use when you need to find locations, addresses, or points of interest based on a text query.
Input parameters
The user's query string to search for places by name or address (limited to 256 characters).
Bounding box to constrain results: 'minLon,minLat,maxLon,maxLat'.
Maximum number of results to return (maximum 10).
Comma-separated feature types to filter results (address, poi, place, etc.).
Comma-separated ISO 3166-1 alpha-2 country codes to filter results.
ISO language code for results (e.g., 'en', 'es', 'fr'). Defaults to English.
Location bias using 'ip' for IP-based biasing or 'longitude,latitude' coordinates.
Comma-separated POI categories to filter results.
Set to true for fuzzy/partial matching and autocomplete results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_SEARCH_CATEGORYTool to search for places by category (e.g., restaurants, hotels, coffee shops). Use when you need to find POIs in a specific category, optionally filtered by location, bounding box, or proximity.
Input parameters
Limit results to only those contained within the supplied bounding box (format: min_lon,min_lat,max_lon,max_lat).
The number of results to return, up to 25.
Polyline-encoded route for search-along-route queries.
A comma-separated list of ISO 3166 alpha 2 country codes to limit results.
The canonical category ID or name to search for (e.g., restaurant, coffee, hotel).
The ISO language code to be returned. If not provided, the default is English.
Enable search-along-route functionality with value 'isochrone'.
Bias results toward closer locations using either 'ip' or longitude,latitude coordinates.
Specify route polyline precision as 'polyline' or 'polyline6'.
Maximum detour allowed in estimated minutes from the route.
A comma-separated list of canonical category names that limits POI results by excluding specified categories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAPBOX_SUGGEST_SEARCHBOXTool to get autocomplete suggestions for a partial search query. Use when you need address or place suggestions as users type, before retrieving full details.
Input parameters
The user's query string. The query is limited to 256 characters.
Restrict results within a bounding box: 'minLon,minLat,maxLon,maxLat' (4 comma-separated coordinates).
Number of results to return, maximum of 10.
Filter by feature types: country, region, postcode, district, place, locality, neighborhood, street, address, poi, category.
Location for distance calculations in 'longitude,latitude' format.
Comma-separated list of ISO 3166 alpha-2 country codes to filter results.
Set to 'navigation' to enable ETA calculations for results.
ISO 639-1 language code for results; defaults to English if not specified.
Bias the response to favor results closer to a specific location. Use 'ip' for IP-based location or 'longitude,latitude' format.
Limit results to specified POI categories (comma-separated).
A customer-provided session token value, which groups a series of requests together for billing purposes.
Routing profile when ETA enabled: driving, walking, or cycling.
Exclude results from specified POI categories (comma-separated).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 69 agents privately built on Nagent that already use Mapbox.
Build on Nagent
Connect Mapbox to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Mapbox, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Mapbox is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Mapbox is connected, you configure its 32 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Mapbox steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Mapbox event fires, the agent kicks off automatically.
Every Mapbox action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Mapbox ships with 32 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Mapbox together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Mapbox-based workflows tailored to your business.