Tools

Six tools. b2a_get_key is callable anonymously; the other five require a bearer key (call b2a_get_key first if none is configured).

b2a_get_key

Issue an anonymous bearer key. Anonymous-tolerant — callable without prior auth.

Input

{ "agent": "my-agent-name" }

Output

{
  "key": "<your-key>",
  "rate_limit": {"per_minute": 60, "per_day": 5000}
}

resolve_destination

Turn a place name into one or more destination ids. Mirrors POST /v1/destinations/resolve.

Input

{ "name": "Rome", "country": "IT", "language": "en" }

Output

{
  "candidates": [
    {"id": "dest_5f3a...", "display_name": "Rome, Italy", "type": "city", "confidence": 0.98}
  ],
  "total_matches": 1,
  "disambiguation_recommended": false
}

discover_destinations_near

List destinations within a radius of a coordinate. Useful for region-level intents.

Input

{ "lat": 43.7696, "lon": 11.2558, "radius_km": 25.0 }

search_stays

Ranked discovery search. Bundles property info, pricing, ratings, optional review samples. Mirrors POST /v1/search/stays.

Input

{
  "location": {"type": "destination_id", "value": "dest_5f3a..."},
  "dates":    {"check_in": "2026-06-10", "check_out": "2026-06-13"},
  "guests":   {"adults": 2},
  "filters":  {"price_max_eur": 300, "min_rating": 4.0}
}

get_property_details

Full static record for a property — amenities, photos, neighborhood, and reviews. Review data is opt-in via include: reviews_aggregate (score + counts + per-OTA breakdown), reviews_sample (up to 5 review texts), reviews_extended (up to 20). The aggregate exposes two distinct counts — rating_count (reviews behind the score) vs comment_count (readable review texts). Returns no price unless called with dates; for a live quote use check_property_availability.

Input

{ "property_id": "prop_abc123", "include": ["reviews_aggregate", "reviews_extended"] }

check_property_availability

Live availability and per-OTA offers for a property at a specific stay window.

Input

{
  "property_id": "prop_abc123",
  "dates":  {"check_in": "2026-06-10", "check_out": "2026-06-13"},
  "guests": {"adults": 2}
}