Skip to main content
Glama
Sign In

Microburbs Australian Property Data

by au.com.microburbs
OverviewDiscussionsAdmin

Suburb · Building controls — height & FSR

suburbs_development_building_controls
Read-onlyIdempotent

Height-of-building and floor-space-ratio control polygons with band summaries.

Price: 20¢ 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_development_building_controls"
  }
}

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": "Height-of-building + floor-space-ratio planning controls.\n\nEither block can be null — many LGAs map HOB but not FSR (or vice\nversa). A 404 means neither layer exists for the suburb.",
-          "example": {
-            "area_level": "suburb",
-            "area_name": "Belmont North",
-            "hob": {
-              "geojson": {
-                "features": [
-                  {
-                    "geometry": {
-                      "coordinates": [
-                        [
-                          [
-                            151.668,
-                            -33.017
-                          ],
-                          [
-                            151.672,
-                            -33.017
-                          ],
-                          [
-                            151.672,
-                            -33.02
-                          ],
-                          [
-                            151.668,
-                            -33.017
-                          ]
-                        ]
-                      ],
-                      "type": "Polygon"
-                    },
-                    "properties": {
-                      "band": "≤ 8.5m",
-                      "color": "#fef9c3",
-                      "height_m": 8.5,
-                      "units": "m"
-                    },
-                    "type": "Feature"
-                  }
-                ],
-                "type": "FeatureCollection"
-              },
-              "legend": [
-                {
-                  "color": "#fef9c3",
-                  "label": "≤ 8.5m",
-                  "pct": 84.2
-                },
-                {
-                  "color": "#fbbf24",
-                  "label": "8.5–12m",
-                  "pct": 15.8
-                }
-              ],
-              "most_common_height_m": 8.5,
-              "pct_most_common": 71,
-              "zones_mapped": 17
-            }
-          },
-          "properties": {
-            "area_level": {
-              "description": "Always 'suburb'.",
-              "title": "Area Level",
-              "type": "string"
-            },
-            "area_name": {
-              "description": "Suburb (SAL) name.",
-              "title": "Area Name",
-              "type": "string"
-            },
-            "fsr": {
-              "anyOf": [
-                {
-                  "additionalProperties": true,
-                  "description": "Floor-space-ratio controls summary + polygons.",
-                  "properties": {
-                    "breakdown": {
-                      "description": "Area share per FSR band.",
-                      "items": {
-                        "description": "One legend band with its share of the mapped area.",
-                        "properties": {
-                          "color": {
-                            "description": "Hex colour for map styling.",
-                            "title": "Color",
-                            "type": "string"
-                          },
-                          "label": {
-                            "description": "Band label (e.g. '8.5–12m', '≤ 0.5:1').",
-                            "title": "Label",
-                            "type": "string"
-                          },
-                          "pct": {
-                            "description": "Share of mapped area in this band (%).",
-                            "title": "Pct",
-                            "type": "number"
-                          }
-                        },
-                        "required": [
-                          "label",
-                          "color",
-                          "pct"
-                        ],
-                        "title": "BandShare",
-                        "type": "object"
-                      },
-                      "title": "Breakdown",
-                      "type": "array"
-                    },
-                    "geojson": {
-                      "description": "FSR polygons. Feature properties: fsr, band, color.",
-                      "properties": {
-                        "features": {
-                          "description": "Feature list.",
-                          "items": {
-                            "description": "RFC 7946 Feature — geometry + endpoint-specific properties.",
-                            "properties": {
-                              "geometry": {
-                                "additionalProperties": true,
-                                "description": "GeoJSON geometry (Polygon or MultiPolygon).",
-                                "title": "Geometry",
-                                "type": "object"
-                              },
-                              "properties": {
-                                "additionalProperties": true,
-                                "description": "Per-feature attributes — see the endpoint's example.",
-                                "title": "Properties",
-                                "type": "object"
-                              },
-                              "type": {
-                                "const": "Feature",
-                                "description": "Always 'Feature'.",
-                                "title": "Type",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "type",
-                              "geometry",
-                              "properties"
-                            ],
-                            "title": "GeoJsonFeature",
-                            "type": "object"
-                          },
-                          "title": "Features",
-                          "type": "array"
-                        },
-                        "type": {
-                          "const": "FeatureCollection",
-                          "description": "Always 'FeatureCollection'.",
-                          "title": "Type",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "type",
-                        "features"
-                      ],
-                      "title": "GeoJsonFeatureCollection",
-                      "type": "object"
-                    },
-                    "median_fsr": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Area-weighted median FSR (e.g. 1.5 = 1.5:1).",
-                      "title": "Median Fsr"
-                    }
-                  },
-                  "required": [
-                    "breakdown",
-                    "geojson"
-                  ],
-                  "title": "FsrControls",
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Floor-space-ratio controls."
-            },
-            "hob": {
-              "anyOf": [
-                {
-                  "additionalProperties": true,
-                  "description": "Height-of-building controls summary + polygons.",
-                  "properties": {
-                    "geojson": {
-                      "description": "HOB polygons. Feature properties: height_m, units, band, color.",
-                      "properties": {
-                        "features": {
-                          "description": "Feature list.",
-                          "items": {
-                            "description": "RFC 7946 Feature — geometry + endpoint-specific properties.",
-                            "properties": {
-                              "geometry": {
-                                "additionalProperties": true,
-                                "description": "GeoJSON geometry (Polygon or MultiPolygon).",
-                                "title": "Geometry",
-                                "type": "object"
-                              },
-                              "properties": {
-                                "additionalProperties": true,
-                                "description": "Per-feature attributes — see the endpoint's example.",
-                                "title": "Properties",
-                                "type": "object"
-                              },
-                              "type": {
-                                "const": "Feature",
-                                "description": "Always 'Feature'.",
-                                "title": "Type",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "type",
-                              "geometry",
-                              "properties"
-                            ],
-                            "title": "GeoJsonFeature",
-                            "type": "object"
-                          },
-                          "title": "Features",
-                          "type": "array"
-                        },
-                        "type": {
-                          "const": "FeatureCollection",
-                          "description": "Always 'FeatureCollection'.",
-                          "title": "Type",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "type",
-                        "features"
-                      ],
-                      "title": "GeoJsonFeatureCollection",
-                      "type": "object"
-                    },
-                    "legend": {
-                      "description": "Area share per height band.",
-                      "items": {
-                        "description": "One legend band with its share of the mapped area.",
-                        "properties": {
-                          "color": {
-                            "description": "Hex colour for map styling.",
-                            "title": "Color",
-                            "type": "string"
-                          },
-                          "label": {
-                            "description": "Band label (e.g. '8.5–12m', '≤ 0.5:1').",
-                            "title": "Label",
-                            "type": "string"
-                          },
-                          "pct": {
-                            "description": "Share of mapped area in this band (%).",
-                            "title": "Pct",
-                            "type": "number"
-                          }
-                        },
-                        "required": [
-                          "label",
-                          "color",
-                          "pct"
-                        ],
-                        "title": "BandShare",
-                        "type": "object"
-                      },
-                      "title": "Legend",
-                      "type": "array"
-                    },
-                    "most_common_height_m": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Modal height limit across mapped zones (metres).",
-                      "title": "Most Common Height M"
-                    },
-                    "pct_most_common": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Share of zones at the modal height (%).",
-                      "title": "Pct Most Common"
-                    },
-                    "zones_mapped": {
-                      "description": "Number of height-control zones counted (RL reference levels >30m excluded).",
-                      "title": "Zones Mapped",
-                      "type": "integer"
-                    }
-                  },
-                  "required": [
-                    "zones_mapped",
-                    "legend",
-                    "geojson"
-                  ],
-                  "title": "HobControls",
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Height-of-building controls."
-            }
-          },
-          "required": [
-            "area_name",
-            "area_level"
-          ],
-          "title": "SuburbBuildingControls",
-          "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[SuburbBuildingControls]",
-  "type": "object",
-  "x-fastmcp-top-level-schema": "ApiResponse_SuburbBuildingControls_"
-}New value: +null
  2. First observed

TDQS

B3/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered. The description adds one genuinely new behavioral fact beyond the annotations: a 20¢ per-call cost, which matters for an agent deciding whether to call it repeatedly. It says nothing about result size, units, or geometry format.

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 sentences, front-loaded with what is returned. The price note is separated and clearly delimited, so nothing competes with the core statement. No wasted words.

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

Completeness3/5

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

With no output schema and no parameter documentation, the description is the only place to explain what the polygons and band summaries look like, what the height/FSR units are, and what a suburb_name must be. It covers the output topic at a high level (polygons + band summaries) but leaves format, units, and coverage gaps unexplained. Adequate for a one-parameter read tool, but thin.

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 required parameter, so the description carries the burden — and it says nothing about suburb_name. It does not clarify whether the value is a suburb name, a code, or a normalized key, nor what happens for unmatched suburbs. The parameter name is self-evident but the description adds zero meaning.

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?

The description names the specific resource and its two measures: height-of-building and floor-space-ratio control polygons with band summaries. An agent can tell this is a planning-controls geometry lookup rather than a zoning map or density stat. It lacks an explicit verb (retrieve/return), but the content is otherwise unambiguous.

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 guidance on when to use this tool, no prerequisites, and no mention of when to prefer a sibling such as the zoning map or development profile. The only advisory content is a price note, which is not usage guidance.

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