properties_comparables_allThe evidence a valuer or agent would use to price this property: a CMA comparable set, the single closest comparable sale, and recent sales nearby.
Use it to answer "what did similar homes around here actually sell for", and to show the working behind a valuation rather than a bare number.
Price: 74¢ per call.
| Name | Required | Description | Default |
|---|---|---|---|
| gnaf_id | Yes |
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": [
- {
- "description": "All comparables — CMA set, single comp, and recent nearby sales.",
- "example": {
- "cma_comp_set": [
- {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-07-13",
- "dist_score": 6.319769313849382,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714923950",
- "latitude": -35.38013684,
- "longitude": 149.06828089,
- "price": 815000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "8 SHIPARD PL"
- },
- {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-05-17",
- "dist_score": 6.314913077374466,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714962432",
- "latitude": -35.38141033,
- "longitude": 149.0765471,
- "price": 975000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "19 MACKAY CR"
- },
- {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-05-10",
- "dist_score": 6.202634043106887,
- "garage_spaces": 4,
- "gnaf_pid": "GAACT714953151",
- "latitude": -35.38009598,
- "longitude": 149.07224252,
- "price": 1049000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "23 BROWNSMITH CR"
- }
- ],
- "cma_single_comp": {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-07-13",
- "dist_score": 6.319769313849382,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714923950",
- "latitude": -35.38013684,
- "longitude": 149.06828089,
- "price": 815000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "8 SHIPARD PL"
- },
- "recent_sales_nearby": [
- {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-07-13",
- "dist_score": 6.319769313849382,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714923950",
- "latitude": -35.38013684,
- "longitude": 149.06828089,
- "price": 815000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "8 SHIPARD PL"
- }
- ]
- },
- "properties": {
- "cma_comp_set": {
- "anyOf": [
- {
- "items": {
- "additionalProperties": true,
- "description": "One comparable sale row.",
- "example": {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-07-13",
- "dist_score": 6.319769313849382,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714923950",
- "latitude": -35.38013684,
- "longitude": 149.06828089,
- "price": 815000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "8 SHIPARD PL"
- },
- "properties": {},
- "title": "CmaComp",
- "type": "object"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Cma Comp Set"
- },
- "cma_single_comp": {
- "anyOf": [
- {
- "additionalProperties": true,
- "description": "One comparable sale row.",
- "example": {
- "bathrooms": 2,
- "bedrooms": 4,
- "date_sold": "2024-07-13",
- "dist_score": 6.319769313849382,
- "garage_spaces": 2,
- "gnaf_pid": "GAACT714923950",
- "latitude": -35.38013684,
- "longitude": 149.06828089,
- "price": 815000,
- "property_type": "house",
- "sal": "Kambah",
- "state": "ACT",
- "street": "8 SHIPARD PL"
- },
- "properties": {},
- "title": "CmaComp",
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "recent_sales_nearby": {
- "anyOf": [
- {
- "items": {
- "additionalProperties": true,
- "description": "One recent sale within the subject property's CMA search radius.",
- "example": {
- "address": "30 Arlington Street, Belmont North",
- "bath_count": 2,
- "bed_count": 3,
- "distance_m": 65,
- "dwelling_type": "house",
- "sale_date": "2024-08-12",
- "sale_price": 815000
- },
- "properties": {
- "address": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Street address.",
- "title": "Address"
- },
- "bath_count": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Bathrooms.",
- "title": "Bath Count"
- },
- "bed_count": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Bedrooms.",
- "title": "Bed Count"
- },
- "distance_m": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "description": "Distance from the subject property in metres.",
- "title": "Distance M"
- },
- "dwelling_type": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "house / unit / townhouse / ...",
- "title": "Dwelling Type"
- },
- "sale_date": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "ISO date (YYYY-MM-DD).",
- "title": "Sale Date"
- },
- "sale_price": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "description": "Sale price, AUD.",
- "title": "Sale Price"
- }
- },
- "title": "RecentSale",
- "type": "object"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Recent Sales Nearby"
- }
- },
- "title": "ComparablesAll",
- "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[ComparablesAll]",
- "type": "object",
- "x-fastmcp-top-level-schema": "ApiResponse_ComparablesAll_"
-}New value: +nullDoes the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare the operation as read-only, idempotent, closed-world, and non-destructive. The description adds a concrete behavioral trait not covered by annotations: the per-call price of 74¢, which is useful cost transparency.
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 front-loaded, with the core return content in the first sentence, followed by a use-case sentence and a clearly separated price note. Every sentence adds value with no waste.
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 bundle tool with no output schema, the description gives a high-level view of what is returned, but it omits any explanation of the required identifier and does not describe the shape or fields of the returned comparable set. The missing parameter guidance is a significant gap.
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?
The sole parameter, gnaf_id, has 0% schema description coverage and the description never mentions it. The agent receives no explanation of what a gnaf_id is or how to obtain one, so the description fails to compensate for the schema gap.
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 exactly what the tool returns: a CMA comparable set, the single closest comparable sale, and recent sales nearby. It explicitly identifies the bundle and distinguishes it from the sibling tools that provide each component individually.
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?
It gives clear context for when to use it — answering 'what did similar homes actually sell for' and showing valuation working rather than a bare number. However, it does not explicitly say when to choose this bundle over the individual sibling tools or state any exclusions.
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.