FuelScout

{
  "protocolVersion": "1.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. A ScalpStream agent.",
  "author": "FuelScout",
  "wellKnownURI": "https://fuelscout.scalpstream.com/.well-known/agent-card.json",
  "url": "https://fuelscout.scalpstream.com/a2a",
  "version": "1.0.0",
  "provider": {
    "organization": "ScalpStream",
    "url": "https://fuelscout.scalpstream.com/"
  },
  "documentationUrl": "https://fuelscout.scalpstream.com/.well-known/x402",
  "iconUrl": "https://fuelscout.scalpstream.com/icon.png",
  "supportsAuthenticatedExtendedCard": false,
  "security": [],
  "securitySchemes": {
    "x402": {
      "in": "header",
      "name": "PAYMENT-SIGNATURE",
      "type": "apiKey",
      "apiKeySecurityScheme": {
        "name": "PAYMENT-SIGNATURE",
        "location": "header",
        "description": "x402 payment for the paid HTTP resources only (https://fuelscout.scalpstream.com/fuel): a signed payment payload per the 402 challenge at that URL. The A2A endpoint needs no credential."
      }
    }
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "params": {
          "assets": [
            "USDC",
            "SOL",
            "XRP",
            "RLUSD"
          ],
          "networks": [
            "eip155:8453",
            "eip155:42161",
            "eip155:137",
            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
            "xrpl:0"
          ],
          "priceUSD": "0.01",
          "resource": "https://fuelscout.scalpstream.com/fuel",
          "discovery": "https://fuelscout.scalpstream.com/.well-known/x402"
        },
        "description": "Paid data is settled over x402 (HTTP 402). The A2A endpoint itself is free."
      },
      {
        "uri": "https://a2a-registry.org/extensions/registry/v1",
        "params": {
          "payment": {
            "model": "freemium",
            "rails": [
              {
                "type": "stablecoin",
                "caip2": "eip155:8453",
                "token": "USDC",
                "network": "base",
                "feeModel": "low",
                "protocol": "x402",
                "settlementTime": "fast",
                "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
              },
              {
                "type": "stablecoin",
                "caip2": "eip155:42161",
                "token": "USDC",
                "network": "arbitrum",
                "feeModel": "low",
                "protocol": "x402",
                "settlementTime": "fast",
                "contractAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
              },
              {
                "type": "stablecoin",
                "caip2": "eip155:137",
                "token": "USDC",
                "network": "polygon",
                "feeModel": "low",
                "protocol": "x402",
                "settlementTime": "fast",
                "contractAddress": "0x3c499c542cEF5E3811e1192ce70d8cc03d5c3359"
              },
              {
                "type": "stablecoin",
                "caip2": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "token": "USDC",
                "network": "solana",
                "feeModel": "low",
                "protocol": "x402",
                "settlementTime": "fast",
                "contractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              },
              {
                "type": "crypto",
                "caip2": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "token": "SOL",
                "network": "solana",
                "feeModel": "low",
                "protocol": "x402",
                "settlementTime": "fast",
                "contractAddress": "So11111111111111111111111111111111111111112"
              },
              {
                "type": "crypto",
                "caip2": "xrpl:0",
                "token": "XRP",
                "network": "xrpl",
                "feeModel": "feeless",
                "protocol": "x402",
                "settlementTime": "instant"
              },
              {
                "type": "stablecoin",
                "caip2": "xrpl:0",
                "token": "RLUSD",
                "network": "xrpl",
                "feeModel": "feeless",
                "protocol": "x402",
                "settlementTime": "instant"
              }
            ],
            "direction": "inbound",
            "protocols": [
              "x402"
            ]
          },
          "identity": {
            "domain": "scalpstream.com",
            "provider": "domain",
            "packageName": "com.scalpstream.fuelscout"
          }
        },
        "description": "a2a-registry.org identity hint and payment capabilities (advisory)."
      }
    ]
  },
  "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",
  "category": "real-world-services",
  "category_secondary": null
}