find_venues
FREE. Search only a place the person named, or their location as your client gives it; never a city you chose. With neither, do not search: ask where they are, or say that location can be switched on in Claude's privacy settings. Say place_source. For a district or neighbourhood the person names (Soho, Kungsholmen), search its coordinates with radius_km of about 1, or its postcode prefix with the country; a city alone searches the whole city. Find physical venues by MEASURED atmosphere. Matching is numeric only — translate the user's wording into parameter bands yourself. Typical translations: quiet/calm ≈ energy_max 40–45; lively/energetic ≈ energy_min 60; booming ≈ loudness_min -6; acoustic/unplugged ≈ acousticness_min 55; danceable ≈ danceability_min 60; conversation-friendly ≈ energy_max 45 AND loudness_max -10; workout ≈ tempo_min 130. Among the venues that fit, those measured from their own playlist always come first: their figures come from the music they actually play, and that measurement is a paid PlaceProfile tier (or a PlaceProfile showcase). With daypart, the bands test that time of day's tracks. Call list_archetypes for venue-kind bands (gym-high-energy, cafe-relaxed, …). Filter by category (what the venue IS — hotel, bar, wine_bar, nightclub, …; see the parameter for all 37 values) so hotels are hotels and cottages are not; find one specific venue with name. Location: city+country, postcode_prefix (district-level, e.g. 'SW1'), or lat/lon/radius_km. If nothing matches exactly, the response may carry nearest_alternatives — the closest venues with a plain-language note of what was widened; relay those as 'closest options', never as exact matches. Results are deterministic (band-centre distance, ties by slug). Each result carries atmosphere: a ready-made plain-English description — relay THAT to the user, optionally shortened. Numeric detail (per-dimension why block) is returned only when you pass include_measurements=true, which you should do ONLY when the user explicitly asks for figures or verification. Every venue's numbers are recomputable from its profile_url + '.jsonld'. Pass the user's verbatim wording as intent_text (logged to close coverage gaps; never matched on).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_venues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude of the place to search around. Only a place the person named, or their location as your client gives it; never a city you chose. | |
| lon | No | Longitude of the place to search around. Only a place the person named, or their location as your client gives it; never a city you chose. | |
| city | No | City name as it is usually written (e.g. Stockholm). Always send country with it. Only a place the person named, or their location as your client gives it; never a city you chose. For a district or neighbourhood the person names (Soho, Kungsholmen), search its coordinates with radius_km of about 1, or its postcode prefix with the country; a city alone searches the whole city. | |
| name | No | Find a specific venue by name (case-insensitive substring). Send country with it (and city where known), or lat/lon/radius_km. | |
| genre | No | Genres the venue's OWN playlist actually contains. Only venues measured from their own music can match — a directory venue plays a category sample, so filtering it by genre would rank it by shuffle luck. | |
| limit | No | ||
| country | No | ISO country code (e.g. SE). Required with city, name, postcode_prefix or category, unless lat/lon/radius_km is given. | |
| daypart | No | A time-of-day label the venue publishes a separate profile for (owner-supplied, e.g. lunch, dinner, late_evening). There is no weekday/weekend axis in the data. | |
| category | No | What the venue IS (registered category, case-insensitive). Values: aromatherapy, art_gallery, bakery, bar, barber, beauty_salon, bookstore, boutique, cafe, casual_eatery, clothing_store, cocktail_bar, coffee_shop, coworking_space, events_venue, eyebrow_service, eyelash_service, fast_food_restaurant, foot_care, gym, hair_extensions, hair_replacement, hair_salon, health_spa, hostel, hotel, lounge, makeup_artist, massage, nail_salon, nightclub, pub, record_store, restaurant, tattoo_parlor, wine_bar, yoga_studio. Almost every venue carries a category; the few without one are excluded when this filter is set. | |
| archetype | No | ||
| radius_km | No | ||
| tempo_max | No | ||
| tempo_min | No | ||
| territory | No | Registration territory of the recordings played, as an ISO country code (e.g. SE for Swedish-registered music). Measured venues only. | |
| energy_max | No | ||
| energy_min | No | ||
| intent_text | No | The user's original wording, verbatim. Logged to improve coverage; NEVER used for matching — matching is structured parameters only. | |
| valence_max | No | ||
| valence_min | No | ||
| liveness_max | No | ||
| loudness_max | No | ||
| loudness_min | No | ||
| place_source | No | Where the place in this search comes from: named_by_person (the person said it), person_location (your client gave their location), or assistant_choice (you chose it). An assistant_choice search is not run: ask the person instead. | |
| postcode_prefix | No | ||
| speechiness_max | No | ||
| acousticness_max | No | ||
| acousticness_min | No | ||
| danceability_max | No | ||
| danceability_min | No | ||
| territory_min_share | No | Minimum share of the venue's tracks registered in `territory`, as a percentage. | |
| include_measurements | No | Results describe atmosphere in plain words by default. Set true ONLY when the user explicitly asks for figures, raw measurements, or verification detail — it adds the numeric per-dimension block. | |
| instrumentalness_max | No | ||
| instrumentalness_min | No |