Skip to main content
Glama
Sign In

Microburbs Australian Property Data

by au.com.microburbs
OverviewDiscussionsAdmin

Suburb · Sale-price growth forecast

suburbs_forecast_sale
Read-onlyIdempotent

1-year sale-price growth forecast (low / most-likely / high).

Price: 100¢ per call.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "suburb_name": "<suburb_name>"
    },
    "name": "suburbs_forecast_sale"
  }
}

Input Schema

NameRequiredDescriptionDefault
suburb_nameYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput 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": "12-month sale-price growth forecast by property type.",
-          "example": {
-            "area_level": "suburb",
-            "area_name": "Belmont North",
-            "house": {
-              "confidence": 2,
-              "high": 0.0927,
-              "low": 0.0379,
-              "most_likely": 0.0686
-            },
-            "metric": "sale_price_growth_forecast",
-            "unit": {
-              "confidence": 2,
-              "high": 0.0993,
-              "low": 0.0353,
-              "most_likely": 0.0762
-            }
-          },
-          "properties": {
-            "area_level": {
-              "description": "Always 'suburb' for these endpoints.",
-              "title": "Area Level",
-              "type": "string"
-            },
-            "area_name": {
-              "description": "Suburb (SAL) name.",
-              "title": "Area Name",
-              "type": "string"
-            },
-            "house": {
-              "anyOf": [
-                {
-                  "description": "A forecast expressed as a range rather than a single number — a\nmost-likely outcome with a plausible low and high either side.\n\nEverywhere this shape appears the three figures are **growth over the\nnext 12 months, as a decimal fraction**: 0.0379 means +3.79% over the\nyear, and a negative value means a fall. Multiply by 100 to display as a\npercentage. Present the band, not just `most_likely` — the width between\n`low` and `high` is the honest part of the forecast.",
-                  "properties": {
-                    "confidence": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "How much weight to put on the forecast, on a 0–5 scale where 5 is most confident — it is not a percentage or a probability. High confidence means the low-to-high band is tight and the underlying market has enough sales to model; low confidence usually means a thin, volatile market where the band is wide.",
-                      "title": "Confidence"
-                    },
-                    "high": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Optimistic end of the 12-month growth forecast, same decimal-fraction scale as `low`. Not a ceiling.",
-                      "title": "High"
-                    },
-                    "low": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Pessimistic end of the 12-month growth forecast, as a decimal fraction (0.0379 = +3.79%; negatives are falls). Not a floor — outcomes can land below it.",
-                      "title": "Low"
-                    },
-                    "most_likely": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Central estimate of 12-month growth, as a decimal fraction. The single number to quote if you can only show one, but it should carry `low`/`high` with it.",
-                      "title": "Most Likely"
-                    }
-                  },
-                  "title": "ForecastBand",
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "House forecast band."
-            },
-            "metric": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Metric label, e.g. 'sale_price_growth_forecast'.",
-              "title": "Metric"
-            },
-            "unit": {
-              "anyOf": [
-                {
-                  "description": "A forecast expressed as a range rather than a single number — a\nmost-likely outcome with a plausible low and high either side.\n\nEverywhere this shape appears the three figures are **growth over the\nnext 12 months, as a decimal fraction**: 0.0379 means +3.79% over the\nyear, and a negative value means a fall. Multiply by 100 to display as a\npercentage. Present the band, not just `most_likely` — the width between\n`low` and `high` is the honest part of the forecast.",
-                  "properties": {
-                    "confidence": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "How much weight to put on the forecast, on a 0–5 scale where 5 is most confident — it is not a percentage or a probability. High confidence means the low-to-high band is tight and the underlying market has enough sales to model; low confidence usually means a thin, volatile market where the band is wide.",
-                      "title": "Confidence"
-                    },
-                    "high": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Optimistic end of the 12-month growth forecast, same decimal-fraction scale as `low`. Not a ceiling.",
-                      "title": "High"
-                    },
-                    "low": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Pessimistic end of the 12-month growth forecast, as a decimal fraction (0.0379 = +3.79%; negatives are falls). Not a floor — outcomes can land below it.",
-                      "title": "Low"
-                    },
-                    "most_likely": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Central estimate of 12-month growth, as a decimal fraction. The single number to quote if you can only show one, but it should carry `low`/`high` with it.",
-                      "title": "Most Likely"
-                    }
-                  },
-                  "title": "ForecastBand",
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Unit forecast band."
-            }
-          },
-          "required": [
-            "area_name",
-            "area_level"
-          ],
-          "title": "ForecastSale",
-          "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[ForecastSale]",
-  "type": "object",
-  "x-fastmcp-top-level-schema": "ApiResponse_ForecastSale_"
-}New value: +null
  2. First observed

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is covered. The description adds two genuinely useful facts beyond them — the 100¢ per-call charge and the three-tier output shape — but says nothing about the geography basis of the suburb, failure behavior for an unknown suburb, or pagination/latency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short, front-loaded fragments with no filler; the purpose leads and the cost follows. It is under-specified rather than bloated, which is a completeness problem more than a conciseness one.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a paid forecasting tool with no output schema and no documented parameter, the definition leaves out the input format, the time basis of the forecast, and what the returned tiers mean. An agent can guess the intent but cannot be confident it will call it correctly or know when a sibling is the better fit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% for the single parameter suburb_name, and the description adds nothing about it — no indication of whether a name, ID or postcode is expected, no format or matching rules. With zero schema coverage the description should compensate, and it does not.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource+horizon: "1-year sale-price growth forecast" with the three output tiers named (low / most-likely / high). It is not, however, differentiated from near-neighbours like suburbs_hero_price_growth_12mo or suburbs_market_price_growth_5y, so the agent must infer which horizon/scope applies.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not-to-use guidance and no named alternative among the many growth-related siblings. The only added instruction is a pricing note, which is a cost signal rather than a selection rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Microburbs Australian Property Data toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources