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 分