# Kviria Natural-Language Place Resolver

> Kviria Natural-Language Place Resolver is a paid API for AI agents from api.kviria.com, paid per call via x402, $1/call, status unknown (last checked 2026-11-03).

Resolves a user's natural-language place reference (e.g. 'the cafe near the bookstore', 'my hotel') into a single verified coordinate with an evidence trail, covering the contiguous United States.

## Facts

- Endpoint: POST https://api.kviria.com/mcp?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kviria-natural-language-place-resolver-10e9ea4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uQ9mLXQ8hwI8h6kiisWcE

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 kviria-natural-language-place-resolver-10e9ea4c -d '<json body>'
```

Example prompt: I'm at 40.7128, -74.0060 — can you figure out exactly which place I mean by 'the little Italian spot near the library' and give me the verified coordinates?

## When to prefer this

Choose this endpoint when a user has described a place in natural or spoken language (e.g. 'the café near my office', 'that bookstore downtown') and you need to resolve it to a single verified coordinate rather than a list of candidates. It is especially valuable in voice-first or conversational agents where place references are inherently ambiguous and disambiguation against a known anchor position is required. Prefer it over generic geocoding when the input is vague, relational, or context-dependent rather than a structured address or proper business name.

## Known failure modes

- Ambiguous reference that cannot be resolved to a single place — returns error or low-confidence result
- Location outside contiguous United States — not supported in beta
- Missing or imprecise anchor coordinates causing incorrect disambiguation
- Category labels not recognized or too broad — empty result set
- Both 'intent' and 'transcript' omitted — insufficient input to resolve place

## How this service works

Resolve a user's natural-language place reference - "the cafe near the bookstore", "my hotel", "here" - into exactly one verified coordinate with an evidence trail. Coverage: the contiguous United States (beta). This payment tops up a prepaid USDC balance: any amount at or above one turn's price ($0.005); the first 50 turns per day are free with a wallet sign-in - see docs.kviria.com/api/agent.

## Output

A single verified coordinate pair (latitude and longitude) pinpointing the exact place the user referred to, along with an evidence trail showing how the resolution was made. The response confirms which specific real-world venue matched the natural language reference.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string",
   "maxLength": 2263,
   "description": "The `state` field of the previous kviria response, copied character for character: that field only, never the whole response, and never shortened. Empty string on the first call."
  },
  "anchor": {
   "type": "object",
   "required": [
    "lat",
    "lng"
   ],
   "properties": {
    "lat": {
     "type": "number",
     "maximum": 90,
     "minimum": -90,
     "description": "WGS 84 latitude"
    },
    "lng": {
     "type": "number",
     "maximum": 180,
     "minimum": -180,
     "description": "WGS 84 longitude"
    }
   },
   "description": "The user's current position - Kviria resolves relative to this point. Required on the first call of a conversation; later calls may leave it out while the user has not moved.",
   "additionalProperties": false
  },
  "rangeM": {
   "type": "integer",
   "default": 100,
   "maximum": 350,
   "minimum": 50,
   "description": "Search radius around the anchor in meters (clamped to 50-350)."
  },
  "transcript": {
   "type": "string",
   "maxLength": 1000,
   "minLength": 1,
   "description": "The user's whole last turn, word for word: yes or no, corrections, hesitations and everything around the place included. Never shorten, rephrase, correct or complete it. If one turn arrived in pieces, join them in order."
  },
  "confirmation": {
   "enum": [
    "on",
    "off"
   ],
   "type": "string",
   "default": "on",
   "description": "\"on\" (default): a place the user named only in part is returned as one_unconfirmed, and its coordinate is released only after the user verifies it. \"off\": it is returned as one immediately, for agents without a human in the loop."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kviria-natural-language-place-resolver-10e9ea4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kviria.com](https://www.zero.xyz/host/api.kviria.com/llms.txt)