{"uid":"cap_uQ9mLXQ8hwI8h6kiisWcE","slug":"kviria-natural-language-place-resolver-10e9ea4c","name":"Kviria Natural-Language Place Resolver","description":"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.","url":"https://api.kviria.com/mcp?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N_02SSVWI7ZK8NYIspebm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Voice-driven navigation destination lookup","prompt":"I'm driving and said 'take me to the bakery next to the post office' — I'm currently at latitude 37.7749, longitude -122.4194. Can you figure out exactly which bakery I mean and get me the coordinates?"},{"title":"Resolving an ambiguous hotel reference for a guest","prompt":"My guest said 'meet me at my hotel near the convention center' — I'm at 32.7767, -96.7970 in Dallas. Can you resolve which hotel they most likely mean and give me the exact location?"},{"title":"Finding a nearby category match from a vague description","prompt":"I'm at 41.8781, -87.6298 in Chicago and I'm looking for 'the coffee shop across from the big park' — can you find the single best match and give me its verified coordinates?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T00:43:39.710Z","isFirstParty":false,"canonicalSlug":"kviria-natural-language-place-resolver-10e9ea4c"}