developer-toolsapi_key

Graphhopper

GraphHopper Directions API provides enterprise-grade routing services, including route planning, optimization, geocoding, and more, for various vehicle types.

Verdict

Graphhopper brings routing, geocoding, and logistics optimization directly into your Spaces. @mention it to calculate travel times between multiple locations, generate isochrone maps showing reachable areas, solve vehicle routing problems, or convert addresses to coordinates without leaving the conversation. Teams managing field operations, planning deliveries, or building location features get instant access to distance matrices and route optimization that would otherwise require custom API integration. You'll need a Graphhopper API key — free tier covers light usage, but complex VRP problems and high-volume requests require a paid plan.

Common use cases

  • Calculate delivery route ETAs for dispatch
  • Generate service area maps for coverage planning
  • Optimize multi-stop field service schedules
  • Geocode customer addresses in bulk datasets
  • Solve last-mile routing with vehicle constraints

Integration

Vendor
Graphhopper
Category
developer-tools
Auth
API_KEY
Tools
8
Composio slug
graphhopper

Tools

  • Calculate Matrix

    Tool to calculate distance, time, or weight matrices via POST. Use when you have multiple origins/destinations or a symmetric point set and need a single batch request.

  • Capacity Clustering

    Tool to solve capacity clustering problem. Use when assigning a set of customers to clusters to minimize total distance synchronously.

  • Get Custom Profiles

    Tool to retrieve a list of all user-defined routing profiles. Use when you need to list custom profiles.

  • Get Isochrone

    Tool to compute isochrone polygons for a given point. Use when you need to determine areas reachable within time or distance constraints.

  • GraphHopper Geocoding

    Tool to perform forward or reverse geocoding. Use when converting between textual addresses and latitude/longitude coordinates.

  • GraphHopper VRP POST

    Tool to initiate VRP optimization. Use when you need to solve vehicle routing problems synchronously.

  • POST Route

    Tool to calculate complex routes via POST /route. Use when you need advanced route planning with custom parameters.

  • Upload GPX File

    Tool to upload a GPX file to a public file hosting endpoint. Returns a public URL which can be used where a 's3key' is required.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Find Graphhopper in the developer tools section and click Connect. 3. Visit graphhopper.com/dashboard to generate an API key (sign up if you don't have an account). 4. Copy the key and paste it into the Switchy connection dialog, then click Authorize. 5. Switchy confirms the connection and shows which tools are now available. 6. Open any Space and type '@Graphhopper calculate the driving time from Berlin to Munich' to test — the MCP should return route details and duration. 7. If you see an authentication error, verify your API key is active and has sufficient quota in the Graphhopper dashboard. 8. For vehicle routing problems or capacity clustering, ensure your plan supports those features (some require paid tiers).

What teammates see: by default, memories from Graphhopper are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Multi-Stop Route Time

@Graphhopper calculate the driving time matrix between these five warehouse locations: [paste addresses]. Show me the fastest route sequence.
Open in a Space →

Service Area Isochrone

@Graphhopper create a 30-minute driving isochrone from our downtown office at [address]. I need to see which neighborhoods we can serve.
Open in a Space →

Delivery Route Optimization

@Graphhopper optimize a delivery route for these 12 customer addresses [paste list] using two vans with 800kg capacity each. Prioritize minimizing total drive time.
Open in a Space →

Reverse Geocode Coordinates

@Graphhopper reverse geocode these coordinates: 52.5200, 13.4050. I need the full street address for a site visit report.
Open in a Space →

Batch Address Geocoding

@Graphhopper geocode this list of 20 customer addresses [paste CSV]. Return latitude and longitude for each so I can plot them on a map.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@graphhopper what's the driving distance and time from our Berlin office (52.5200, 13.4050) to our Munich warehouse (48.1351, 11.5820)?

Output

Based on the route calculation, the driving distance from Berlin to Munich is approximately 584 kilometers with an estimated travel time of 5 hours 47 minutes under current traffic conditions. The route primarily follows the A9 autobahn southbound. This calculation assumes a standard car profile with typical speed limits and road conditions.

Notes

This example uses the POST Route tool for point-to-point routing. Requires an API key with routing permissions. Response times and distances vary based on selected vehicle profile (car, bike, foot) and real-time traffic data availability. Rate limits apply to batch route requests.

Prompt

@graphhopper show me all areas our delivery drivers can reach within 30 minutes from our Frankfurt distribution center at 50.1109, 8.6821

Output

The isochrone analysis reveals a 30-minute drive-time polygon covering approximately 1,200 square kilometers around Frankfurt. Key reachable areas include Offenbach, Mainz, Wiesbaden, and parts of Darmstadt. The polygon extends roughly 35km north, 28km south, 32km east, and 30km west, accounting for highway access via A3, A5, and A66. This coverage represents ideal conditions without traffic congestion.

Notes

This example demonstrates the Get Isochrone tool for service area analysis. Useful for logistics planning, delivery zone mapping, and site selection. Requires time_limit or distance_limit parameters. Polygon accuracy depends on road network data quality and does not account for real-time traffic or access restrictions.

Prompt

@graphhopper we have 15 delivery stops across Hamburg today — can you optimize the route sequence to minimize total drive time for our two vans?

Output

The vehicle routing optimization assigned 8 stops to Van 1 (total distance: 47km, duration: 2h 18m including service times) and 7 stops to Van 2 (total distance: 52km, duration: 2h 31m). The solution balanced workload across both vehicles while respecting time windows at each stop. Van 1 should start at the northern cluster near Alsterdorf, while Van 2 covers the southern route through Harburg. Total distance saved versus unoptimized routing: approximately 23km.

Notes

This example uses the GraphHopper VRP POST tool for multi-vehicle route optimization. Requires defining vehicle capacities, service time windows, and depot locations. Synchronous requests may timeout for problems with 50+ stops; consider asynchronous mode for larger fleets. API key must have VRP feature access.

Use-case deep-dives

Field service territory planning

When Graphhopper wins for assigning techs to service zones

A 12-person field service team needs to redraw territories after opening a new warehouse. The capacity clustering tool takes your customer list and splits them into balanced zones that minimize drive time. You run it once per quarter when headcount or depot locations change. The isochrone tool shows you the 30-minute drive radius from each tech's home base, which helps you spot coverage gaps before they become SLA misses. This works if your customer density is high enough that clustering matters—if you only have 20 stops spread across three states, you're better off eyeballing it in Google Maps. The API key setup takes five minutes and the matrix endpoint handles up to 10,000 point pairs in a single call, so you can model a full quarter's worth of stops without hitting rate limits. If you're redrawing territories more than twice a year, Graphhopper pays for itself in saved drive hours.

Delivery route optimization at startup scale

When the VRP tool makes sense for last-mile logistics

A 3-person e-commerce fulfillment team runs 40 deliveries per day from a single warehouse. The VRP POST tool takes your order list, vehicle constraints, and time windows, then returns optimized routes that cut daily mileage by 15-20 percent compared to manual sequencing. You call it every morning after the cutoff for same-day orders. The GPX upload tool lets you save the route and send it to drivers' phones as a trackable file. This setup works until you hit about 200 stops per day—beyond that, the synchronous VRP call starts timing out and you need a dedicated routing platform with async job queues. The geocoding tool handles address normalization so you're not manually fixing typos in customer entries. If your delivery volume is under 100 stops and you're still using spreadsheets to plan routes, Graphhopper is the fastest way to professionalize without hiring a logistics analyst.

Real estate market reachability analysis

When isochrones beat radius searches for property listings

A 5-person real estate brokerage wants to show buyers 'homes within 20 minutes of downtown' instead of the usual 5-mile radius that includes a highway dead-zone. The isochrone endpoint draws drive-time polygons that account for actual road networks and traffic patterns. You generate these once per neighborhood and cache them in your listing database. The POST route tool handles the 'show me commute time to three different offices' request that comes up in every corporate relocation. This approach works if your market has meaningful geographic barriers—if you're selling in flat-grid Midwest suburbs, a simple radius does the job. The matrix endpoint lets you precompute drive times from every listing to 50 key destinations (schools, hospitals, transit hubs) and surface them as listing metadata. If you're fielding more than 10 'how long to get to X' questions per week, Graphhopper turns that into a competitive edge.

Frequently asked

What does the GraphHopper MCP do in Switchy?

It gives your AI agents access to GraphHopper's routing and logistics APIs. Agents can calculate routes, solve vehicle routing problems, generate isochrones, geocode addresses, and compute distance matrices. Think of it as letting your team's AI handle complex mapping and logistics tasks without writing code or switching to the GraphHopper dashboard.

Do I need a GraphHopper API key to use this MCP?

Yes. You'll need an active GraphHopper API key with credits or a paid plan. Paste it into Switchy's connection flow once, and all team members can use the MCP without needing their own keys. The key's rate limits and feature access apply to all requests made through Switchy.

Can the GraphHopper MCP optimize routes for multiple vehicles?

Yes, via the VRP optimization tool. It solves vehicle routing problems with constraints like time windows, capacity, and driver skills. For simpler multi-stop routes on a single vehicle, use the POST Route tool. For just distance/time between many points, the Calculate Matrix tool is faster.

How is this different from using GraphHopper's API directly?

You skip the code. Instead of writing API calls and parsing JSON responses, your team describes what they need in plain English and the AI handles the GraphHopper requests. Custom routing profiles, complex VRP constraints, and batch matrix calculations all work through conversation. No Postman, no docs lookup.

Who on my team should connect the GraphHopper MCP?

Whoever manages your GraphHopper account or has the API key. Once connected, any Switchy user in your workspace can use it. The MCP doesn't create new GraphHopper users or consume extra seats—it just authenticates requests with the key you provide.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.