microburbs
The largest and most comprehensive real estate and geospatial dataset in Australia - every address, street and ABS mesh block in the country.
What it can do
- Ping: Returns immediately if the API is up. No authentication required and not metered — safe to poll from a load balancer, uptime monitor, or status dashboard without affecting your usage.
- Ping Head: Returns immediately if the API is up. No authentication required and not metered — safe to poll from a load balancer, uptime monitor, or status dashboard without affecting your usage.
- Me: Return key identity and the authoritative Autumn credit balance.
What data it sees
Do you need an account
No: the server works without sign-in
The largest and most comprehensive real estate and geospatial dataset in Australia - every address, street and ABS mesh block in the country.
Where most property data stops at the suburb, this goes below it:
- Crime at mesh-block level, not suburb averages
- Street-level price forecasts and per-street bedroom series
- 2026 Census demographics - income, tenure, ancestry, cohorts
- Risk — flood, bushfire, landslide, heritage, power lines, noise
- Development — applications, zoning, building controls, supply pipeline
- Schools with catchments and rankings; transport and amenity access
- Sales and rent history, comparable sales, land values and AVM valuations
174 tools across properties, streets, suburbs, LGAs, SA4s and mesh blocks.
Free sandbox, no signup. Send Bearer test and query nine sample suburbs, one per state and territory. Mint a key for national coverage.
How to connect
How to connect microburbs to Claude
The server address to paste into Claude settings:
https://microburbs--microburbs.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect microburbs to ChatGPT
The server address to paste into ChatGPT settings:
https://microburbs--microburbs.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect microburbs to Cursor
The server address to paste into Cursor settings:
https://microburbs--microburbs.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (60)
Raw names from tools/list. Only developers need these.
| ping | Returns immediately if the API is up. No authentication required and not metered — safe to poll from a load balancer, uptime monitor, or status dashboard without affecting your usage. |
| ping_head | Returns immediately if the API is up. No authentication required and not metered — safe to poll from a load balancer, uptime monitor, or status dashboard without affecting your usage. |
| me | Return key identity and the authoritative Autumn credit balance. |
| properties_valuation_avm | Microburbs ML AVM for a single GNAF — point estimate, 80% range, plus a confidence score (0–100) derived from the interval width. **Price: 10¢ per call.** |
| properties_basics_bed_count | Bedroom count from the latest matching listing. **Price: 5¢ per call.** |
| properties_basics_bath_count | Bathroom count from the latest matching listing. **Price: 5¢ per call.** |
| properties_basics_parking_count | Parking-space count from the latest matching listing. **Price: 5¢ per call.** |
| properties_basics_dwelling_type | Dwelling type (house, unit, townhouse, ...). **Price: 5¢ per call.** |
| properties_basics_land_area_sqm | Parcel land area in square metres from the cadastral feed. **Price: 3¢ per call.** |
| properties_profile | Resolve a GNAF to its full ABS Statistical Geography Standard hierarchy (Mesh Block → SA1 → SA2 → SA3 → SA4 → GCCSA → State) plus the parallel admin chain (LGA, suburb (SAL), postcode). Call this once to get every ABS key the rest of the data layers index on. **Price: 3¢ per call.** |
| properties_sale_history | All Sold + For Sale records, most-recent first. **Price: 30¢ per call.** |
| properties_sale_history_latest | Most-recent Sold or For Sale record. **Price: 10¢ per call.** |
| properties_rent_history | All For Rent records, most-recent first. **Price: 30¢ per call.** |
| properties_rent_history_latest | Most-recent For Rent record. **Price: 10¢ per call.** |
| properties_neighbours | Adjoining-parcel neighbours, enriched with address + property type + bed/bath/garage from the latest matching listing. **Price: 30¢ per call.** |
| properties_comparables_cma_comp_set | Top comparable sales used to triangulate the subject property's value. **Price: 60¢ per call.** |
| properties_comparables_cma_single_comp | Single best comparable from the CMA set (highest dist_score). **Price: 10¢ per call.** |
| properties_comparables_recent_sales_nearby | Recent comparable sales in a small radius around the subject parcel. **Price: 4¢ per call.** |
| properties_development_zoning_code | Primary zoning at the property's point — code (R2, B4, ...) when the council ships one, plus the human-readable name and the broader category. **Price: 3¢ per call.** |
| properties_development_zoning_overlays | Development overlays intersecting the property's parcel. **Price: 5¢ per call.** |
| properties_schools_nearby | Schools within ~5km of the property, with rank + student counts. **Price: 5¢ per call.** |
| properties_schools_ranking | Schools within ~5km of the property, ranked by NAPLAN / socioeconomic score. **Price: 100¢ per call.** |
| properties_amenities_nearby | Curated amenities (supermarkets, green spaces, restaurants/cafes) within `radius_m` of the property, bucketed and nearest-first. **Price: 10¢ per call.** |
| properties_transport_nearby | Nearest train / tram / bus / ferry stop to the property, per mode, with distance. Widen `radius_m` for the nearest station beyond 1km. **Price: 5¢ per call.** |
| properties_risks_bushfire | Bushfire-prone-area overlays within 1 km. Read `on_property` — a returned row means "found nearby", not "this property is in a bushfire zone". **Price: 15¢ per call.** |
| properties_risks_flood | Modelled flood overlays within 1 km. Read `on_property` — a returned row means "found nearby", not "this property floods". **Price: 10¢ per call.** |
| properties_risks_historical_flood | Recorded historical flood extents within 1 km. Read `on_property` — a returned row means "found nearby", not "this property flooded". **Price: 3¢ per call.** |
| properties_risks_heritage | Heritage-listing overlays within 1 km. Read `on_property` — a returned row means "found nearby", not "this property is heritage-listed". **Price: 3¢ per call.** |
| properties_risks_public_housing | Public-housing concentration overlay near the parcel. **Price: 4¢ per call.** |
| properties_risks_landslide | Landslide-risk overlays within 1 km. Read `on_property` — a returned row means "found nearby", not "this property is at landslide risk". **Price: 3¢ per call.** |
| properties_risks_erosion | Coastal / soil erosion overlays within 1 km. Read `on_property` — a returned row means "found nearby", not "this property is eroding". **Price: 3¢ per call.** |
| properties_risks_environment | Environmental-risk overlay (contamination, salinity, ...). **Price: 3¢ per call.** |
| properties_risks_hv_power_line | High-voltage power-line easement near the parcel. **Price: 2¢ per call.** |
| properties_risks_mobile_black_spot | Mobile-coverage black-spot overlay near the parcel. **Price: 2¢ per call.** |
| properties_risks_all | Every property-level risk overlay in one call. Flat 30¢ — may grow without increasing the bundle price as new overlays are added. With ``?geojson=true`` each risk that has a polygon overlay also carries its 1km-radius-clipped `geojson` FeatureCollection + `geojson_meta`. **Price: 48¢ per call.** |
| properties_valuation_all | **Price: 10¢ per call.** |
| properties_basics_all | **Price: 23¢ per call.** |
| properties_history_all | **Price: 80¢ per call.** |
| properties_comparables_all | **Price: 74¢ per call.** |
| properties_development_all | **Price: 8¢ per call.** |
| properties_schools_all | **Price: 105¢ per call.** |
| suburbs_profile | The suburb's upward ABS admin chain — LGA, SA2/3/4, GCCSA, state, postcode. Use ``/v1/suburbs/list`` to discover canonical SAL names (and filter by state / LGA / SA4 / postcode). |
| suburbs_list | List Australian suburbs (SALs). Always returns `{suburb, state}` per row so SAL-name collisions across states are unambiguous. With no filter you get the first 1000 suburbs alphabetically (browser-renderable preview). Pass any of the filters to narrow: state / lga / sa4 / sa3 / postcode / q (name search). Filters combine (AND). Flat cost regardless of how many rows come back. **Name search (`q`) is typo-tolerant.** It tries an exact match, then substring, then a fuzzy near-miss, and returns `match` (`exact` / `contains` / `fuzzy`) and `score` on every row so you can see which happened. **Always tell the user which suburb you resolved to, and its state, before quoting numbers for it.** A fuzzy match is a suggestion, not a confirmation — `rokeby` is one letter from Kokeby in Western Australia and Rokeby exists in both Tasmania and Victoria. If more than one candidate is plausible, ask rather than pick. When `q` is combined with `state`, the state is a **preference, not a filter**: in-state candidates rank first, but a suburb of that name in another state is still returned rather than hidden, so a near-miss becomes "Seaview is in Victoria, not Tasmania" instead of "no data". Every other filter stays a strict AND. **Price: 3¢ per call.** |
| suburbs_market_median_sale_price | Latest median sale price for the suburb. |
| suburbs_market_median_sale_price_series | Full median sale-price observation history for the suburb. Well-covered suburbs extend back 20+ years; coverage and observation frequency vary. This is the raw historical series needed to calculate a stated 20-year return, not a precomputed "consistent growth" score or a forecast. |
| suburbs_market_median_rent | Latest median weekly rent for the suburb. |
| suburbs_market_median_rent_series | Full median weekly-rent observation history for the suburb, including 2024 and 2025 where the suburb has coverage. Older observations are generally month-end and recent observations can be weekly; this is not a uniformly quarterly series. Values are advertised median AUD per week. |
| suburbs_market_price_growth_5y | 5-year compound sale-price growth (decimal). |
| suburbs_market_price_growth | Past compound sale-price growth over 1 / 3 / 5 / 10 years, by property type (decimal). The 3y / 10y figures are the same ones the Suburb Finder ranks on. |
| suburbs_market_yield_pct | Gross rental yield = median rent annualised / median sale price. |
| suburbs_market_days_on_market | Median days on market for current listings. |
| suburbs_market_transaction_volume | Recent sale-transaction count for the suburb. |
| suburbs_forecast_sale | 1-year sale-price growth forecast (low / most-likely / high). |
| suburbs_listings_for_sale | Current for-sale listings in the suburb, with address, price, beds/baths and coordinates per listing. `total` is the full number on the market (computed before `limit`), so a count is accurate even when the rows are capped. Raise `limit` for more listings; set `verbose=true` for the agent's full description text. |
| suburbs_demographics_age | Population by age bracket and gender. |
| suburbs_demographics_income | Household income breakdown by bracket. |
| suburbs_ethnicity_ancestry | Ancestry breakdown from the ABS census. |
| suburbs_ethnicity_birthplace | Country-of-birth breakdown from the ABS census. |
| suburbs_schools_catchment | Public-school catchment polygons covering the suburb. |
| suburbs_schools_nearby | Schools serving / near the suburb, with rank + attendance data. |