# ZenSched Location Search

> ZenSched Location Search is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Search your organization's locations by name or address, optionally filtered by proximity to a geographic coordinate

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/tools/location_search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-location-search-e9e58a15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vjscxXL98ksCEQiNFreh4

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-location-search-e9e58a15
```

Example prompt: Search my ZenSched locations for any branches with 'downtown' in the name, and also show me any that are within 20 km of 40.7128, -74.0060.

## When to prefer this

Use this endpoint when you need to find existing locations already registered in your ZenSched organization by name, address fragment, or geographic proximity. Prefer this over manual record-keeping or broader geocoding services when you specifically need to query your own scheduling org's location inventory. Not suitable for discovering new locations outside your org or for general-purpose geocoding.

## Known failure modes

- No locations found matching query — returns empty result set
- Invalid near_lat/near_lng values (out of range) may return an error or unexpected results
- radius_km of 0 with coordinates may return no proximity results
- Payment failure or wallet not provisioned results in 402 error
- Org has no locations yet — returns empty list

## How this service works

ZenSched `location_search` — Search YOUR org's locations by name/address; optional near_lat/near_lng + radius_km filter. Pay-per-call $0.01 USDC; the paying wallet owns the org (auto-provisioned on first call). Catalog: https://mcp.zensched.com/x402/tools

## Output

Returns a list of matching location records from the caller's organization, filtered by the name/address query string and optionally narrowed to those within the specified radius of the given coordinates. Each record includes location identifiers, name, and address details.

## 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",
     "title": "location_searchArguments",
     "properties": {
      "query": {
       "type": "string",
       "title": "Query",
       "default": ""
      },
      "near_lat": {
       "type": "number",
       "title": "Near Lat",
       "default": 0
      },
      "near_lng": {
       "type": "number",
       "title": "Near Lng",
       "default": 0
      },
      "radius_km": {
       "type": "number",
       "title": "Radius Km",
       "default": 50
      }
     }
    }
   },
   "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-location-search-e9e58a15/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)
