Get started with HERE Location Reasoning
Connect to the HERE Location Reasoning MCP server from an MCP client, such as an agentic IDE or desktop assistant like GitHub Copilot or Kiro, to start a session, discover available tools, and call a tool.
For HERE OAuth 2.1 machine-to-machine (M2M) authentication, see Authenticate a custom application with M2M credentials.
HERE Location Reasoning is available on AWS MarketplaceYou can also subscribe to the HERE Location Reasoning through the AWS Marketplace, which provides a convenient self-service option to purchase and manage billing in one place.
Contact UsFor Enterprise evaluations of HERE Location Reasoning, contact HERE Sales or connect through HERE Sales email ([email protected]).
Prerequisite
Make sure you have a HERE platform account and belong to an organization provisioned for HERE Location Reasoning.
You can subscribe your organization to HERE Location Reasoning, or ask the owner of an existing subscription to invite you to their organization. An account that is not provisioned can still complete sign-in, but tool calls fail.
Connect to HERE Location Reasoning
You can connect to HERE Location Reasoning from an MCP client that supports remote servers by adding https://hlr.here.ai/mcp to its configuration. The following sections provide steps on how to set up HERE Location Reasoning in Kiro and Github Copilot in VS Code.
ImportantClient setup varies as some clients accept the server URL in their settings (for example, Claude Code), while others use a JSON configuration file (for example, Kiro or VS Code). Follow your client's documentation for the required format, fields, and file location.
Kiro
To add the HERE Location Reasoning for Kiro, perform the following steps:
-
In the Views sidebar, click the Kiro icon.
-
In the MCP SERVERS panel, click the Open MCP Config icon. This action opens the
mcp.jsonconfiguration file. -
In the
mcp.jsonfile, nest thehere-location-reasoningobject within themcpServersobject, including thetypeandurlkeys with the required values, as shown in the following snippet:{ "mcpServers": { "here-location-reasoning": { "type": "http", "url": "https://hlr.here.ai/mcp" } } } -
Confirm your edits by saving the
mcp.jsonfile. You added HERE Location Reasoning to the MCP Server List. Kiro now displays the new server in the MCP SERVERS panel, with theUnauthenticatedstatus. -
Click Authenticate for the
here-location-reasoningMCP server.
-
Follow the on-screen prompts to open a browser window so that you can authenticate your MCP connection and allow the Kiro client to connect to your HERE platform account. Upon a successful authorization, the browser displays the
Authorization Successfulmessage and you can see the tool list after clicking the expand icon next to thehere-location-reasoningMCP server.
Github Copilot in VS Code
To add the HERE Location Reasoning for GitHub Copilot in VS Code, perform the following steps:
-
From the VS Code Command Palette, select MCP: Open User Configuration. This action opens the
mcp.jsonconfiguration file. -
In the
mcp.jsonfile, nest thehere-location-reasoningobject within theserversobject, including thetype, andurlkeys with the required values, as shown in the following snippet:{ "servers": { "here-location-reasoning": { "type": "http", "url": "https://hlr.here.ai/mcp" } } } -
Confirm your edits by saving the
mcp.jsonfile. You added HERE Location Reasoning to the MCP Server List. The client displays a dialog window prompting you to authenticate withaccount.here.com. -
Follow the on-screen prompts to open a browser window so that you can authenticate your MCP connection and allow the VS Code client to connect to your HERE platform account. Upon a successful authorization, the browser displays the
Authorization Successfulmessage. -
Return to VS Code. The
mcp.jsonfile displays theRunningmessage next to the server configuration, as shown in the following figure:
-
In Copilot Chat, test the MCP connection by requesting the AI agent to list the available
here-location-reasoningMCP tools, for example, you can enter:Display the list of here-location-reasoning MCP tools. Test the connection by calling one of the available tools.
If your client is compatible with the agent plugins spec, you can add the HERE Location Reasoning plugin, following your client's plugin installation steps.
Next steps
- For a complete list of available location tools, see HERE Location Reasoning tools reference.
- For troubleshooting MCP client issues, see Troubleshoot HERE Location Reasoning.
Updated 12 days ago