Skip to content
MCP tools
View as Markdown
Updates dataListingsMCP tool

listings_update

Update an existing listing's information or status.

Update an existing listing's information or status. Only provided fields are updated — omitted fields remain unchanged. Common uses: price reduction (update list_price), status change (active→pending→sold), address correction, extend expiration date. Status transitions: active → pending (offer accepted) → sold (closed) or expired/cancelled (listing ended). Returns the updated listing record. If the listing_id is not found, the error suggests using listings_list.

Parameters#

ParameterTypeRequiredDescription
listing_idstringYesUUID of the listing to update (required). Use listings_list to find the ID if unknown. · Format: UUID
property_addressstringNoUpdated street address.
display_addressstringNoUpdated display address (e.g., with unit number).
citystringNoUpdated city name.
statestringNoUpdated state abbreviation.
zip_codestringNoUpdated ZIP code.
countystringNoUpdated county name.
latitudenumberNoUpdated latitude coordinate.
longitudenumberNoUpdated longitude coordinate.
list_pricenumberNoUpdated listing price (price reduction or increase). · Min: 0
mls_numberstringNoUpdated MLS listing number.
bedroomsnumberNoUpdated bedroom count. · Min: 0
bathroomsnumberNoUpdated bathroom count (can be decimal for half baths). · Min: 0
square_feetnumberNoUpdated square footage. · Min: 0
property_typeenumNoUpdated property type (rare — usually fixed at creation). · One of: single_family, condo, townhouse, multi_family, land, commercial
close_pricenumberNoClose/sale price (RESO ClosePrice).
close_datestringNoClose date (ISO 8601, RESO CloseDate).
listing_datestringNoUpdated date listing went active on MLS. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
expiration_datestringNoUpdated expiration date (for extensions). (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
listing_statusenumNoUpdated status. active→pending→sold is the typical flow. · One of: active, pending, sold, expired, cancelled
descriptionstringNoUpdated description.
public_remarksstringNoRESO PublicRemarks.
private_remarksstringNoRESO PrivateRemarks (agent-only notes).
buyer_agent_mls_idstringNoRESO BuyerAgentMlsId.
buyer_agent_full_namestringNoRESO BuyerAgentFullName.

Example prompts#

  • "Drop the price on 412 Birchwood Ln to 475,000."
  • "Mark the Marsh Creek condo pending, we accepted an offer this morning."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.

Previous name#

This tool was previously published as update_listing. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.