io.github.aalzresPublished by GitHub account aalzresv0.1.0Updated Nov 3, 2026
Cheapest fuel in Spain: live prices at ~12,000 petrol stations, near a place or along a route.
TankoUp's hosted MCP server (mcp.tankoup.com); no sign-in required; Streamable HTTP; 4 tools.
No AI overview yet: these facts come from the registry entry and the server itself.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.aalzres%2Ftankoup/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"tankoup": {
"type": "http",
"url": "https://mcp.tankoup.com/mcp"
}
}
}Ask Claude, ChatGPT or any MCP client where to fill up for less in Spain.
This is the Model Context Protocol server for TankoUp, the app that finds the cheapest petrol station in Spain. It covers about 12,000 stations: mainland Spain, the Balearic and Canary Islands, Ceuta and Melilla. Prices come from the Spanish government's open data (MITECO) and refresh every 4 hours.
https://mcp.tankoup.com/mcp (Streamable HTTP)"Where is the cheapest diesel near Lucena?" "I'm driving from Madrid to Valencia tomorrow. Where should I fill up with 95?" "How much is petrol in Bizkaia compared with the rest of Spain?"
Fuels: diesel (Gasóleo A), diesel_premium, sp95 (Gasolina 95 E5), sp95_e10, sp98 and lpg (GLP).
Stations are ranked by total cost, not by pump price alone: the price of a 40 L fill plus the fuel burned driving there and back (or leaving the route and rejoining it). A station 2 cents cheaper but 15 km away usually loses.
Places are Spanish towns and cities by name ("Lucena, Córdoba", "San Sebastián", "Palma"), resolved against every municipality with a fuel station. For a street, a landmark or the user's position, the client passes latitude and longitude.
Every answer is short and structured: a few stations, each with its price, distance, whether it is open now, a link to open it in TankoUp and a Google Maps directions link.
Claude (claude.ai and Desktop; it then works on mobile too): Customize → Connectors → Add → Add custom connector, and paste https://mcp.tankoup.com/mcp.
ChatGPT (any plan, Free included): Plugins → Add → Add custom MCP server, paste the URL above and pick "No authentication". Then mention @TankoUp in a chat.
Claude Code:
Any other client that speaks Streamable HTTP: point it at https://mcp.tankoup.com/mcp.
[Claude answering with the TankoUp connector]
src/tankoup_mcp/data/places.json, built from the API by scripts/build_places.py). No geocoding service, no third party.europe-west1 (Belgium), scaling to zero when idle.The server keeps no record of what you ask. It logs one line per tool call with the tool's name, the protocol version and how long it took; never the arguments, places or coordinates. Like any web service it sees the caller's IP address, which for Claude and ChatGPT is the platform's, not yours; Google Cloud's request logs keep it for 30 days. Nothing is shared with anyone. TankoUp's privacy policy: https://tankoup.com/en/legal/privacy-policy.
Requires Python 3.12+ and uv.
Then open MCP Inspector against http://localhost:8000/mcp:
Every tool is tested against a mocked API with real response shapes, plus the HTTP layer: a legacy client's handshake and tool call, rate limits, CORS and health.
Against a running server, scripts/smoke.py calls every tool once:
MIT. Fuel price data: Ministerio para la Transición Ecológica y el Reto Demográfico (MITECO), Spain, open data.
Source: README.md at commit 9e4a52d
Cheapest fuel near a place
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.
latlngfuelrequiredlimitplaceopen_nowradius_kmCheapest fuel along a route
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.
fuelrequiredlimitoriginrequiredopen_nowdestinationrequiredFuel prices in a province
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.
fuelprovincerequiredPetrol station details
Everything about one petrol station: every fuel's current price, opening hours, address and links.
latlngstation_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --transport http tankoup https://mcp.tankoup.com/mcpClaude / ChatGPT ──MCP──▶ tankoup-mcp (Cloud Run) ──HTTPS──▶ TankoUp API ──▶ Postgres (the API the app and website use, fed from MITECO every 4 hours)uv syncTANKOUP_API_KEY=... uv run uvicorn tankoup_mcp.app:app --port 8000npx @modelcontextprotocol/inspectoruv run pytestuv run python scripts/smoke.py https://mcp.tankoup.com/mcpscripts/setup-gcp.sh # once: the API key in Secret Manager and a service accountscripts/deploy.sh # build in Cloud Build and deploy to Cloud Run