Read-onlyOpen housesMCP tool
open_houses_list
Search for open house events by address, status, or date range.
Search for open house events by address, status, or date range. Returns pagination info (total_count, has_more, offset, limit). Results include: id, address, list_price, date, start_time, end_time, status, visitor_count, notes, created_at. Filter by status (scheduled/in_progress/completed/cancelled) or date range. For a specific open house by ID, use open_houses_get instead. For aggregate stats, use open_houses_stats.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term - matches against address (case-insensitive partial match) |
status | enum | No | Filter by status. scheduled=upcoming, in_progress=happening now, completed=past, cancelled=cancelled (default: all) · One of: all, scheduled, in_progress, completed, cancelled |
date_from | string | No | Show open houses on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
date_to | string | No | Show open houses on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
archived | boolean | No | Include archived open houses (default: false) |
limit | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
offset | number | No | Skip N results for pagination (default: 0) · Min: 0 |
Example prompts#
- "What open houses do I have scheduled for this weekend?"
- "List completed open houses at 412 Birchwood Ln with their visitor counts."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.