HERE Location Reasoning tools reference

📘
HERE Location Reasoning is currently available to beta participants. For information on joining the beta, see HERE Location Reasoning

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.

Task	Tool
Convert an address or place name to coordinates	`geocode`
Convert coordinates to an address or place name	`reverse-geocode`
Calculate a route between an origin and destination	`calculate-route`
Find regular stops along a calculated route	`find-route-stops`
Calculate travel time and distance for multiple origin and destination pairs	`matrix-routing`
Find places of interest in an area or along a route	`discover`
Retrieve real-time traffic flow	`traffic-flow`
Calculate an area reachable from an origin or toward a destination	`isoline-route`
Render an interactive map from inline GeoJSON or cached route, traffic, or isoline IDs	`data-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 ID	Cached ID	Follow-up tools that use the ID
`calculate-route`	Route ID	`find-route-stops`, `traffic-flow`, `data-visualization`
`isoline-route`	Isoline ID	`data-visualization`

Available tools

Geocoding

Tool	Description
`geocode`	Converts an address or place name to geographic coordinates and detailed address information.
`reverse-geocode`	Converts latitude and longitude coordinates to an address or place name.

Routing

Tool	Description
`calculate-route`	Calculates an optimized route between an origin and destination, including distance, duration, navigation instructions, and a cached route ID for follow-up tools.
`find-route-stops`	Finds stop locations along a cached route at regular time or distance intervals by using stored route spans and polylines.
`matrix-routing`	Calculates travel-time and distance matrices between multiple origins and destinations. Availability is limited by the deployment's `MATRIX_ROUTING_TIER`.

Matrix routing tiers

The MATRIX_ROUTING_TIER of the deployment determines the matrix-routing limits:

Tier	Limits
`base` (default)	Profile mode only. `profile` and `regionDefinition: {"type":"world"}` are required. `transportMode`, `routingMode`, `departureTime`, and `arrivalTime` are rejected. Supports matrices up to 100 x 100.
`premium`	Supports the full HERE Matrix limits: flexible mode (15 x 100 or 100 x 1), region mode (500 x 500), and profile mode (500 x 500, 2,000 x 1, or 1 x 2,000).

The tools/list response reflects the active tier and its limits. Requests that exceed those limits return a validation error.

Search and discovery

Tool	Description
`discover`	Searches for places of interest by using natural-language queries, including area-based and along-route searches.

Traffic

Tool	Description
`traffic-flow`	Retrieves real-time traffic flow data for a circle, bounding box, corridor, segment reference, or cached route corridor.

Isolines

Tool	Description
`isoline-route`	Calculates reachable isoline polygons from an origin or toward a destination and returns a cached isoline ID for follow-up tools.

Map rendering

Tool	Description
`data-visualization`	Renders an interactive map from inline GeoJSON or cached route, traffic, or isoline IDs.

Retrieve current tool schemas

Send a tools/list request after you establish an MCP session:

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

Next steps

Connect to and authenticate with HERE Location Reasoning: Create a bearer token and establish an MCP session.
Integrate with HERE Location Reasoning: Run Python and TypeScript integration examples.