release_calendar
Retrieve upcoming Australian Bureau of Statistics publication schedules. Filter by days ahead to see scheduled data releases with titles and release times.
Instructions
Upcoming ABS publication schedule (data releases).
Scrapes the official ABS release calendar
(https://www.abs.gov.au/release-calendar/future-releases-calendar) and
returns each scheduled publication with its release timestamp, title,
reference period, and — when the title maps to a curated abs-mcp
dataset — the dataset_id an agent can plug into get_data or
latest. Curated mappings cover the 10 datasets in list_curated()
plus a handful of commonly-watched non-curated catalogues (Retail
Trade, International Trade in Goods, etc., where dataset_id stays
null but publication_id carries the ABS catalogue number).
release_at is returned with Sydney's local UTC offset (+10:00 AEST
or +11:00 AEDT) — what ABS publishes against. The DST switch is
naive (month-based), within an hour of correct at the changeover
boundary; downstream code should treat the offset as authoritative
rather than re-deriving local time.
Examples: # Next 7 days cal = await release_calendar(7) for r in cal.releases: print(r.release_at, r.title, r.dataset_id)
# Filter to curated datasets only
cal = await release_calendar(30)
curated_releases = [r for r in cal.releases if r.dataset_id]When to use: - Building a webhook / notification feed (ABS publishes at 11:30 AEST) - "What's next from the ABS?" agent answers - Pre-warming caches the morning of a known release
Returns:
ReleaseCalendarResponse — same envelope shape as rba-mcp's
release_calendar for portfolio interop. Sorted ascending by
release_at. stale=True + stale_reason is set when the live
HTML scrape failed and a cached payload was served past TTL.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days_ahead | No | Horizon in days. Returns ABS publications scheduled to release between now and `now + days_ahead`. Default 30 covers the typical monthly + quarterly cadence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stale | No | ||
| source | No | Australian Bureau of Statistics | |
| releases | No | ||
| row_count | Yes | ||
| source_url | No | https://www.abs.gov.au/release-calendar | |
| attribution | No | Data sourced from the Australian Bureau of Statistics and licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). https://www.abs.gov.au/about/copyright-and-creative-commons | |
| horizon_days | Yes | ||
| retrieved_at | Yes | ||
| stale_reason | No | ||
| server_version | No |