fuel_price
Pack: fuel-prices · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fuel_price for the schema, then POST the same URL with its arguments for the data.
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 — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the fuel-prices pack
{
"mcpServers": {
"fuel-prices": {
"url": "https://gateway.pipeworx.io/fuel-prices/mcp"
}
}
}
See Getting Started for client-specific install steps.