FuelScout

{
  "protocolVersion": "0.3.0",
  "name": "FuelScout",
  "description": "Machine-payable cheapest-fuel queries over x402. Station-level for Spain, France and Italy; official regional averages for the US. Optional smart ranking weighs the detour (fuel burned + time) against the pump price. Prices are official open data and may be delayed — confirm at the pump.",
  "author": "FuelScout",
  "wellKnownURI": "https://fuelscout.scalpstream.com/.well-known/agent-card.json",
  "url": "https://fuelscout.scalpstream.com/a2a",
  "version": "1.0.0",
  "provider": {
    "organization": "FuelScout",
    "url": "https://fuelscout.scalpstream.com/"
  },
  "documentationUrl": "https://fuelscout.scalpstream.com/.well-known/x402",
  "iconUrl": "https://fuelscout.scalpstream.com/icon.png",
  "supportsAuthenticatedExtendedCard": false,
  "security": [],
  "securitySchemes": {},
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "params": {
          "assets": [
            "XRP",
            "RLUSD",
            "USDC"
          ],
          "networks": [
            "xrpl:0",
            "eip155:8453",
            "eip155:42161",
            "eip155:137"
          ],
          "priceUSD": "0.01",
          "resource": "https://fuelscout.scalpstream.com/fuel",
          "discovery": "https://fuelscout.scalpstream.com/.well-known/x402"
        },
        "required": false,
        "description": "Paid data is settled over x402 (HTTP 402). The A2A endpoint itself is free."
      }
    ]
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "cheapest-fuel",
      "name": "cheapest fuel near a location",
      "description": "Given a country + coordinates (ES/FR/IT) or a US region, returns the cheapest stations (or the regional average) for a fuel grade, optionally ranked by all-in cost including the round-trip detour.",
      "tags": [
        "fuel",
        "gas",
        "petrol",
        "diesel",
        "gasoline",
        "lpg",
        "prices",
        "cheapest",
        "gas station",
        "fuel prices",
        "x402",
        "spain",
        "france",
        "italy",
        "usa",
        "europe",
        "unleaded",
        "autogas",
        "e5",
        "e10",
        "sp98",
        "diesel premium",
        "petrol station",
        "fill up",
        "fuel economy",
        "cheapest fuel"
      ],
      "examples": [
        "cheapest diesel near Madrid",
        "gas prices in California",
        "how much to query fuel prices"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "regional-fuel-averages",
      "name": "regional fuel price averages (US)",
      "description": "Official EIA weekly averages for US states and PADD regions, for callers outside the three countries where station-level open data exists.",
      "tags": [
        "fuel prices",
        "gas prices",
        "EIA",
        "average",
        "regional",
        "state",
        "US",
        "USA",
        "weekly",
        "benchmark",
        "diesel",
        "gasoline",
        "x402"
      ],
      "examples": [
        "average gas price in Texas",
        "US diesel average this week",
        "what does fuel cost in Washington state"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "detour-aware-ranking",
      "name": "is the cheaper station worth the drive",
      "description": "Ranks nearby stations by ALL-IN cost — pump price plus the fuel burned and time spent on the round-trip detour — so a cheaper forecourt further away is only recommended when it actually saves money.",
      "tags": [
        "smart ranking",
        "detour",
        "all-in cost",
        "total cost",
        "route",
        "fuel economy",
        "worth the drive",
        "optimisation",
        "x402"
      ],
      "examples": [
        "cheapest diesel near Madrid worth the detour",
        "is the cheaper station worth driving to from Lyon",
        "best value fuel within 10 km of Milan"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    }
  ],
  "conformance": true,
  "conformance_errors": null,
  "homepage": null,
  "repository": null,
  "license": null,
  "pricing": null,
  "contact": null,
  "id": "40e38e39-c2fb-4d85-a32d-dcdc05007439"
}