pumperly-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PUMPERLY_ORIGIN | No | Pumperly origin country |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Pumperly fuel and EV charging prices, stations and driving routes in about 40 countries, mostly in Europe (pumperly://stats lists them). Every tool is read-only.
Cheapest fuel near a place: find_nearest_stations with near="" (or lat/lon) and sort_by=price.
Cheapest in an area: get_stations_in_area with bbox "minLon,minLat,maxLon,maxLat".
Where to fill up on a trip: cheapest_fuel_on_route with origin and destination names. One call; do not chain calculate_route and find_route_stations for this.
fuel is a code: B7 diesel, E5 petrol 95, E10, E5_98 petrol 98, LPG, CNG, EV and more in pumperly://fuel-types.
Prices are per litre (per kg for CNG, LNG and H2, per kWh for EV) in each station's local currency; convert with pumperly://exchange-rates (EUR base) before comparing across borders. Coordinates in GeoJSON, bbox and waypoints are [lon, lat], longitude first; lat and lon parameters are named. Route searches are limited to 30 per minute.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_routeA | Calculate a driving route and return its distance (km), driving time (minutes) and bounding box, with up to 2 alternatives when there are no waypoints. Ends can be place names, "lat,lon" text or coordinates. To find fuel along the way, call cheapest_fuel_on_route instead: it routes and searches in one call. Set include_geometry only to pass the line to find_route_stations; it can be up to 2000 points. |
| cheapest_fuel_on_routeA | Plan a drive and find where to fill up: routes from origin to destination, then lists the stations within corridor_km of the route, cheapest first, with each one's km from the start. Ends can be place names ("Madrid", "Valencia"), "lat,lon" text or coordinates. Prices are per litre (per kg for CNG, LNG and H2, per kWh for EV) in local currency; cross-border trips mix currencies, see pumperly://exchange-rates. Uses two of the API's 30 route searches per minute. |
| find_nearest_stationsA | Find the fuel stations or EV chargers closest to a point, with current prices. Give the point as lat and lon, or as a place name in near (geocoded for you). sort_by=distance (default) returns the nearest; sort_by=price returns the cheapest among the 50 nearest within the radius. Prices are per litre (per kg for CNG, LNG and H2, per kWh for EV) in the station's local currency. Covers about 40 countries, mostly in Europe; pumperly://stats lists them. |
| find_route_stationsA | List the fuel stations or EV chargers within corridor_km of a route line you already have, cheapest first by default, with each station's km along the route. Most callers want cheapest_fuel_on_route, which takes place names and does the routing too. Prices are per litre (per kg for CNG, LNG and H2, per kWh for EV) in local currency. The API allows 30 route searches per minute. |
| geocodeA | Turn a place name or address into coordinates (lat, lon), best match first. The station and route tools already accept place names, so call this only to pick between ambiguous places or to get coordinates for a bbox. Give lat and lon to prefer results near a point. |
| get_stations_in_areaA | List the fuel stations or EV chargers inside a bounding box with current prices, cheapest first by default, plus the min, median and max price per currency. Use it for "cheapest diesel in this town". For a point and radius use find_nearest_stations; along a trip use cheapest_fuel_on_route. Prices are per litre (per kg for CNG, LNG and H2, per kWh for EV) in local currency. Keep the box city-sized: a whole-country box can exceed the 8 MB answer cap. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| App configuration | Instance settings: default country and fuel, map centre and zoom, and the enabled countries. Fuel codes are in pumperly://fuel-types. |
| ECB exchange rates | Daily European Central Bank exchange rates against EUR (base EUR), to compare prices quoted in different currencies. |
| Fuel types | The 16 fuel codes the station tools accept (B7 diesel, E5 petrol 95, EV charging...), with a label, category and the unit prices are quoted per (L, kg or kWh). |
| Platform statistics | Station and price counts per covered country (about 40) with the time of each country's last price update. |
TDQS
Scored across 6 tools
Each tool targets a distinct query shape: route geometry, route+fuel, point-radius, route-corridor, geocoding, or bounding box. The main overlap is between cheapest_fuel_on_route and find_route_stations, but the descriptions explicitly steer callers to the right one.
All names use snake_case and are mostly verb_noun or find_* patterns. Minor deviations exist: cheapest_fuel_on_route has no leading verb, and the set mixes calculate/find/get/geocode rather than one retrieval verb, but the conventions remain readable.
Six tools is well-scoped for a fuel-station and routing server, with each tool covering a meaningful query mode. There is no obvious filler or redundancy that should be removed.
The surface covers the main workflows: geocoding, route calculation, nearest stations, area search, and route-corridor fuel search. A dedicated station-detail or station-by-ID tool is missing, but most practical agent workflows can be composed from the existing tools.