Read-onlyShowingsMCP tool
showings_list
Search for property showings by address, status, type, or date range.
Search for property showings by address, status, type, or date range. Returns pagination info (total_count, has_more, offset, limit). Results include: id, address, showing_date, showing_time, showing_status, showing_type, access_type, listing address/photo, contact name, agent_notes, created_at. Filter by status (pending/confirmed/completed/cancelled/no_show), type (first_showing/follow_up/final_walkthrough/inspection/appraisal), or date range. For a specific showing by ID, use showings_get instead. For aggregate stats, use showings_stats.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term - matches against address (case-insensitive partial match) |
status | enum | No | Filter by status. pending=awaiting confirmation, confirmed=scheduled, completed=done, cancelled=cancelled, no_show=missed (default: all) · One of: all, pending, confirmed, completed, cancelled, no_show |
showing_type | enum | No | Filter by showing type (default: all) · One of: all, first_showing, follow_up, final_walkthrough, inspection, appraisal |
date_from | string | No | Show showings on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
date_to | string | No | Show showings on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
archived | boolean | No | Include archived showings (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#
- "List my confirmed showings between Friday and Sunday this week."
- "Pull up any pending showings at 412 Birchwood Ln awaiting confirmation."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.