Supported tools¶
The MarketBuddy tools your AI assistant can call over MCP.
When you connect MarketBuddy to an AI assistant, these are the tools it can use behind the scenes. You don't call them directly - you ask a question in plain English and your assistant picks the right one and fills in the details. This page is a reference for what's available.
You don't need to memorise these
Just ask naturally - "office space for lease in Surry Hills under 200m²" - and your assistant maps it to the correct tool. See What you can ask for ready-made prompts.
This list will grow over time as we add more capabilities.
Tools at a glance¶
| Tool | Use it when… | Returns |
|---|---|---|
faceted_search |
You know a suburb or postcode | Summary list of matching listings |
radial_search |
You have a location or address and want results nearby | Summary list, by distance |
property_details |
You want everything about one listing | Full record for a single property |
The two search tools return summary-level results - address, price, type, area. To get the full story on a listing, your assistant passes its ID to property_details.
faceted_search¶
Searches commercial property listings by location and filters. Use this whenever you mention a suburb name or postcode. You can narrow results by property type, price range, and floor area, and sort by price or how recently a property was listed. Results are summary-level - your assistant can then pull the full record for any listing that looks interesting.
radial_search¶
Searches listings near a geographic coordinate. Use this for "near", "within X km", or "close to this address" style questions. It takes the same filters as faceted_search, plus a search radius (up to 5 km), and returns results by distance.
Need coordinates?
If you only have an address, ask your assistant for its latitude and longitude first, then it can run the radial search.
property_details¶
Fetches the full record for a single listing - description, images, floor plans, documents, and detailed area breakdowns. Your assistant usually calls this after a search, using the ID of a listing you picked out.
Tell me everything about MarketBuddy listing 12345 - description, area breakdown, photos, and any documents.
What these tools will not do¶
- They won't change your account, billing, or saved searches.
- They won't email or contact agents on your behalf.
- They return the same listings you'd see in the MarketBuddy app - nothing private or off-market.