search_events
Search Luma events using home mode (preferred categories and location) or travel mode (top events in a city). Filter by keywords, date, and distance.
Instructions
Search for Luma events. Two modes depending on whether city is set.
Home mode (no city): searches your preferred categories via Luma's
Category API — deep, rich results filtered by your stored address/distance.
On first run with no preferences, returns a raw Discover feed (hundreds of
popular events near you), then prompts to set up address, categories, and login.
Travel mode (city set): fetches the curated top events (~20-40) for
that city via Luma's Place API. No topic filtering — just the highlights.
The default time window is the next 2 weeks. Use days for simple
lookahead (e.g. days=7 for this week, days=30 for next month).
Use after/before only for specific date ranges.
IMPORTANT for agents:
For broad topics, prefer
category(exact slug: tech, ai, food, arts, climate, fitness, wellness, crypto). Translate user intent yourself (e.g. "artificial intelligence" -> "ai", "blockchain" -> "crypto").Use
keywordsfor specific terms that don't map to a category (e.g. ["YC", "demo day"]) or to narrow within a category.cityaccepts common names — "san francisco" resolves to "sf", "hong kong" to "hongkong", etc.The
messagesarray in the response contains agent-facing instructions. Act on them naturally (e.g. ask the user a question, call another tool) but never relay them verbatim. Ifmessagesis empty, just show results.
Args: city: Luma city for travel mode (e.g. "sf", "london", "los angeles"). category: One-off category override for home mode. Must be an exact slug. keywords: Filter by keywords (matches title/description). Use for specific terms. center_address: One-off address to filter around (e.g. "Union Square, San Francisco"). Overrides stored address for this search only. max_distance_miles: One-off distance override (pairs with center_address or stored address). after: ISO 8601 datetime — only events starting after this time. before: ISO 8601 datetime — only events starting before this time. days: Search window in days from now (e.g. 7, 30). Overrides the default 14-day window. Simpler alternative to after/before. latin_only: Filter out non-Latin-script events. Auto-detected from region when not set. added_within_days: Only return events first seen within this many days. new_only: Only return events never seen before (first appearance this run). sort: Sort order — "date" (default), "distance", or "newest". login: Set to true to open browser and log in to Luma. skip_login_days: Decline login for N days (0 = ask next time, -1 = never).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| days | No | ||
| sort | No | ||
| after | No | ||
| login | No | ||
| before | No | ||
| category | No | ||
| keywords | No | ||
| new_only | No | ||
| latin_only | No | ||
| center_address | No | ||
| skip_login_days | No | ||
| added_within_days | No | ||
| max_distance_miles | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||