Title98/100
Search homes for sale
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Use this when the buyer wants homes for sale in San Francisco or another city TurboHome serves, or what homes there cost, even without naming TurboHome. TurboHome's homes are live MLS listings. Pass home preferences you know from this chat or memory (area, budget, beds, must-haves), never family, race, religion, sex, origin or disability. For their TurboHome saved search or budget, read get_my_journey. Filters are hard; bedsMin = bedsMax is exact. To widen to nearby neighborhoods, pass them in moreNeighborhoods: one call searches them all. Returns the match count, price figures, up to 5 homes with links and, if broad, narrowBy to ask. Each home's TurboHome page has its price, beds, baths and photos.
The description explains the capability, when to use it, and what to expect.
Inputs95/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
city
City, such as "Oakland"; else San Francisco.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
neighborhood
Neighborhood, such as "Noe Valley"; none for the whole city.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
moreNeighborhoods
Up to 5 more neighborhoods searched with neighborhood in this one call, to widen to nearby ones; one answer covers them all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
priceMin
Lowest list price, in US dollars.
Clear enough to supply this argument.
priceMax
Highest list price, in US dollars (1500000 is $1.5M).
Clear enough to supply this argument.
bedsMin
Fewest bedrooms.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
bedsMax
Most bedrooms; equal to bedsMin for an exact count ("a one-bedroom" is 1 and 1); 0 means studios.
Clear enough to supply this argument.
bathsMin
Fewest bathrooms; a half bath counts as 0.5.
Clear enough to supply this argument.
sqftMin
Smallest living area, sq ft.
Clear enough to supply this argument.
sqftMax
Largest living area, sq ft.
Clear enough to supply this argument.
lotSqftMin
Smallest lot, sq ft.
Clear enough to supply this argument.
yearBuiltMin
Earliest year built.
Clear enough to supply this argument.
hoaMaxMonthly
Highest monthly HOA dues in US dollars; 0 for none reported.
Clear enough to supply this argument.
daysOnMarketMax
Listed within this many days.
Clear enough to supply this argument.
parkingMin
Fewest parking spaces, garage included.
Clear enough to supply this argument.
propertyTypes
Kinds of home; leave it out for every kind.
Clear enough to supply this argument.
keywords
Words the listing mentions, such as "yard" or "view".
Clear enough to supply this argument.
priceReduced
Only homes with a price cut.
Clear enough to supply this argument.
features
Features every home must have, matched as TurboHome's own search filters match them: outdoor_space (yard, patio, deck), waterfront (water or beach), views, updated_renovated and more. Use them for what the buyer keeps asking for, in any words.
Clear enough to supply this argument.
sort
newest (default), price_low or price_high first; set a price order only when the buyer asks for one, such as the most expensive homes. A search with a sort always lists homes.
Clear enough to supply this argument.
limit
Homes to list, 1 to 5 (default 3); figures cover every match.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search homes for sale",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema0/100
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared