# TankoUp

> TankoUp is an open-source MCP server for maps and travel. Live Spanish petrol and diesel prices, ranked by total cost, for any MCP client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Repository:** https://github.com/aalzres/tankoup-mcp
- **MCP Registry name:** io.github.aalzres/tankoup
- **Categories:** maps and travel
- **Listing updated:** 2026-11-15

## About

Stations are ranked by what a fill-up really costs: the price of a 40 L tank plus the fuel burned driving to the station and back, or leaving a route and rejoining it. A pump that is two cents cheaper but 15 km away usually loses.

Prices come from the Spanish government's open data (MITECO) and refresh every four hours, covering about 12,000 stations across mainland Spain, the Balearic and Canary Islands, Ceuta and Melilla. Places are resolved offline against a list of every municipality that has a fuel station, and a client can pass latitude and longitude for a street or landmark.

The server is hosted by its author and needs no authentication, because it only reads public data. The README says it keeps no record of questions, logging only the tool name, protocol version and duration.

## Features

- **Nearby station search:** Finds the best stations around a town, city or coordinates for one chosen fuel.
- **Route search:** Ranks stations along a driving route of up to 1,200 km, counting the detour.
- **Province price summary:** Returns average and lowest prices, a 30-day trend and a comparison with Spain.
- **Station details:** Shows every fuel's price, opening hours, address and links for one station.
- **Six fuel types:** Supports diesel, premium diesel, SP95, SP95 E10, SP98 and LPG.
- **Maps links:** Each result carries a Google Maps directions link and a TankoUp link.

## Good for

- Find the cheapest diesel near a Spanish town
- Plan where to refuel on a long drive such as Madrid to Valencia
- Compare regional petrol prices with the national picture
- Check whether a station is open before driving there

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tankoup https://mcp.tankoup.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tankoup.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tankoup": {
      "url": "https://mcp.tankoup.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tankoup": {
      "type": "http",
      "url": "https://mcp.tankoup.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tankoup": {
      "serverUrl": "https://mcp.tankoup.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tankoup": {
      "type": "http",
      "url": "https://mcp.tankoup.com/mcp"
    }
  }
}
```

## Tools

- `find_cheapest_fuel_nearby`: Best stations near a town, city or point for one fuel
- `find_cheapest_fuel_on_route`: Best stations along a driving route up to 1,200 km
- `get_province_fuel_prices`: Average and lowest prices in a province, 30-day trend and cheapest stations
- `get_station_details`: Every fuel's price at one station with hours, address and links

## FAQ

### Does it need an account or API key?

No. The hosted endpoint at mcp.tankoup.com/mcp has no authentication and the tools only read public data.

### Where do the prices come from?

From the Spanish government's open data (MITECO), refreshed every 4 hours.

### Are there usage limits?

The README lists 120 requests a minute per client IP, 600 a minute per instance and 100 route searches a day.

### Can I run it myself?

Yes. It is MIT licensed, written in Python 3.12 with the MCP Python SDK, and needs a TankoUp API key to run.

### Is TankoUp free?

Yes. TankoUp is open source, so you can use and self-host it for free.

### How do I add TankoUp to Claude Code?

Run this command in your terminal: claude mcp add --transport http tankoup https://mcp.tankoup.com/mcp

### What are the best alternatives to TankoUp?

The closest alternatives to TankoUp are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/tankoup
