Forward geocoding — Place name → coordinates, country, timezone

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x1831f336585a6C67B6A954d28f3E07F44C4EEBbd",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "maxTimeoutSeconds": 120
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "count": "Max results 1-10 — e.g. 3",
          "country": "ISO-3166 alpha-2 filter — e.g. GB",
          "q": "Place name to search — required — e.g. London"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "count": 3,
          "query": "London",
          "results": [
            {
              "country": "United Kingdom",
              "countryCode": "GB",
              "latitude": 51.50853,
              "longitude": -0.12574,
              "name": "London"
            }
          ]
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://mcpfax-utility.bowling-anthony.workers.dev/v1/geocode"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://mcpfax-utility.bowling-anthony.workers.dev/v1/geocode");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://mcpfax-utility.bowling-anthony.workers.dev/v1/geocode")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header