Fuel Prices ANZ - MCP Server

An Apify MCP Server that provides real-time fuel price search capabilities for AI agents in Australia and New Zealand via the Model Context Protocol (MCP).

Standby Mode

This Actor uses Standby mode, a new, lightweight method for using Actors. Instead of starting an Actor for each input and waiting for results, the Actor remains ready in the background to handle arbitrary HTTP requests, just like any web or API server. Learn more.

Actor URL

Send an HTTP request to this URL, and wait for the response:

https://YOUR_USERNAME--fuel-prices-anz-mcp-server.apify.actor?token=YOUR_APIFY_TOKEN

The MCP endpoint is available at /mcp:

https://YOUR_USERNAME--fuel-prices-anz-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

About this MCP Server

To understand how to connect to and utilize this MCP server, please refer to the official Model Context Protocol documentation at mcp.apify.com.

How It Works

This MCP server does not require any input query at startup. Instead:

1. The server starts and exposes 4 fuel price tools via MCP protocol
2. MCP clients (Claude, GPT, etc.) connect to the server
3. When the AI needs fuel price data, it calls a tool with the location parameters

Example tool call from an MCP client:

{
  "method": "tools/call",
  "params": {
    "name": "find_cheapest_fuel",
    "arguments": {
      "address": "Sydney CBD",
      "fuel_type": "U91",
      "radius_km": 5
    }
  }
}

Features

• 4 Fuel Price Tools: Search stations, find cheapest fuel, get price summaries, geocode addresses
• AU & NZ Coverage: Supports all Australian states and New Zealand regions
• Offline Geocoding: Local postcode datasets - no external API dependencies
• Real-Time Prices: Current fuel prices from PetrolSpy
• MCP Compatible: Works with Claude, GPT, and other MCP-enabled clients

Available Tools

search_fuel_stations

Search for petrol/fuel stations near a location. Returns all nearby stations with current prices.

Parameters:

• address: Search by suburb, postcode, or address (e.g., "Sydney CBD", "3168", "Clayton VIC")
• lat: Latitude coordinate (use with lng if no address)
• lng: Longitude coordinate (use with lat if no address)
• radius_km: Search radius in km (1-50, default: 5)

Example Response:

{
  "searchLocation": {
    "lat": -33.8688,
    "lng": 151.2093,
    "address": "Sydney, NSW 2000, AU"
  },
  "radiusKm": 5,
  "totalStations": 42,
  "stations": [
    {
      "stationId": "...",
      "name": "7-Eleven Sydney",
      "brand": "7-Eleven",
      "location": {...},
      "prices": {
        "U91": {"price": 165.9, "updatedAt": 1733123456789},
        "E10": {"price": 159.9, "updatedAt": 1733123456789},
        "U95": {"price": 179.9, "updatedAt": 1733123456789}
      }
    }
  ]
}

find_cheapest_fuel

Find the cheapest fuel of a specific type near a location.

Parameters:

• address: Search by suburb, postcode, or address
• lat/lng: GPS coordinates (alternative to address)
• radius_km: Search radius in km (default: 5)
• fuel_type: Fuel type to find (U91, E10, U95, U98, Diesel, LPG)

Example Response:

{
  "searchLocation": {"lat": -33.8688, "lng": 151.2093},
  "radiusKm": 5,
  "fuelType": "U91",
  "cheapest": {
    "name": "Metro Petroleum",
    "brand": "Metro",
    "price": 155.9,
    "location": {...}
  },
  "totalStationsSearched": 42
}

get_fuel_price_summary

Get a summary of fuel prices (min, max, average) for all fuel types near a location.

Parameters:

• address: Search by suburb, postcode, or address
• lat/lng: GPS coordinates (alternative to address)
• radius_km: Search radius in km (default: 5)

Example Response:

{
  "searchLocation": {...},
  "radiusKm": 5,
  "totalStations": 42,
  "priceSummary": {
    "U91": {"min": 155.9, "max": 175.9, "avg": 165.4, "count": 38},
    "E10": {"min": 149.9, "max": 169.9, "avg": 159.2, "count": 35},
    "Diesel": {"min": 165.9, "max": 189.9, "avg": 177.5, "count": 40}
  },
  "generatedAt": "2024-12-04T10:30:00.000Z"
}

geocode_address

Convert an Australian or New Zealand address/suburb/postcode to coordinates.

Parameters:

• address: Address to geocode (e.g., "Sydney", "3168", "Clayton VIC", "Auckland")

Example Response:

{
  "lat": -33.8688,
  "lng": 151.2093,
  "address": "Sydney, NSW 2000, AU",
  "locality": "Sydney",
  "state": "NSW",
  "postcode": "2000",
  "country": "AU"
}

Configuration

The server accepts the following configuration options:

Option	Type	Default	Description
defaultRadiusKm	number	5	Default search radius in kilometers
proxy	object	null	Proxy configuration

Supported Fuel Types

Code	Description
U91	Unleaded 91
E10	Ethanol 10
U95	Unleaded 95
U98	Unleaded 98
Diesel	Diesel
LPG	Liquefied Petroleum Gas
PremDSL	Premium Diesel

Supported Regions

Australia

All states and territories: NSW, VIC, QLD, SA, WA, TAS, NT, ACT

New Zealand

All regions including Auckland, Wellington, Canterbury, Otago, and more

Use Cases

• AI Assistants: Let Claude or GPT find the cheapest fuel for users
• Chatbots: Build fuel price chatbots with real-time data
• Automation: Integrate fuel prices into automated workflows
• Analysis: Feed fuel price data into AI models for trend analysis