# ZenSched Geocode — Address to GPS Pin

> ZenSched Geocode — Address to GPS Pin is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-18).

Converts a street address into GPS coordinates, resolves it to a Google Places establishment pin when applicable, and returns lat/lng, pin quality, IANA timezone, and map links.

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/geocode?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-geocode-address-to-gps-pin-0d9e352d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aDu8q2Jwxtg14pQRvk7gF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zensched-geocode-address-to-gps-pin-0d9e352d
```

Example prompt: What are the GPS coordinates and timezone for the Starbucks at 1234 Market Street, San Francisco, CA? I need the lat/lng and an IANA timezone so I can set it up as a job site.

## When to prefer this

Use this endpoint when you need to resolve a raw street address into precise GPS coordinates with timezone data, especially within the ZenSched ecosystem (e.g. before calling location_create). It is particularly valuable when you also have a business name and want the accuracy boost of a Google Places establishment pin. Prefer it over generic geocoding APIs when operating within ZenSched workflows, since it uses the same resolver as the platform's own location creation logic.

## Known failure modes

- Address not recognized or too ambiguous — geocoder cannot resolve to a coordinate
- Business name provided but no matching Google Places establishment found — falls back to address-level pin
- Malformed or missing address parameter — returns validation error
- Rate limit or payment failure — x402 payment not processed
- Address resolves to a region rather than a specific point — low pin_quality returned

## How this service works

Street address → GPS check-in pin. Geocodes the address, upgrades to the Google Places establishment pin when it is the same site, and returns lat/lng, pin_quality, IANA timezone and map links. Same resolver ZenSched uses for location_create.

## Output

Returns the resolved latitude and longitude, a pin_quality indicator (e.g. rooftop, street, centroid), the IANA timezone string for the location, map links (e.g. Google Maps URL), and — when the address matches a Google Places establishment — an upgraded establishment-level GPS pin for greater accuracy.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Business / site name; improves the Places establishment match."
      },
      "address": {
       "type": "string",
       "description": "Street address to resolve."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zensched-geocode-address-to-gps-pin-0d9e352d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.zensched.com](https://www.zero.xyz/host/mcp.zensched.com/llms.txt)