Read-onlyLeasesMCP tool
leases_list
Search the user's leases by status, lease_type, party, or free-text query.
Search the user's leases by status, lease_type, party, or free-text query. Returns id, lease_start, lease_end, monthly_rent, status, lease_type, renter_client_id, landlord_contact_id, listing_id. Use status='expiring' or the dedicated leases_expiring tool to find leases ending soon — the dedicated view is more useful when looking for renewal opportunities. Pagination: total_count + has_more + offset + limit.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Free-text search (reserved — not currently indexed; use specific filters instead) |
status | enum | No | Filter by lease status. active=currently occupied, expiring=within renewal window, renewed=has successor lease, terminated=ended early, expired=passed lease_end with no renewal · One of: draft, active, expiring, renewed, terminated, expired |
lease_type | enum | No | Filter by lease type · One of: residential, commercial, short_term |
renter_client_id | string | No | Filter to leases for a specific renter (client). Use clients_list with client_type=tenant to find tenants first. · Format: UUID |
landlord_contact_id | string | No | Filter to leases for a specific landlord (contact). Use contacts_list with leasing_role=landlord to find landlords first. · Format: UUID |
listing_id | string | No | Filter to leases for a specific listing · Format: UUID |
limit | number | No | Maximum results (default: 25) · Max: 500 · Min: 1 |
offset | number | No | Skip N results for pagination (default: 0) · Min: 0 |
Example prompts#
- "List all my active residential leases with their monthly rent."
- "Show every lease tied to the 88 Calloway Ave listing."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.