Geocode Lookup

Forward/reverse geocoding and great-circle distance calculations.

Address to coordinates (forward geocoding), coordinates to address (reverse geocoding), and Haversine distance calculations.

Data Handling

This skill sends addresses and coordinates to an external API. Do not send private addresses without explicit user consent. The service does not store or log input data beyond the immediate response.

Endpoints

Forward Geocode

curl -X POST https://geocode.agentutil.net/v1/forward \
  -H "Content-Type: application/json" \
  -d '{"address": "Auckland, New Zealand"}'

Optional: limit (1-5, default 1).

Reverse Geocode

curl -X POST https://geocode.agentutil.net/v1/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat": -36.8485, "lon": 174.7633}'

Distance

curl -X POST https://geocode.agentutil.net/v1/distance \
  -H "Content-Type: application/json" \
  -d '{"from": {"address": "London, UK"}, "to": {"address": "New York, US"}, "unit": "km"}'

Units: km, mi, m, nm. Accepts {lat, lon} or {address} for both endpoints.

Response Format

{
  "results": [
    {"lat": -36.8485, "lon": 174.7633, "display_name": "Auckland, New Zealand", "type": "city"}
  ],
  "request_id": "abc-123",
  "service": "https://geocode.agentutil.net"
}

Pricing

• Free tier: 10 queries/day, no authentication required
• Paid tier: $0.001/query via x402 protocol (USDC on Base)

Privacy

No authentication required for free tier. No personal data collected. Rate limiting uses IP hashing only.