Skip to main content
Kviria finds the place, address or street corner a user means near their current position. Your agent parses the user’s words into a request: its type, and the place, kind, streets or address the user gave. Kviria looks the place up in its map data, and returns it with its coordinate and the evidence for the answer. Kviria never receives the user’s words. It returns data only, and your agent writes the reply. Call the HTTP endpoint, POST /v1/agent, or connect the MCP server. Both answer the same way.

​
How a turn works

Each call carries three things:
  • the request: its type (find, search, near, across, next_to, corner, street_end, pick or confirm) and the fields the user gave, such as place, kind or streets.
  • state: the state field of the previous response. Send an empty string on the first call.
  • anchor: the user’s position. Send it on the first call, and after that only when the user moves.
Each response carries one decision: The user’s next turn becomes the next call, with the new state. The conversation narrows until one place remains. See Narrowing.

​
Why your agent needs it

A language model guesses places. It invents coordinates, distances and names. Kviria answers only with places that exist in its map data, and returns their names, categories, distances and coordinates as it has them. Each answer lists the checks behind it in an evidence array (see Determinism and evidence). When the user names a place only in part, its coordinate waits for the user’s yes (Confirmation). When nothing matches, the answer is none. Kviria does not make up a place to fill the gap.

​
Coverage

Kviria is in beta and covers the contiguous United States: latitude 24.4 to 49.5, longitude -125.0 to -66.8. A position outside it gets none with an out_of_coverage evidence entry, and that turn is never charged. See Coverage.

​
Your first call

$KVIRIA_KEY is a key from api.kviria.com/key. MCP clients connect in one click instead: see Connect and pay. The Quickstart walks through a whole conversation. To try Kviria without code, open the Playground. Your agent can also read the skill directly.