Keyword search for venues
search_venuesKeyword search over venue names, taglines and descriptions (stemmed; 'brewery' matches 'breweries'; no typo tolerance). Scope it with within_place_id (from resolve_place) — never put the city name in the text. Short, concrete keywords work best: 'ramen', 'rooftop bar', 'flea market'. Combine with filters and/or near.
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": {
"text": "<text>"
},
"name": "search_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. | |
| text | Yes | 1-3 keywords describing what to find. | |
| 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. | |
| 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 | No | 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. Omit for vague asks ('spots', 'places'). | |
| 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". | |
| country_code | No | ISO alpha-2; broad scoping when no place ID is known. | |
| 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. | |
| within_place_id | No | Restrict to this place's subtree (city, neighbourhood, region, country). | |
| 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. |