Skip to content

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 within the radius
address_search You want to know if a listing exists at a specific address Summary list of matches at that address
property_details You want everything about one listing Full record for a single property

The 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.

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.

Show me retail listings for lease in Melbourne CBD between 50 and 150m², cheapest first.

Searches listings near a geographic coordinate or a street address. 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 (1 km by default, up to 5 km). Results are ordered by listing date (newest first) like the other search tools, not by distance from the centre.

Give it either an address or a latitude/longitude pair - not both. When you search by address, the response echoes the coordinates it resolved the address to, so you can see exactly where the search was centred.

Find office listings within 1 km of 300 Collins St, Melbourne VIC, 200-500m².

Find office listings within 1 km of latitude -37.8136, longitude 144.9631, 200-500m².

Ambiguous or unrecognised address?

If the address matches more than one location, or doesn't match anywhere, your assistant gets back a list of candidate matches with their coordinates and can retry using the latitude/longitude of the one you meant.

Looks up listings at a specific address - "is there a listing at 300 Collins St?" Every word you give must appear somewhere in the listing's address, in any order, so "Collins St 300 Melbourne" matches the same listings as "300 Collins St, Melbourne". Returns up to 25 matches and includes off-market listings alongside those currently for sale or lease. Use this instead of radial_search when you want an exact address, not nearby results.

Is 55 Collins Street, Essendon listed with MarketBuddy?

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.
  • faceted_search, radial_search, and property_details return the same listings you'd see in the MarketBuddy app - nothing private or off-market. address_search is the exception: it also surfaces off-market listings at that address, so you can confirm agency history even after a listing comes down.

See example prompts Connect your AI assistant