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 Marketplace

You 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 Us

For 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.

📘

Important

Client 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:

  1. In the Views sidebar, click the Kiro icon.

  2. In the MCP SERVERS panel, click the Open MCP Config icon. This action opens the mcp.json configuration file.

  3. In the mcp.json file, nest the here-location-reasoning object within the mcpServers object, including the type and url keys with the required values, as shown in the following snippet:

    {
      "mcpServers": {
        "here-location-reasoning": {
          "type": "http",
          "url": "https://hlr.here.ai/mcp"
        }
      }
    }
  4. Confirm your edits by saving the mcp.json file. You added HERE Location Reasoning to the MCP Server List. Kiro now displays the new server in the MCP SERVERS panel, with the Unauthenticated status.

  5. Click Authenticate for the here-location-reasoning MCP server.

    Kiro MCP configuration showing the HERE Location Reasoning server and its Authenticate button

  6. 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 Successful message and you can see the tool list after clicking the expand icon next to the here-location-reasoning MCP server.

Github Copilot in VS Code

To add the HERE Location Reasoning for GitHub Copilot in VS Code, perform the following steps:

  1. From the VS Code Command Palette, select MCP: Open User Configuration. This action opens the mcp.json configuration file.

  2. In the mcp.json file, nest the here-location-reasoning object within the servers object, including the type, and url keys with the required values, as shown in the following snippet:

    {
      "servers": {
        "here-location-reasoning": {
          "type": "http",
          "url": "https://hlr.here.ai/mcp"
        }
      }
    }
  3. Confirm your edits by saving the mcp.json file. You added HERE Location Reasoning to the MCP Server List. The client displays a dialog window prompting you to authenticate with account.here.com.

  4. 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 Successful message.

  5. Return to VS Code. The mcp.json file displays the Running message next to the server configuration, as shown in the following figure:

    VS Code shows the HERE Location Reasoning MCP server running

  6. In Copilot Chat, test the MCP connection by requesting the AI agent to list the available here-location-reasoning MCP 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


Did this page help you?