Skip to content
MCP tools
Read-onlyTenanciesMCP tool

tenancies_list

Search the user's property-managed tenancies.

Search the user's property-managed tenancies. Returns id, lease_id, status (active/vacating/vacant/terminated), rent_current, management_fee_pct, next_inspection_due_at. Use rent_current=false to find delinquent tenancies (or call tenancies_delinquent for a dedicated view). Pagination: total_count + offset + limit.

Parameters#

ParameterTypeRequiredDescription
querystringNoFree-text search (reserved)
statusenumNoFilter by tenancy lifecycle status · One of: active, vacating, vacant, terminated
owner_client_idstringNoFilter to tenancies owned by a specific client (landlord) · Format: UUID
rent_currentbooleanNoFilter by rent-current flag (false = delinquent)
limitnumberNoMaximum results (default: 25, max: 500) · Max: 500 · Min: 1
offsetnumberNoSkip N results for pagination (default: 0) · Min: 0

Example prompts#

  • "List all my active managed tenancies with their management fee percentages."
  • "Show vacating tenancies in Marcus Bell's rental portfolio."

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.