Skip to main content

​
Where does Kviria work?

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. More areas are planned.

​
What should my agent do on a none?

Take it as it is: Kviria looked and found nothing. Do not try other house numbers. Ask the user for a nearby business or landmark instead, and send that. If you are evaluating Kviria for a particular area, write to hello@kviria.com and ask how well that area is covered.

​
How do I integrate Kviria?

Call POST /v1/agent with a Kviria key, or connect the MCP server in one click. On every turn of a place conversation, your agent parses the user’s words into the request’s fields and sends them with the state of the last response. Send the user’s position on the first call, and give your agent Kviria’s system prompt. Add Kviria to your agent walks through the steps. The skill holds the whole contract, and your agent can read it directly.

​
Where does the map data come from?

Kviria’s map data comes from Overture Maps Foundation and its sources. © OpenStreetMap contributors, Overture Maps Foundation
  • Streets, crossings and buildings are made in whole or in part from OpenStreetMap data, available under the Open Database License.
  • Places come from several sources, under the CDLA Permissive 2.0 license, the Apache 2.0 license and CC0.
  • Addresses come from the U.S. Department of Transportation’s National Address Database and from county and state sources, distributed by OpenAddresses.
Every source and its terms are listed on Overture’s attribution page. Some of the places come from Foursquare OS Places. Its notice:
© 2026 Foursquare Labs, Inc. All rights reserved. The Foursquare OS Places dataset (the “Data”) is licensed under the Apache License, Version 2.0 (the “License”). You may not use, modify, or distribute the Data except in compliance with the License. As set forth more fully in the License, if you use, modify, or distribute the Data, you must:
  • provide recipients with a copy of the License.
  • if applicable, include prominent notices to the extent you’ve changed the Data.
  • preserve attribution to Foursquare, including preserving the full content of this NOTICE.txt file.
To ensure appropriate attribution to Foursquare, we recommend the following:
  • if using/distributing the Data in flat file form as-is or after making changes/modifications: include this NOTICE.txt file, which may be modified to include an additional notice of your changes/modifications, if any.
  • if using/distributing the Data in API form as-is or after making changes/modifications: include a copy of the content from this NOTICE.txt file prominently in your developer documentation for such API, which may be modified to include an additional notice of your changes/modifications, if any.
You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, the Data distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. We also encourage you to join our Placemaker community where you can contribute and provide suggestions to improve the accuracy of the Data for future releases for yourself and others.
Changes: Overture transformed the Foursquare data to its own schema. Kviria converts the places to its own format and indexes them by area.

​
Is Kviria another AI model?

No. Kviria is a tool your agent calls, not a model you talk to. Your agent parses the user’s words into a request, and Kviria finds the place in its map data. Kviria never receives the user’s words. It returns data only: names, distances, categories, and coordinates with the evidence behind them. Your agent still writes the reply.

​
What happens when several places match?

Kviria does not pick for the user. When several places match, it returns them as many, and your agent asks which one. A place the user named only in part waits for the user’s yes before its coordinate is given. See Confirmation.

​
How much does it cost?

An account gets free turns every day. While an account holds a balance, every turn is paid from it. The balance is prepaid in USDC on Base, and you can top up any amount from one turn’s price up. The price and the limits are in Payments and Rate limits.

​
Do I need an API key?

An MCP client such as Claude or ChatGPT needs none: it connects in one click with OAuth. Voice platforms, scripts and SDKs send a Kviria key from api.kviria.com/key. There is no email and no password. See Connect and pay. The agent name in x-kviria-agent keeps your agent’s context apart from other agents’. It is not a secret and does not sign you in.

​
Does Kviria store the conversation?

No. Kviria keeps no conversation between calls. The state string in each response carries it, and your agent sends it back. See Conversation state. How Kviria handles the requests it receives is in the privacy policy.