Skip to content
MCP tools
View as Markdown
Read-onlyReporting & insightsMCP tool

match_buyers_to_listings

Find buyer clients whose saved price range overlaps with a listing's price (within 10%).

Find buyer clients whose saved price range overlaps with a listing's price (within 10%). Returns the listing details and a list of potential buyer clients filtered by price criteria. Results are filtered by data, not recommended — the agent should independently evaluate suitability for each buyer.

Parameters#

ParameterTypeRequiredDescription
client_idstringNoUUID of the buyer client to match. Their saved preferences (budget, beds, baths, areas) are used for matching. · Format: UUID
min_pricenumberNoOverride client minimum price. Useful for expanding search if few matches. · Min: 0
max_pricenumberNoOverride client maximum price. Useful for stretching budget for right property. · Min: 0
min_bedsnumberNoMinimum bedrooms filter. · Max: 10 · Min: 0
min_bathsnumberNoMinimum bathrooms filter. · Max: 10 · Min: 0
property_typesarray of enumNoProperty types to search. Default: all types client is interested in. · Values: single_family, condo, townhouse, multi_family, land, commercial
citiesarray of stringsNoCities to search in. Default: cities from client preferences.
limitnumberNoMaximum results. Default: 10. Use 20-30 for comprehensive showing tour. · Max: 50 · Min: 1

Example prompts#

  • "Which active listings fit the Garcias budget and their three-bedroom requirement in Bakersfield?"
  • "Stretch Tom and Priya's max price to 525k and rerun their listing matches."

Safety#

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