calculate_route
Calculate a driving route between two points
LABSCO SUMMARY
The one that earns its place is `find_route_stations` — search along a corridor rather than around a point.
Radius search answers where can I fill up now; a trip needs a different question, and calculate_route handing its geometry to find_route_stations with a corridor_km width answers where can I fill up on the way. Everything downstream runs on coordinates, so geocode is the first call in nearly any chain, and the fuel filter sits on find_nearest_stations, find_route_stations and get_stations_in_area alike, which is what makes it usable when you need a specific grade rather than whatever is nearest.
What it is
A fuel-station lookup and routing server: 5 tools covering geocoding, driving-route calculation with waypoints, and station search by radius, by bounding box or along a route corridor, each search filterable by fuel type.
What you get
- Coordinates from a name:
geocodesearches for a location byqueryand takeslatandlonalongside it. - A driving route between two points:
calculate_routetakesorigin_lat,origin_lon,dest_lat,dest_lonand a list ofwaypoints, and returns the route between them. - Stations near where you are:
find_nearest_stationsreturns the stations closest to alat/lon, bounded byradius_kmandlimitand narrowed to afueltype. - Stations along where you are going:
find_route_stationstakes a routegeometryand acorridor_kmwidth and returns the stations inside that corridor for a givenfuel. - Stations across an area rather than around a point:
get_stations_in_areareturns the stations inside abbox, filtered byfuel.
Requirements
No account and no key. Coordinates are what the station and routing calls run on, so a place name has to pass through geocode first. The server is GPL-3.0, which matters if you plan to redistribute a modified copy.
Setup effort
One command — npx -y pumperly-mcp
USE CASES
01
Planning fuel stops on a long drive
Turn both ends of the trip into coordinates, calculate the route, then look for stations inside a corridor around it.
02
Finding the nearest pump for a specific fuel
Resolve where you are into coordinates and search outward for the grade you actually need.
03
Surveying station coverage across an area
Sweep a bounding box for everything inside it, then check how far the nearest one really is from a point that matters.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
find_nearest_stations
Find fuel stations nearest to a coordinate
find_route_stations
Find fuel stations along a route corridor
geocode
Search for a location by name (geocoding)
get_stations_in_area
Get fuel stations within a bounding box
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"pumperly-mcp": {
"command": "npx",
"args": [
"-y",
"pumperly-mcp"
]
}
}
}npx
TERMINAL
npx -y pumperly-mcp
