HERE Location Reasoning tools reference

This topic summarizes the available HERE Location Reasoning tool categories and capabilities.

Use the MCP tools/list method to retrieve the enabled tools and their complete input and output schemas. Treat its response as the authoritative source for tool availability, supported parameters, required fields, and response formats.

Tools by task

The following table sorts the HERE Location Reasoning tools by task.

TaskTool
Convert a concrete street or postal address to coordinatesgeocode
Convert coordinates to an address or place namereverse-geocode
Calculate a route between an origin and destinationcalculate-route
Import a route from a polyline traceget-route-from-polyline
Plan a public-transit journeypublic-transit-route
Find regular stops along a calculated routefind-route-stops
Calculate travel time and distance for multiple origin and destination pairsmatrix-routing
Find places, cities, countries, categories, or brands, optionally within an areadiscover
Find places near other places or a mapped feature (experimental)find-places-near
Find places far from other places or a mapped feature (experimental)find-places-far-from
Retrieve real-time traffic flowreal-time-traffic
Calculate an area reachable from an origin or toward a destinationisoline-route
Render an interactive map from inline GeoJSON or cached route, traffic, or isoline IDsdata-visualization

Reuse cached IDs

Some tools return cached IDs. Pass these IDs to follow-up tools to avoid recalculating the same route or geometry.

Tool that returns an IDCached IDFollow-up tools that use the ID
calculate-routeRoute IDfind-route-stops, real-time-traffic, data-visualization
get-route-from-polylineRoute IDfind-route-stops, real-time-traffic, data-visualization
public-transit-routePublic-transit route IDdata-visualization
isoline-routeIsoline IDdata-visualization

Available tools

Geocoding

ToolDescription
geocodeConverts a concrete street or postal address to geographic coordinates and detailed address information.
reverse-geocodeConverts latitude and longitude coordinates to an address or place name.

Routing

ToolDescription
calculate-routeCalculates an optimized route between an origin and destination, including distance, duration, navigation instructions, and a cached route ID for follow-up tools.
find-route-stopsFinds stop locations along a cached route at regular time or distance intervals by using stored route spans and polylines.
matrix-routingCalculates travel-time and distance matrices between multiple origins and destinations.

Public Transit

ToolDescription
public-transit-routePlans scheduled public-transit itineraries between two points and returns a cached public-transit route ID for follow-up map rendering.

Route import

ToolDescription
get-route-from-polylineImports a caller-supplied HERE flexpolyline or Google polyline into a cached route via HERE Route Import. This is useful when you already have GPS trace data and want to reconstruct the route geometry.

Search and discovery

ToolDescription
discoverPrimary place-search tool. Searches globally by natural-language query when area is omitted, or restricts results to a supplied area or route.

Traffic

ToolDescription
real-time-trafficRetrieves real-time traffic flow data for a circle, bounding box, corridor, segment reference, or cached route corridor.

Isolines

ToolDescription
isoline-routeCalculates reachable isoline polygons from an origin or toward a destination and returns a cached isoline ID for follow-up tools.

Map rendering

ToolDescription
data-visualizationRenders an interactive map from inline GeoJSON or cached route, traffic, or isoline IDs.

Experimental

📘

Important

Experimental tools are under active development. Their inputs, outputs, and behavior can change without notice, and they might be changed or removed in a future release.

Resources are exposed to provide optional dictionaries for those tools categories://here-places and spatials://here-lg.
Resources are optional and tools can be used without them.

ToolDescription
find-places-nearFinds places of one category near places of another category or near a mapped feature, for example coffee shops near EV charging or cafes inside a park.
find-places-far-fromFinds places of one category kept at least a given distance from places of other categories or from mapped features, for example hotels far from airports. Bounding-box areas only.

Request optional response fields

calculate-route and get-route-from-polyline accept a return array that adds optional fields on top of the route id and sections that every response includes. Request only the fields you need, because some are expensive to compute. When you omit return, it defaults to ["summary"].

For background on route response capabilities in the underlying HERE Routing API, see the HERE Routing API v8 API overview.

ValueDescription
summaryTotal distance and travel time for the route. Included by default.
instructionsTurn-by-turn maneuver text. Request this most expensive field only when you need the written guidance.
turnByTurnActionsStructured per-maneuver actions to build your own navigation UI.
tollsToll fares and their cost along the route.
elevationElevation values along the route geometry.
routeHandleAn opaque route handle token that encodes the route. Pass it to the HERE SDK or HERE Routing API to rebuild the same route without recalculating it. Use this token to hand off a route computed by HERE Location Reasoning to a HERE SDK app.

Retrieve current tool schemas

After you establish an MCP session, send a tools/list request with the HTTP header Authorization: Bearer <HERE_ACCESS_TOKEN>. For information about creating an access token, see Connect with OAuth credentials.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Next steps


Did this page help you?