Skip to main content
Glama
Sign In

Microburbs Australian Property Data

by au.com.microburbs
OverviewDiscussionsAdmin

Extra risk indicators by mesh block (by suburb)

suburbs_risks_extras
Read-onlyIdempotent

Landslide / storm-tide coverage, environmental-protection notices, landlord-insurance medians and crime benchmark, with per-mesh-block detail.

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_risks_extras"
  }
}

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": "Extra suburb risk indicators — landslide and storm-tide coverage,\nEPA notices, landlord-insurance medians and crime benchmark, plus\nper-microburb detail under ``per_mb``.",
-          "example": {
-            "area_level": "suburb",
-            "area_name": "Belmont North",
-            "crime_bench": {
-              "nat_med": 2787.56,
-              "sub_med": 2248.01
-            },
-            "epa_notices_n": 3,
-            "insurance": {
-              "basic_med": 479,
-              "comp_med": 2542,
-              "n": 77,
-              "rent_med": 433
-            },
-            "landslide_pct": 0,
-            "per_mb": {
-              "insurance": [
-                {
-                  "mb": "10431160000",
-                  "score": 2551
-                }
-              ],
-              "risks": [
-                {
-                  "acid_pct": 0,
-                  "contam_pct": 100,
-                  "mb": "10431160000",
-                  "mine_pct": 100
-                }
-              ]
-            },
-            "storm_tide_high_pct": 0
-          },
-          "properties": {
-            "area_level": {
-              "const": "suburb",
-              "description": "Always 'suburb'.",
-              "title": "Area Level",
-              "type": "string"
-            },
-            "area_name": {
-              "description": "Canonical ABS SAL suburb name.",
-              "title": "Area Name",
-              "type": "string"
-            },
-            "crime_bench": {
-              "description": "Suburb vs national crime benchmark.",
-              "properties": {
-                "nat_med": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "National median total crime rate (predicted incidents per 100,000 residents per year).",
-                  "title": "Nat Med"
-                },
-                "sub_med": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "This suburb's median total crime rate (predicted incidents per 100,000 residents per year).",
-                  "title": "Sub Med"
-                }
-              },
-              "title": "CrimeBench",
-              "type": "object"
-            },
-            "epa_notices_n": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "EPA notices inside the suburb.",
-              "title": "Epa Notices N"
-            },
-            "insurance": {
-              "description": "Landlord-insurance medians.",
-              "properties": {
-                "basic_med": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Median basic landlord premium ($/yr).",
-                  "title": "Basic Med"
-                },
-                "comp_med": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Median comprehensive landlord premium ($/yr).",
-                  "title": "Comp Med"
-                },
-                "n": {
-                  "anyOf": [
-                    {
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Microburbs with an insurance estimate.",
-                  "title": "N"
-                },
-                "rent_med": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Median weekly rent ($) — for premium-vs-rent context.",
-                  "title": "Rent Med"
-                }
-              },
-              "title": "RiskInsurance",
-              "type": "object"
-            },
-            "landslide_pct": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "% of suburb area in a landslide-risk overlay.",
-              "title": "Landslide Pct"
-            },
-            "per_mb": {
-              "description": "Per-microburb detail arrays.",
-              "properties": {
-                "insurance": {
-                  "description": "Per-MB insurance premium scores.",
-                  "items": {
-                    "additionalProperties": true,
-                    "description": "One microburb's landlord-insurance premium score.",
-                    "properties": {
-                      "mb": {
-                        "description": "ABS 2021 mesh-block code.",
-                        "title": "Mb",
-                        "type": "string"
-                      },
-                      "score": {
-                        "anyOf": [
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "Comprehensive landlord premium estimate ($/yr).",
-                        "title": "Score"
-                      }
-                    },
-                    "required": [
-                      "mb"
-                    ],
-                    "title": "InsurancePerMb",
-                    "type": "object"
-                  },
-                  "title": "Insurance",
-                  "type": "array"
-                },
-                "risks": {
-                  "description": "Per-MB contamination / mine / ANEF / acid shares.",
-                  "items": {
-                    "additionalProperties": true,
-                    "description": "One microburb's per-property risk shares.",
-                    "properties": {
-                      "acid_pct": {
-                        "anyOf": [
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "% of properties at high acid-sulfate risk.",
-                        "title": "Acid Pct"
-                      },
-                      "anef_med": {
-                        "anyOf": [
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "Median aircraft-noise ANEF (null = no exposure).",
-                        "title": "Anef Med"
-                      },
-                      "contam_pct": {
-                        "anyOf": [
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "% of properties within 500 m of contamination.",
-                        "title": "Contam Pct"
-                      },
-                      "mb": {
-                        "description": "ABS 2021 mesh-block code.",
-                        "title": "Mb",
-                        "type": "string"
-                      },
-                      "mine_pct": {
-                        "anyOf": [
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "description": "% of properties in a mine-subsidence district.",
-                        "title": "Mine Pct"
-                      }
-                    },
-                    "required": [
-                      "mb"
-                    ],
-                    "title": "RiskPerMb",
-                    "type": "object"
-                  },
-                  "title": "Risks",
-                  "type": "array"
-                }
-              },
-              "required": [
-                "insurance",
-                "risks"
-              ],
-              "title": "RiskExtrasPerMb",
-              "type": "object"
-            },
-            "storm_tide_high_pct": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "% of suburb area in the high storm-tide band.",
-              "title": "Storm Tide High Pct"
-            }
-          },
-          "required": [
-            "area_name",
-            "area_level",
-            "insurance",
-            "crime_bench",
-            "per_mb"
-          ],
-          "title": "RiskExtras",
-          "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[RiskExtras]",
-  "type": "object",
-  "x-fastmcp-top-level-schema": "ApiResponse_RiskExtras_"
-}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 readOnlyHint, idempotentHint, destructiveHint=false and closed-world scope, so safety is covered. The description adds one genuinely useful non-schema fact: a 20¢ per-call charge, which matters for cost-sensitive agents. It says nothing about response shape, aggregation level, or whether mesh-block detail is returned as a list or summary.

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 compact sentences with the substantive content front-loaded and the cost disclosure clearly separated. Nothing is padded, though the price line could be folded into a single sentence without loss.

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?

For a simple single-parameter read tool with no output schema, the description covers the data domains and the cost, which is close to sufficient. The remaining gaps — acceptable suburb_name format and what the per-mesh-block payload looks like — are real but modest given the rich annotations.

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?

There is a single required parameter, suburb_name, with 0% schema description coverage, and the description never clarifies its expected form (suburb name string vs. code, case sensitivity, ambiguity handling). With no other parameters, the burden was small, but the description adds nothing beyond restating the resource area.

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 data families returned (landslide/storm-tide coverage, environmental-protection notices, landlord-insurance medians, crime benchmark) and the granularity (per-mesh-block detail), so an agent can tell this is a bundled 'extras' risk lookup. It stops short of distinguishing itself from closely named siblings such as suburbs_risks_all or suburbs_risks_flood, so selection between them still requires guesswork.

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 explicit when-to-use or when-not-to-use guidance, and no mention of the obvious alternatives (suburbs_risks_all, suburbs_risks_flood, suburbs_risks_counts). The only implicit routing signal is the stated price, which hints this is a paid premium call but does not say when paying it is worthwhile.

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