Skip to main content

​
Property Search

Searches MLS listings by location, price, bedrooms, and other criteria.

​
MCP tool name

search_listings

​
Parameters

​
string
City name.
​
string
Two-letter state code.
​
string
ZIP code.
​
number
Minimum price.
​
number
Maximum price.
​
integer
Minimum bedrooms.
​
integer
Maximum bedrooms.
​
number
Minimum bathrooms.
​
number
Maximum bathrooms.
​
integer
Minimum square footage.
​
integer
Maximum square footage.
​
string
"Single Family", "Condo", "Townhouse", etc.
​
integer
default:"12"
Max results (max 24).
At least one filter is required (city, state, zip, or price range).

​
Example

“Show me 3-bedroom condos under $400k in Denver”
The AI extracts: city: "Denver", maxPrice: 400000, minBeds: 3, propertyType: "Condo"

​
Response

Returns a JSON array of listing objects with address, price, beds, baths, sqft, photos, and detail URLs. See POST /v1/listings/search for the full schema.