properties_context_nearby_for_saleCurrently for-sale listings within radius_km of the property
(newest first, max 30) with AVM and rent-yield comparison.
Price: 20¢ per call.
| Name | Required | Description | Default |
|---|---|---|---|
| gnaf_id | Yes | ||
| radius_km | No | Search radius in km (0.1-5). |
Changes observed during successful MCP inspections.
Output schema / (root)Previous value: -{
- "properties": {
- "available": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "description": "`false` on no-data responses. Omitted on success — branch on `data !== null` if you want a single discriminator.",
- "title": "Available"
- },
- "data": {
- "anyOf": [
- {
- "additionalProperties": true,
- "description": "Currently for-sale listings within the requested radius of the\nproperty (newest first, max 30), with AVM / rent-yield comparison.",
- "example": {
- "center_lat": -33.802479,
- "center_lng": 151.219715,
- "count": 2,
- "gnaf_id": "GANSW704360755",
- "listings": [
- {
- "address": "8 The Bulwark, Castlecrag NSW 2068",
- "avm": 4380000,
- "bathrooms": 2,
- "bedrooms": 4,
- "discount_pct": 2.7,
- "gnaf_pid": "GANSW704357382",
- "land_size": 696,
- "lat": -33.8019,
- "listing_date": "2026-06-14",
- "lng": 151.2205,
- "price": 4500000,
- "price_label": "$4,500,000 Guide",
- "property_type": "House",
- "weekly_rent": 1850,
- "yield_pct": 2.1
- }
- ],
- "radius_km": 1
- },
- "properties": {
- "center_lat": {
- "description": "Subject property latitude.",
- "title": "Center Lat",
- "type": "number"
- },
- "center_lng": {
- "description": "Subject property longitude.",
- "title": "Center Lng",
- "type": "number"
- },
- "count": {
- "description": "Number of listings returned (0-30).",
- "title": "Count",
- "type": "integer"
- },
- "gnaf_id": {
- "description": "Subject property GNAF id.",
- "title": "Gnaf Id",
- "type": "string"
- },
- "listings": {
- "description": "For-sale listings, newest listing date first.",
- "items": {
- "additionalProperties": true,
- "description": "One currently-for-sale listing near the subject property.",
- "properties": {
- "address": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Full address, title-cased.",
- "title": "Address"
- },
- "avm": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Latest AVM prediction (AUD) for the listing, if available.",
- "title": "Avm"
- },
- "bathrooms": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Bathroom count.",
- "title": "Bathrooms"
- },
- "bedrooms": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Bedroom count.",
- "title": "Bedrooms"
- },
- "discount_pct": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Asking price vs AVM: (price - avm) / avm * 100. Negative = under AVM.",
- "title": "Discount Pct"
- },
- "gnaf_pid": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Listing property GNAF id.",
- "title": "Gnaf Pid"
- },
- "land_size": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Land size (sqm) when parseable.",
- "title": "Land Size"
- },
- "lat": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Listing latitude.",
- "title": "Lat"
- },
- "listing_date": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Listing date (YYYY-MM-DD).",
- "title": "Listing Date"
- },
- "lng": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Listing longitude.",
- "title": "Lng"
- },
- "price": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Asking price (AUD) — parsed from the display price when possible.",
- "title": "Price"
- },
- "price_label": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Raw asking-price label, e.g. \"Auction\" or \"$3.5M Guide\".",
- "title": "Price Label"
- },
- "property_type": {
- "description": "Bucketed type: House / Townhouse / Unit / Land / Other.",
- "title": "Property Type",
- "type": "string"
- },
- "weekly_rent": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Predicted weekly rent (AUD) from the rental AVM.",
- "title": "Weekly Rent"
- },
- "yield_pct": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Gross rental yield % = weekly_rent * 52 / price * 100.",
- "title": "Yield Pct"
- }
- },
- "required": [
- "property_type"
- ],
- "title": "NearbyForSaleListing",
- "type": "object"
- },
- "title": "Listings",
- "type": "array"
- },
- "radius_km": {
- "description": "Search radius used (km).",
- "title": "Radius Km",
- "type": "number"
- }
- },
- "required": [
- "gnaf_id",
- "center_lat",
- "center_lng",
- "radius_km",
- "count",
- "listings"
- ],
- "title": "NearbyForSale",
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "description": "The endpoint's payload, or `null` when Microburbs has no value."
- },
- "message": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Human-readable explanation. Omitted on success.",
- "title": "Message"
- },
- "reason": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Machine-readable slug naming the no-data condition (e.g. `no_avm_for_GANSW704074813`). Stable per endpoint. Omitted on success.",
- "title": "Reason"
- }
- },
- "title": "ApiResponse[NearbyForSale]",
- "type": "object",
- "x-fastmcp-top-level-schema": "ApiResponse_NearbyForSale_"
-}New value: +nullDoes the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false, so the safety profile is covered. The description adds useful behavioral context: results are newest first, capped at 30, and include AVM and rent-yield comparison. It also discloses the price (20¢ per call), which is a meaningful operational detail beyond annotations. No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences plus a pricing note. It front-loads the core purpose, then adds the key constraints (newest first, max 30, AVM/rent-yield comparison) and pricing. Every sentence earns its place; no filler or repetition of schema details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a read-only list tool with annotations covering safety and idempotency, the description is largely complete. It states the result ordering, cap, and included comparisons. The main gap is that gnaf_id is not explained, and there is no output schema, so the agent doesn't know the exact return shape. However, the description's mention of AVM and rent-yield comparison gives a reasonable sense of the output. A 4 is fair.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 50%: radius_km has a description, but gnaf_id has none. The description adds meaning by explaining that radius_km is the search radius and that results are limited to 30, but it doesn't explain what gnaf_id is or how to obtain it. Since the schema covers half the parameters and the description partially compensates, a 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: returns currently for-sale listings within a radius of the property, with AVM and rent-yield comparison. It distinguishes itself from sibling tools like properties_comparables_recent_sales_nearby and suburbs_listings_for_sale by focusing on nearby for-sale listings around a specific property with AVM/rent-yield comparison. However, it doesn't explicitly name a sibling alternative, so it doesn't fully earn a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context: when you need for-sale listings near a property with AVM and rent-yield comparison. It does not explicitly state when to use this vs alternatives like properties_comparables_recent_sales_nearby or properties_sale_history. The radius_km parameter and 'newest first, max 30' provide some context, but no explicit exclusions or alternative routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.