TankoUp
Server Details
Cheapest fuel in Spain: live prices at ~12,000 petrol stations, near a place or along a route.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- aalzres/tankoup-mcp
- GitHub Stars
- 0
- Server Listing
- TankoUp MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 4 tools
Each tool targets a clearly distinct scope: point-based search, route-based search, province-level aggregates, and single-station lookup. The nearby/on-route pair is separated explicitly by geography (radius vs corridor), and the province/station pair by aggregation level. No realistic misselection risk.
All four names are snake_case, verb-first, and follow a noun-phrase pattern (find_cheapest_fuel_nearby, find_cheapest_fuel_on_route, get_province_fuel_prices, get_station_details). The find/get split maps cleanly onto search vs retrieve semantics rather than being arbitrary.
Four tools is tightly scoped to a narrow domain (Spanish fuel prices) and each covers a distinct query mode with no filler. Nothing feels redundant or missing at the count level.
The surface covers the main workflows: search by location, search by route, province overview, and station detail. Minor gaps remain, such as listing supported fuel types/brands or searching stations by name, but agents can work around these via the province and nearby tools.
Available Tools
4 toolsfind_cheapest_fuel_nearbyCheapest fuel near a placeRead-onlyInspect
Find the cheapest petrol stations in Spain near a town, city or point, for one fuel.
Returns the best stations by total cost (price plus the fuel used to get there), each with its price per litre, distance, whether it is open, and links to TankoUp and to directions.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude of the search point. | |
| lng | No | Longitude of the search point. | |
| fuel | Yes | Fuel type: diesel = Gasóleo A (regular diesel), diesel_premium = Gasóleo Premium, sp95 = Gasolina 95 E5 (regular unleaded petrol), sp95_e10 = Gasolina 95 E10, sp98 = Gasolina 98, lpg = GLP / autogas. | |
| limit | No | How many stations to return. | |
| place | No | A Spanish town or city, optionally with its province: 'Lucena, Córdoba'. Use lat/lng instead for a street, landmark or the user's position. | |
| open_now | No | Only stations open right now (unknown hours count as open). | |
| radius_km | No | Search radius in km. |
Output Schema
| Name | Required | Description |
|---|---|---|
| fuel | Yes | |
| place | Yes | Where the search was centred, as understood. |
| ranking | Yes | |
| stations | Yes | Best first, by total cost. |
| radius_km | Yes | |
| app_store_url | No | The TankoUp app for iPhone. |
| stations_found | Yes | |
| google_play_url | No | The TankoUp app for Android. |
| more_on_tankoup | Yes | |
| prices_updated_at | Yes | |
| area_average_eur_per_litre | Yes | |
| best_saves_eur_on_40_litres | Yes | Saving at the first station against the area average. |
| other_places_with_this_name | No |
find_cheapest_fuel_on_routeCheapest fuel along a routeRead-onlyInspect
Find the cheapest petrol stations along a driving route in Spain, for one fuel.
Works out the driving route and returns the best stations within about 3 km of it, by total cost including the detour, with links to TankoUp and to directions through the station. Routes up to 1,200 km.
| Name | Required | Description | Default |
|---|---|---|---|
| fuel | Yes | Fuel type: diesel = Gasóleo A (regular diesel), diesel_premium = Gasóleo Premium, sp95 = Gasolina 95 E5 (regular unleaded petrol), sp95_e10 = Gasolina 95 E10, sp98 = Gasolina 98, lpg = GLP / autogas. | |
| limit | No | How many stations to return. | |
| origin | Yes | Where the trip starts: a place name, or lat/lng. | |
| open_now | No | Only stations open right now (unknown hours count as open). | |
| destination | Yes | Where the trip ends: a place name, or lat/lng. |
Output Schema
| Name | Required | Description |
|---|---|---|
| fuel | Yes | |
| origin | Yes | |
| ranking | Yes | |
| route_km | Yes | |
| stations | Yes | Best first, by total cost. distance_km is from the origin. |
| destination | Yes | |
| duration_min | Yes | |
| app_store_url | No | The TankoUp app for iPhone. |
| stations_found | Yes | Stations within about 3 km of the route. |
| google_play_url | No | The TankoUp app for Android. |
| prices_updated_at | Yes | |
| best_saves_eur_on_40_litres | Yes | Saving at the first station against the route average. |
| route_average_eur_per_litre | Yes |
get_province_fuel_pricesFuel prices in a provinceRead-onlyInspect
Average and lowest fuel prices in a Spanish province, with its cheapest stations.
For each fuel: the average and lowest price per litre, the change over the
last 30 days, how it compares with the Spanish average, the cheapest brand
and the 3 cheapest stations.
| Name | Required | Description | Default |
|---|---|---|---|
| fuel | No | Fuel type: diesel = Gasóleo A (regular diesel), diesel_premium = Gasóleo Premium, sp95 = Gasolina 95 E5 (regular unleaded petrol), sp95_e10 = Gasolina 95 E10, sp98 = Gasolina 98, lpg = GLP / autogas. Leave out for every fuel. | |
| province | Yes | One of Spain's 50 provinces, or Ceuta or Melilla, in Spanish, English or the regional language: 'Córdoba', 'Vizcaya', 'Illes Balears', 'Seville'. |
Output Schema
| Name | Required | Description |
|---|---|---|
| fuels | Yes | |
| province | Yes | |
| app_store_url | No | The TankoUp app for iPhone. |
| google_play_url | No | The TankoUp app for Android. |
| more_on_tankoup | Yes | |
| prices_updated_at | Yes |
get_station_detailsPetrol station detailsRead-onlyInspect
Everything about one petrol station: every fuel's current price, opening hours, address and links.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Optional: the user's latitude, for the distance. | |
| lng | No | Optional: the user's longitude. | |
| station_id | Yes | Station id from another TankoUp tool, like 'ES-3213'. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | |
| lat | Yes | |
| lng | Yes | |
| name | Yes | |
| town | Yes | |
| brand | Yes | |
| prices | Yes | |
| address | Yes | |
| open_now | Yes | null when the opening hours are unknown. |
| province | Yes | |
| distance_km | Yes | From the given lat/lng, straight line. null without them. |
| tankoup_url | Yes | |
| app_store_url | No | The TankoUp app for iPhone. |
| opening_hours | Yes | null when unknown. |
| directions_url | Yes | |
| google_play_url | No | The TankoUp app for Android. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
- Changed
find_cheapest_fuel_nearby2 fields changed- added
Output schema / properties / app_store_urlAdded value: +{ + "default": "https://apps.apple.com/es/app/tankoup/id6789885475", + "description": "The TankoUp app for iPhone.", + "title": "App Store Url", + "type": "string" +} - added
Output schema / properties / google_play_urlAdded value: +{ + "default": "https://play.google.com/store/apps/details?id=com.tankoup.app&referrer=utm_source%3Dmcp%26utm_medium%3Dassistant", + "description": "The TankoUp app for Android.", + "title": "Google Play Url", + "type": "string" +}
- Changed
find_cheapest_fuel_on_route2 fields changed- added
Output schema / properties / app_store_urlAdded value: +{ + "default": "https://apps.apple.com/es/app/tankoup/id6789885475", + "description": "The TankoUp app for iPhone.", + "title": "App Store Url", + "type": "string" +} - added
Output schema / properties / google_play_urlAdded value: +{ + "default": "https://play.google.com/store/apps/details?id=com.tankoup.app&referrer=utm_source%3Dmcp%26utm_medium%3Dassistant", + "description": "The TankoUp app for Android.", + "title": "Google Play Url", + "type": "string" +}
- Changed
get_province_fuel_prices2 fields changed- added
Output schema / properties / app_store_urlAdded value: +{ + "default": "https://apps.apple.com/es/app/tankoup/id6789885475", + "description": "The TankoUp app for iPhone.", + "title": "App Store Url", + "type": "string" +} - added
Output schema / properties / google_play_urlAdded value: +{ + "default": "https://play.google.com/store/apps/details?id=com.tankoup.app&referrer=utm_source%3Dmcp%26utm_medium%3Dassistant", + "description": "The TankoUp app for Android.", + "title": "Google Play Url", + "type": "string" +}
- Changed
get_station_details2 fields changed- added
Output schema / properties / app_store_urlAdded value: +{ + "default": "https://apps.apple.com/es/app/tankoup/id6789885475", + "description": "The TankoUp app for iPhone.", + "title": "App Store Url", + "type": "string" +} - added
Output schema / properties / google_play_urlAdded value: +{ + "default": "https://play.google.com/store/apps/details?id=com.tankoup.app&referrer=utm_source%3Dmcp%26utm_medium%3Dassistant", + "description": "The TankoUp app for Android.", + "title": "Google Play Url", + "type": "string" +}
4 tool updates
- First observed
find_cheapest_fuel_nearby - First observed
find_cheapest_fuel_on_route - First observed
get_province_fuel_prices - First observed
get_station_details
Related MCP Connectors
Real-time fuel prices, alerts, and cheapest gas stations across 38+ countries.
Live official fuel station prices for France, Spain, Italy and Western Australia in one schema.
Cheapest diesel and petrol near any UK postcode.
Live Quebec gas and diesel prices: cheapest stations nearby, city fair price, 30-day history.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides real-time fuel prices at gas stations in Spain using the government's public API. Enables users to find the cheapest fuel in a municipality or list stations sorted by price.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to query fuel prices at filling stations in mainland Portugal from DGEG data, finding the cheapest nearby stations by place, postal code, coordinates, concelho or district. Also supports station details, regional and national market statistics, and daily national price history.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to look up real-time fuel prices at over 14,000 German gas stations, find the cheapest E5, E10, or diesel near a place or GPS coordinates, and return only open stations sorted by price.MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to find the cheapest fuel stations and nearby EV chargers in Portugal using official open data, including live charger status and prices with filters for location, fuel type, connector, power, and availability.5MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.