How to integrate Graphhopper MCP with Atomic Agent

Connect Atomic Agent to Graphhopper MCP. Optimize delivery routes for multiple trucks, find all areas reachable within 15 minutes, and more using natural language, with authentication handled for you.

Graphhopper logoGraphhopper
Api Key

GraphHopper is an enterprise-grade Directions API for routing, optimization, and geocoding across multiple vehicle types. It enables fast, reliable route planning and logistics automation for businesses.

13 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Graphhopper.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Graphhopper account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Graphhopper with

How Atomic Agent connects to Graphhopper

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Graphhopper to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Graphhopper. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Graphhopper account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Graphhopper MCP server, and what's possible with it?

The Graphhopper MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Graphhopper account. It provides structured and secure access to powerful routing, geocoding, and optimization services, so your agent can perform actions like planning routes, solving vehicle routing problems, geocoding addresses, and generating travel time isochrones on your behalf.

  • Advanced route planning and optimization: Calculate complex routes for cars, bikes, or trucks using advanced parameters, waypoints, and custom profiles, all without manual map work.
  • Batch distance and time calculations: Let your agent generate distance or time matrices for multiple origins and destinations, streamlining logistics and route optimization tasks.
  • Geocoding and reverse geocoding: Convert between street addresses and GPS coordinates, or look up locations by latitude/longitude, making address management and mapping effortless.
  • Isochrone map generation: Automatically create isochrone polygons to visualize areas reachable within a specific travel time or distance from any point—perfect for delivery zones, emergency planning, or site selection.
  • Vehicle routing problem (VRP) solving: Offload complex fleet and logistics challenges to your agent, letting it assign deliveries, optimize routes, and minimize travel distances or costs using Graphhopper's VRP tools.

Use Graphhopper from Atomic Agent

With your account connected, ask Atomic Agent to work with Graphhopper in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Graphhopper action and event your agent gets out of the box.

Capacity Clustering

Solve capacity-constrained clustering problems by assigning customers to clusters while minimizing total travel distance.

GraphHopper Geocoding

Tool to perform forward or reverse geocoding.

Get Cluster Solution

Retrieve the solution of an asynchronous clustering job by job ID.

Get Matrix

Tool to compute a distance and/or time matrix using GET request with query parameters.

Get Matrix Solution

Retrieve the status and result of an asynchronous matrix computation job by job ID.

GET Route

Tool to calculate the best path connecting two or more points using simple GET request.

Get Isochrone

Tool to compute isochrone polygons for a given point.

Calculate Matrix

Tool to calculate distance, time, or weight matrices via POST.

Get Custom Profiles

List custom routing profiles for your GraphHopper account using your own API key.

POST Route

Tool to calculate complex routes via POST /route.

Submit Matrix Job

Submit a matrix computation job for asynchronous processing and receive a job ID to retrieve results later.

Map Match GPX Track

Map-match GPX track points to the road network using your own GraphHopper API key.

GraphHopper VRP POST

Submit a vehicle routing optimization request and return its job status and any available solution.

FAQ

Frequently asked questions

Start with Graphhopper.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Graphhopper tool your agent needs.Free to start.

Start building