One balance.
Every tool your agent needs.

Report what BudgetAtlas actually holds: covered cities, per-source counts, available lodging date/occupancy cohorts, numeric restaurant-price coverage, blocked collections, and known gaps. Call this before any broad comparison.

Free self-description for agents. Lists the question classes this dataset can answer, with a runnable example argument object per tool, and the questions it cannot answer, each naming the blocker (source not permitted, missing credential, out of scope, not collected) and the prerequisite that would lift it. Coverage figures are read from the database at call time. Call this before spending anything.

Report how old the data is, per city and for the dataset as a whole: the newest and oldest observation, its age in days against a staleness line you choose, a fresh/aging/stale/empty verdict that names the number behind it, and the last collection run with its status. Call this before quoting a price as current.

Search stored lodging price observations for a city, either for exact dates or for a stay length. Returns comparable prices with their original amount and currency, tax status, per-source ratings, evidence-backed amenity signals, provenance, and coverage. These are historical snapshots, not live availability. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Compare observed nightly lodging rates for one city across the check-in months that were collected, for a single stay length and occupancy. Returns each month's distribution, the like-for-like subset of properties present in every month, and a cheapest month stated only from that subset. Each month is one sampled check-in date, not a monthly average. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Find restaurant venues in a city by observed numeric price. Returns the item or range that qualified, its original amount and currency, the FX rate used, venue ratings by source, provenance, and coverage. Venues without a numeric observed price cannot pass a price filter and are reported as a coverage gap instead. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Find observed round-trip fares from European hubs into Southeast Asian cities. Returns the observed fare distribution per route (minimum, quartiles, maximum), how many itineraries it was computed from, the fewest stops and shortest duration seen, and provenance. Fares are whole-trip totals for the whole party and are historical observations, not live availability. Rows marked `provisional` were read before the source's result list settled, so their minimum is biased high. Aggregates only: no itinerary-level fares or booking links are published. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Compare covered cities for a stay of N days, or for exact dates. Returns per-city lodging and meal components, a lodging + meals subtotal, the assumptions and formulas used, observed ranges, sample sizes, source coverage, freshness, and the categories that are explicitly NOT included. This is not a cost-of-living total. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.