Agent Time & Place

{
  "name": "Agent Time & Place",
  "description": "Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).",
  "url": "https://agent-gateway.agent-utils.workers.dev/a2a",
  "version": "0.1.0",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "Agent Utils",
    "url": "https://agent-gateway.agent-utils.workers.dev"
  },
  "documentationUrl": "https://time-place.agent-utils.workers.dev/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "required": true,
        "description": "Tasks are paid with x402 (USDC). Send a DataPart {skill, input}."
      }
    ]
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "time_place_geocode",
      "name": "geocode",
      "description": "Forward geocoding at city level. Use when you have a city name (any language, optional country filter) and need coordinates, country, region, population and IANA timezone. Covers 34,000+ cities with population over 15,000 (GeoNames). Not for street addresses. Price: $0.005 per call.",
      "tags": [
        "geocoding",
        "location",
        "timezone",
        "cities"
      ],
      "examples": [
        "{\"skill\":\"time_place_geocode\",\"input\":{\"q\":\"Munich\",\"country\":\"DE\",\"limit\":3}}"
      ]
    },
    {
      "id": "time_place_reverse",
      "name": "reverse",
      "description": "Reverse geocoding: coordinates to nearest city, country, region and IANA timezone with distance. Use when you have lat/lon from a device, photo or map and need a human-readable place plus its timezone. Price: $0.005 per call.",
      "tags": [
        "geocoding",
        "reverse-geocoding",
        "location",
        "timezone"
      ],
      "examples": [
        "{\"skill\":\"time_place_reverse\",\"input\":{\"lat\":40.4168,\"lon\":-3.7038}}"
      ]
    },
    {
      "id": "time_place_timezone",
      "name": "timezone",
      "description": "Timezone for coordinates, a city name, or an IANA id: current UTC offset, DST status, abbreviation and local time right now. Use before scheduling, converting times, or telling a user what time it is somewhere. Price: $0.005 per call.",
      "tags": [
        "timezone",
        "time",
        "dst",
        "scheduling"
      ],
      "examples": [
        "{\"skill\":\"time_place_timezone\",\"input\":{\"city\":\"Tokyo\"}}"
      ]
    },
    {
      "id": "time_place_holidays",
      "name": "holidays",
      "description": "Public holidays for a country and year (110+ countries), with nationwide vs regional flags and local names. Use when planning deadlines, deliveries, meetings or travel and you need to know which days are off. Price: $0.005 per call.",
      "tags": [
        "holidays",
        "calendar",
        "scheduling",
        "business-days"
      ],
      "examples": [
        "{\"skill\":\"time_place_holidays\",\"input\":{\"country\":\"FR\",\"year\":2026}}"
      ]
    },
    {
      "id": "time_place_business_days",
      "name": "business-days",
      "description": "Business-day arithmetic that respects weekends and a country's public holidays. Either add N business days to a date (SLA due dates, shipping ETAs) or count business days between two dates. Weekend days are configurable (e.g. 'fri,sat'). Price: $0.005 per call.",
      "tags": [
        "business-days",
        "calendar",
        "sla",
        "scheduling",
        "holidays"
      ],
      "examples": [
        "{\"skill\":\"time_place_business_days\",\"input\":{\"country\":\"US\",\"from\":\"2026-11-25\",\"add\":3}}"
      ]
    },
    {
      "id": "time_place_sun",
      "name": "sun",
      "description": "Sunrise, sunset, dawn, dusk, golden hour, solar noon, day length and current moon phase for a coordinate and date, in UTC and local time. Handles polar day/night. Use for photography, outdoor scheduling, energy or travel planning. Price: $0.005 per call.",
      "tags": [
        "sun",
        "sunrise",
        "sunset",
        "astronomy",
        "moon"
      ],
      "examples": [
        "{\"skill\":\"time_place_sun\",\"input\":{\"lat\":59.9139,\"lon\":10.7522,\"date\":\"2026-06-21\"}}"
      ]
    },
    {
      "id": "time_place_convert",
      "name": "convert",
      "description": "Currency conversion and exchange rates for 160+ currencies, updated daily (ECB and open.er-api). Use when an agent needs to quote, compare or normalize prices across currencies. Returns rate, converted amount and the rate timestamp. Price: $0.005 per call.",
      "tags": [
        "currency",
        "fx",
        "exchange-rate",
        "finance",
        "pricing"
      ],
      "examples": [
        "{\"skill\":\"time_place_convert\",\"input\":{\"from\":\"USD\",\"to\":\"EUR\",\"amount\":100}}"
      ]
    },
    {
      "id": "time_place_distance",
      "name": "distance",
      "description": "Great-circle distance and initial bearing between two coordinates or two city names, in km, miles and nautical miles, plus the timezone difference between the two places. Use for travel, logistics and 'how far / which direction' questions. Price: $0.005 per call.",
      "tags": [
        "distance",
        "geodesy",
        "travel",
        "logistics"
      ],
      "examples": [
        "{\"skill\":\"time_place_distance\",\"input\":{\"from\":\"Lisbon\",\"to\":\"Sao Paulo\"}}"
      ]
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://agent-gateway.agent-utils.workers.dev/mcp",
      "transport": "MCP"
    },
    {
      "url": "https://time-place.agent-utils.workers.dev/openapi.json",
      "transport": "HTTP+x402"
    }
  ]
}