MCP tools

Reference for the six MCP tools exposed by the B2A server.

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, reviews, photos, neighborhood.

Input:

{ "property_id": "prop_abc123" }

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}
}

All tools return structured JSON wrapped in the standard MCP content array. Errors are surfaced as isError: true with a didactic message.