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: json { "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: json { "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: json { "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: json { "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: json { "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