Find venues in a place
find_venuesList venues of one type anywhere inside a place (country, region, city or neighbourhood), best-ranked first, or nearest-first when near is given; sort_by switches to highest rated, most reviewed or distance. Use for requests like 'top-rated cheap Italian restaurants in Prague', 'most reviewed bars in London' or 'family-friendly outdoor attractions in Scotland'. place_id must come from resolve_place. For keyword matching ('sushi', 'rooftop', 'craft beer'), use search_venues instead. If a neighbourhood returns fewer than ~5 results, widen to its city.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"place_id": "<place_id>",
"venue_type": "<venue_type>"
},
"name": "find_venues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| near | No | Restrict to this radius around a point; results then sort nearest-first unless sort_by says otherwise. For 'near <landmark>', first find the landmark with search_venues (venue_type Landmarks, then Attractions) and use its location. | |
| limit | No | Results per page. | |
| access | No | Physical access difficulty. Every listed value must be present (AND), so pass only what the user actually requires. | |
| cursor | No | next_cursor from a previous call with otherwise identical arguments. Never invent one. | |
| sort_by | No | best (default): Evendo ranking, or nearest-first when `near` is given. place_score: highest Evendo place score (0-100 overall quality) first. rating: highest average rating first (pair with min_reviews so 1-review places don't win). reviews: most reviewed first ('most popular'). nearest / farthest: by distance, require `near`. Places missing the value sort last. Changing sort_by restarts pagination: don't reuse a cursor from another sort. | |
| ambience | No | Atmosphere tags. Every listed value must be present (AND), so pass only what the user actually requires. | |
| audience | No | Who the place suits / accessibility. Every listed value must be present (AND), so pass only what the user actually requires. | |
| category | No | Exact, case-sensitive category. Restaurants: "Italian", "Japanese", "Mexican", "Indian", "Chinese", "Thai", "French", "Mediterranean", "Seafood", "Steakhouse", "Pizza", "Sushi", "Vegan", "Vegetarian", "Fast Food", "Fine Dining". Bars: "Cocktail Bar", "Wine Bar", "Sports Bar", "Beer Garden". Shopping: "Market", "Boutique", "Mall". Attractions: "Museum", "Park", "Gallery", "Zoo", "Theme Park", "Garden". If unsure of the exact value, use search_venues text instead. | |
| place_id | Yes | ID from resolve_place. | |
| amenities | No | Required amenities. Every listed value must be present (AND), so pass only what the user actually requires. | |
| experience | No | Experience tags. Every listed value must be present (AND), so pass only what the user actually requires. | |
| min_rating | No | Minimum average rating, 0-5. "good" = 4.0, "top rated"/"best" = 4.5 (pair with min_reviews). | |
| venue_type | Yes | Restaurants (incl. cafes, diners), Bars (pubs, nightclubs), Shopping (markets, shops), Attractions (museums, parks, galleries, zoos), Landmarks (monuments, historic sites). Unsure between Attractions and Landmarks? Try both. | |
| environment | No | "outdoor"/"terrace"/"al fresco" = Outdoor. For "outdoor seating" make two calls, Outdoor and "Indoor and Outdoor", and merge. | |
| min_reviews | No | Minimum number of reviews; use ~50+ to avoid thinly-rated places. "good" = 10+, "top rated" = 20+. | |
| price_level | No | "cheap"/"budget" = inexpensive; "upscale"/"fancy" = expensive or very_expensive. There is no "free" level; for free places use search_venues with text "free". | |
| style_visual | No | Views. Every listed value must be present (AND), so pass only what the user actually requires. | |
| location_type | No | Finer type than venue_type, exact match, e.g. "Pub", "Cafe", "Restaurant", "Attraction", "Gastropub", "Museum". Pub = Bars + "Pub"; cafe / coffee shop = Restaurants + "Cafe". | |
| sustainability | No | Sustainability tags. Every listed value must be present (AND), so pass only what the user actually requires. | |
| min_place_score | No | Minimum Evendo place score (0-100 overall quality; most venues are 20-50, 70+ is excellent, 90+ is a city's very best). | |
| style_aesthetic | No | Interior / design aesthetic. Every listed value must be present (AND), so pass only what the user actually requires. | |
| style_architecture | No | Architecture. Every listed value must be present (AND), so pass only what the user actually requires. | |
| style_social_media | No | Photo / social-media appeal. Every listed value must be present (AND), so pass only what the user actually requires. | |
| weather_suitability | No | Weather suitability. Every listed value must be present (AND), so pass only what the user actually requires. |