fuel_price
Pack: fuel-prices · Endpoint: https://gateway.pipeworx.io/fuel-prices/mcp
What does petrol cost in a European country right now — the current pump price per litre for petrol, diesel or LPG in any of 28 countries. Answers “how much is petrol in Portugal”, “what does diesel cost in Germany”, “price of gas in Ireland”, “how much to fill up in Spain”. Takes a country name or two-letter code and a fuel (defaults to petrol), and returns the price per litre in euros both including and excluding tax, the tax share as a percentage, and the week the figure is for. Reported weekly by EU Member States to the European Commission’s Weekly Oil Bulletin, so it is a national average for that week rather than one filling station’s sign. Fuels: ${FUEL_LIST}.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
country | string | yes | Country name or two-letter code — “Portugal”, “PT”, “Germany”, “DE”. Use “EU” for the EU-wide average. |
fuel | string | no | Which fuel: petrol (default), diesel, lpg, heating_oil. Forgiving about wording — “gas”, “gasoline”, “unleaded” and “autogas” all resolve. |
week_ending | string | no | Optional YYYY-MM-DD to read a past week instead of the latest. Returns the most recent week on or before this date. |
Example call
Arguments
{
"country": "Portugal"
}
curl
curl -X POST https://gateway.pipeworx.io/fuel-prices/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fuel_price","arguments":{"country":"Portugal"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('fuel_price', {
"country": "Portugal"
});
More examples
{
"country": "Germany",
"fuel": "diesel"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"fuel-prices": {
"url": "https://gateway.pipeworx.io/fuel-prices/mcp"
}
}
}
See Getting Started for client-specific install steps.