TankoUp

io.github.aalzres由 GitHub 帳號 aalzres 發布v0.1.0更新於 Nov 3, 2026

西班牙最便宜的燃油：約12,000個加油站的即時價格，可檢視附近或沿途的加油站。

AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。

原文描述

Cheapest fuel in Spain: live prices at ~12,000 petrol stations, near a place or along a route.

已驗證Streamable HTTP可網頁執行

概覽

TankoUp 的託管 MCP 服務（mcp.tankoup.com）；無需登入；Streamable HTTP；4 個工具。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

端點
mcp.tankoup.com
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TankoUp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.aalzres%2Ftankoup/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

TankoUp MCP server

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.

  • Endpoint: https://mcp.tankoup.com/mcp (Streamable HTTP)
  • Authentication: none. The data is public and the tools only read it.

"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?"

Tools

ToolWhat it answers
find_cheapest_fuel_nearbyThe best stations near a town, city or point, for one fuel
find_cheapest_fuel_on_routeThe best stations along a driving route, up to 1,200 km
get_province_fuel_pricesAverage and lowest prices in a province, its 30-day trend, how it compares with Spain, and its cheapest stations
get_station_detailsEvery fuel's price at one station, its opening hours, address and links

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.

Connect

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:

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

Any other client that speaks Streamable HTTP: point it at https://mcp.tankoup.com/mcp.

[Claude answering with the TankoUp connector]

How it works

Claude / ChatGPT ──MCP──▶ tankoup-mcp (Cloud Run) ──HTTPS──▶ TankoUp API ──▶ Postgres                                                     (the API the app and website use,                                                      fed from MITECO every 4 hours)
  • Python with the official MCP Python SDK (v2), served over Streamable HTTP in stateless mode with JSON responses, so any instance can answer any request.
  • The server owns no data. Every price comes from the same API that serves the TankoUp apps and website; it never touches the database or the government feed.
  • Place names resolve offline against a gazetteer of every Spanish municipality with a fuel station (src/tankoup_mcp/data/places.json, built from the API by scripts/build_places.py). No geocoding service, no third party.
  • Answers are cached in memory for 10 minutes.
  • Limits: 120 requests a minute per client IP and 600 a minute per instance, at most one instance, and 100 route searches a day.
  • Runs on Google Cloud Run in europe-west1 (Belgium), scaling to zero when idle.

Privacy

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.

Run it yourself

Requires Python 3.12+ and uv.

bash
uv syncTANKOUP_API_KEY=... uv run uvicorn tankoup_mcp.app:app --port 8000

Then open MCP Inspector against http://localhost:8000/mcp:

bash
npx @modelcontextprotocol/inspector
VariableDefault
TANKOUP_API_KEY—Key for the TankoUp API
TANKOUP_API_URLhttps://api.tankoup.com
CACHE_TTL_S600How long answers are cached
RATE_LIMIT_PER_IP120Requests to /mcp per client IP per minute
RATE_LIMIT_GLOBAL600Requests to /mcp per instance per minute
ROUTE_DAILY_LIMIT100Route searches per instance per day
ALLOWED_HOSTSemptyHost allowlist; empty turns DNS-rebinding protection off, which is right behind Cloud Run

Tests

bash
uv run pytest

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:

bash
uv run python scripts/smoke.py https://mcp.tankoup.com/mcp

Deploy

bash
scripts/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

License

MIT. Fuel price data: Ministerio para la Transición Ecológica y el Reto Demográfico (MITECO), Spain, open data.

來源：README.md，提交 9e4a52d

工具

4

find_cheapest_fuel_nearby

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.

輸入參數latlngfuel必填limitplaceopen_nowradius_km

find_cheapest_fuel_on_route

Cheapest 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.

輸入參數fuel必填limitorigin必填open_nowdestination必填

get_province_fuel_prices

Fuel 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.

輸入參數fuelprovince必填

get_station_details

Petrol station details

Everything about one petrol station: every fuel's current price, opening hours, address and links.

輸入參數latlngstation_id必填

版本歷史

1
  1. v0.1.0最新Nov 3, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分