# Kviria

> Location understanding for AI agents: know where, then navigate there.
> Beta: contiguous US. The agent parses what the user said into a
> request; Kviria narrows it down to exactly one place or address and
> returns its verified coordinate with an evidence trail. Data only -
> never phrased sentences; the agent phrases.

## Agent Docs

- [Skill](https://kviria.com/skill.md): The agent-facing contract - when to call, what to send, the decisions and what to do with each, errors, examples.
- [Tool definition](https://kviria.com/tool-definition.json): The authoritative wire schema (JSON Schema, MCP-ready).

## API

- Endpoint: POST https://api.kviria.com/v1/agent
- Auth: a Kviria key (Authorization: Bearer kvr_..., from https://api.kviria.com/key), or OAuth for MCP clients; no email or password. A call without either answers 401
- Free tier: 600 turns/day per account; 60 turns/minute per account
- An account with a balance: 1,800 turns/minute; each turn is paid from the balance
- Paid turns: $0.01 each from the account's prepaid USDC balance (x402 on Base, a PAYMENT-SIGNATURE header with the key; top up any amount at or above one turn's price)
- MCP server: https://api.kviria.com/mcp (one "kviria" tool, streamable HTTP; OAuth in one click, or the key header)
- The x-kviria-agent flag is a namespace label, not a secret

## Try It

- [Playground](https://kviria.com/playground): Talk to the live engine - drop a pin across the United States, no signup.

## Contact and Support

- [Contact us](https://kviria.com/contact): Questions, feedback, and integration support.
- [Email](mailto:hello@kviria.com): hello@kviria.com.

## Legal

- [Terms of Service](https://kviria.com/terms): Governs use of Kviria products and services.
- [Privacy Policy](https://kviria.com/privacy): How Kviria handles user data.