fuel_price_history
Pack: fuel-prices · Endpoint: https://gateway.pipeworx.io/fuel-prices/mcp
How fuel prices have moved in one European country over time — a weekly series of pump prices with the change over the period. Answers “how much has petrol gone up in Germany this year”, “diesel price trend in France”, “was fuel cheaper last summer in Italy”, and questions about whether a rise is recent or long-running. Returns each week’s price per litre plus the first and last values, the absolute and percentage change, and the highest and lowest weeks in the window. Weekly series from the European Commission’s Weekly Oil Bulletin, available back to 2005.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
country | string | yes | Country name or two-letter code, e.g. “France”, “FR”. |
fuel | string | no | petrol (default), diesel, lpg, heating_oil. |
weeks | number | no | How many recent weeks to return (default 26, max 520 — 520 is ten years). |
since | string | no | Optional YYYY-MM-DD start date instead of a week count. |
Example call
Arguments
{
"country": "France",
"fuel": "petrol",
"weeks": 26
}
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_history","arguments":{"country":"France","fuel":"petrol","weeks":26}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('fuel_price_history', {
"country": "France",
"fuel": "petrol",
"weeks": 26
});
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.