Skip to content
MCP tools
View as Markdown
Creates dataLeasesMCP tool

leases_create

Create a new lease agreement.

Create a new lease agreement. Use when a new lease is being drafted or activated outside the normal application→lease flow. For the common case of approving an application and executing the lease, use rental_applications_convert_to_lease instead — that atomically approves + creates + links. Required: lease_start, lease_end (ISO dates), monthly_rent. Defaults: status='draft', lease_type='residential'. Returns the created lease record.

Parameters#

ParameterTypeRequiredDescription
listing_idstringNoUUID of the listing being leased · Format: UUID
landlord_contact_idstringNoUUID of the landlord contact · Format: UUID
renter_client_idstringNoUUID of the renter client (typically client_type=tenant) · Format: UUID
rental_application_idstringNoUUID of the approved application (if converted from one) · Format: UUID
previous_lease_idstringNoUUID of the prior lease (for renewals — links the chain) · Format: UUID
lease_startstringYesLease start date (ISO format, YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
lease_endstringYesLease end date (ISO format, YYYY-MM-DD). Must be after lease_start. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
monthly_rentnumberYesMonthly rent amount · Min: 0
security_depositnumberNoSecurity deposit amount · Min: 0
statusenumNoInitial status (default: draft) · One of: draft, active, expiring, renewed, terminated, expired
lease_typeenumNoLease type (default: residential) · One of: residential, commercial, short_term
commission_amountnumberNoAgent commission for this lease · Min: 0
notesstringNoFree-text notes · Max length: 10000

Example prompts#

  • "Draft a lease for the Patels at 88 Calloway Ave, 2400 monthly, July 1 to June 30."
  • "Create a 12-month residential lease starting August 1 at 1950 monthly with a 2000 deposit."

Safety#

Creates data. Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.