Skip to main content
Glama
au-weather-mcp

au-weather-mcp

au-weather-mcp

mcp-name: io.ausdata/au-weather-mcp

PyPI Python License Tests CodeQL Glama MCP server quality

Ask Claude about Australian weather and air quality and get real, current numbers — not "I don't have access to that data." This MCP server gives Claude (and other MCP clients like Cursor) live access to Australian weather + air-quality data via Open-Meteo, which aggregates Bureau of Meteorology observations under licence. 45 curated locations (every state capital + every regional centre over ~25k), postcode and place-name lookup, current observations, 16-day forecasts, 80+ years of historical data, and multi-location comparison.

Hosted access? For cross-source queries, webhooks, an always-on REST API, and a uniform response envelope across all 9 sources, see ausdata.io — free tier available (500 calls/mo, no card).

Companion to abs-mcp (ABS macro stats), rba-mcp (Reserve Bank), and ato-mcp (tax + charity register) — together the four cover Australia's most-asked public data.

What you can ask

Once installed, your LLM can answer questions like:

Question

Real response

What's the weather in Sydney right now?

Current temperature, humidity, wind, rain, pressure with the time stamped

Forecast for Melbourne next week?

7-day daily forecast with max/min temps and rain

How was Sydney summer in January 2020?

Historical daily data from Open-Meteo's archive (1940+)

Compare rainfall in Cairns vs Brisbane this year

Multi-location queries with provenance per row

Tropical Queensland weather today

Search fuzzy by region/state/description

Every response carries a CC-BY 4.0 attribution string and a direct Open-Meteo URL the agent can cite back to the user.

Related MCP server: au-weather-mcp

Why Open-Meteo (not BOM directly)

BOM publishes their own JSON/XML endpoints, but they actively 403 non-browser User-Agents and have no documented commercial-use path below their ~$5k/yr Registered User Service. Open-Meteo:

  • Aggregates BOM data under their existing licensing arrangements with national meteorological services

  • Free tier is explicit and generous; commercial use is $30/mo with public terms

  • Returns clean, versioned, schema-stable JSON with units alongside every value

  • Covers historical data back to 1940 via their archive endpoint

  • No API key, no User-Agent gymnastics

We attribute both Open-Meteo and BOM in every response.

Install

# After publish:
uvx au-weather-mcp

# Local dev:
uv pip install -e .

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "weather": {
      "command": "uvx",
      "args": ["--upgrade", "au-weather-mcp"]
    }
  }
}

The --upgrade flag makes uvx re-check PyPI on each Claude Desktop launch, so bug fixes propagate without manual cache refresh. Costs ~100ms at startup.

For a local checkout (before PyPI publish):

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/au-weather-mcp", "au-weather-mcp"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "weather": {
      "command": "uvx",
      "args": ["--upgrade", "au-weather-mcp"]
    }
  }
}

Tools

Tool

What it does

search_locations(query, limit=10)

Fuzzy-search the 45 curated AU locations by name, state, or description.

describe_location(location)

Lat/lng, timezone, elevation, nearest BOM station, and the canonical Open-Meteo URL.

latest(location)

Current weather observation — temp, humidity, wind, rain, pressure. 15-min cache.

get_weather(location, start_date, end_date, granularity)

Time-series query. Auto-routes to historical archive (1940+) or forecast (today + 16 days). Daily or hourly granularity.

air_quality(location)

Current PM2.5, PM10, ozone, NO₂, SO₂, CO + European & US AQI with plain-English labels. (v0.4.0)

compare_locations([locs])

Side-by-side current weather for 2–10 locations in one call. Fans out concurrently. (v0.4.0)

list_curated()

All 45 supported location IDs.

Accepts almost any input shape

The location parameter on every tool resolves six different input shapes — agents and users don't need to know the curated key format:

Input shape

Example

Resolves via

Curated ID

"sydney", "gold_coast"

Direct curated lookup (fast)

Place name, any case

"Sydney", "Gold Coast", "GOLD COAST"

Normalised curated lookup

State code or full name

"NSW", "Queensland", "Western Australia"

State → capital alias

Raw coordinates

"-33.87,151.21"

Direct lat/lng (AU bbox enforced)

AU postcode

"2026" (Bondi Beach), "4217" (Gold Coast), "6160" (Fremantle)

OpenStreetMap Nominatim

Any AU place name

"Byron Bay", "Margaret River", "Toowoomba"

Open-Meteo geocoding (AU-filtered, population-sorted)

Typo of a curated name

"Sydny", "Melbourn"

High-confidence fuzzy match

Every response includes a location_resolution field with one of curated, state_alias, raw_coordinates, geocoded, or fuzzy_curated — so the agent (and the user) can see HOW the input was interpreted.

Curated locations

45 curated locations covering all 8 state/territory capitals plus 37 major regional centres (every AU population centre over ~25k). Anything outside the curated set still works via the place-name geocoder or postcode lookup.

Region

Locations

Capitals (8)

sydney · melbourne · brisbane · perth · adelaide · hobart · darwin · canberra

NSW regional (10)

newcastle · wollongong · tamworth · wagga_wagga · albury · orange · bathurst · dubbo · coffs_harbour · port_macquarie

QLD regional (9)

gold_coast · sunshine_coast · cairns · townsville · mackay · toowoomba · rockhampton · bundaberg · hervey_bay

VIC regional (6)

geelong · ballarat · bendigo · mildura · shepparton · warrnambool

WA regional (5)

broome · bunbury · geraldton · albany · kalgoorlie

SA regional (2)

mount_gambier · whyalla

TAS regional (3)

launceston · devonport · burnie

NT regional (2)

alice_springs · katherine

Coordinates are anchored to the canonical BOM observation point for each city (e.g. Sydney = Observatory Hill, Melbourne = Olympic Park) so cross-checking against BOM's official observations is straightforward. See src/au_weather_mcp/data/curated/locations.yaml for the full registry.

Worked examples

"What's the weather in Sydney right now?"

latest(location="sydney")

Returns:

{
  "location_id": "sydney",
  "location_name": "Sydney",
  "state": "NSW",
  "latitude": -33.8607,
  "longitude": 151.205,
  "timezone": "Australia/Sydney",
  "period": {"start": "2026-05-12T11:30", "end": "2026-05-12T11:30"},
  "current": {
    "time": "2026-05-12T11:30",
    "temperature_c": 19.7,
    "apparent_temperature_c": 18.1,
    "relative_humidity_pct": 67,
    "precipitation_mm": 0.0,
    "cloud_cover_pct": 43,
    "pressure_msl_hpa": 1034.5,
    "wind_speed_kmh": 18.4,
    "wind_direction_deg": 149,
    "wind_gusts_kmh": 43.2,
    "weather_code": 1,
    "weather_description": "Mainly clear"
  },
  "source": "Open-Meteo (aggregates Bureau of Meteorology data under licence)",
  "attribution": "Weather data by Open-Meteo.com (https://open-meteo.com), licensed under CC BY 4.0...",
  "source_url": "https://api.open-meteo.com/v1/forecast?latitude=-33.8607&...",
  "server_version": "<package version, e.g. 0.3.3>",
  "location_resolution": "curated",
  "location_input": "sydney"
}

"How was Sydney in January 2020?"

get_weather(
  location="sydney",
  start_date="2020-01-01",
  end_date="2020-01-31",
  granularity="daily"
)

Returns 31 DailyAggregate rows with temperature_max_c, temperature_min_c, precipitation_sum_mm, and weather descriptions per day.

"7-day Melbourne forecast, hourly detail"

get_weather(
  location="melbourne",
  start_date="2026-05-12",
  end_date="2026-05-19",
  granularity="hourly"
)

Returns 168 hourly rows.

Date formats

start_date and end_date must be YYYY-MM-DD. The server validates both the regex and the semantic date — 2024-13-40 raises a clean ValueError rather than silently failing.

Date range

Routes to

Coverage

end_date >= today - 5 days

Open-Meteo forecast endpoint

Today + 16 days

end_date < today - 5 days

Open-Meteo historical archive

1940-01-01 onwards

Trust contract

Every response carries:

  • source_url — the exact Open-Meteo URL the data came from

  • attribution — CC-BY 4.0 notice for both Open-Meteo and BOM

  • retrieved_at — UTC timestamp when we fetched

  • server_version — which wheel served the call (debugging stale uvx caches)

  • stale — true if we're serving cached data because upstream failed; comes with stale_reason

Sanity validators reject upstream values outside the plausible Australian range (temperature outside −30°C to +55°C, humidity outside 0-100%, pressure outside 850-1080 hPa). Rather than silently passing bad data to your agent, we raise an explicit validation error so the agent can degrade gracefully.

Development

git clone https://github.com/Bigred97/au-weather-mcp.git
cd au-weather-mcp
uv sync --extra dev
uv pip install -e .

# Unit tests (no network)
uv run pytest

# Live integration tests (hits Open-Meteo)
uv run pytest -m live

The SQLite cache lives at ~/.au-weather-mcp/cache.db. Current observations refresh every 15 minutes (matching Open-Meteo's update cadence), forecasts every 1 hour, historical never (a year-old day in the archive doesn't change). Delete the file to force a refresh.

Sister MCPs (Australian Public Data portfolio)

The portfolio runs side-by-side in any MCP client; Claude disambiguates via the server prefix (weather:latest vs abs:latest vs rba:latest vs ato:get_data).

Want all 9 sources behind one REST API? The hosted gateway at ausdata.io adds cross-source joins, full history, webhooks, and HMAC-signed responses on top of these MCPs — free tier (500 calls/mo, no card).

  • abs-mcp — Australian Bureau of Statistics (CPI, unemployment, ERP, building approvals)

  • rba-mcp — Reserve Bank of Australia (cash rate, lending stats, exchange rates)

  • ato-mcp — Australian Taxation Office (tax stats, ACNC charities)

  • apra-mcp — Australian Prudential Regulation Authority (banking, insurance, super)

  • aihw-mcp — Australian Institute of Health and Welfare

  • asic-mcp — Australian Securities and Investments Commission (company registers)

  • aemo-mcp — Australian Energy Market Operator (NEM dispatch, spot prices, generation)

  • au-weather-mcp — this one. Open-Meteo (Bureau of Meteorology aggregator).

  • wgea-mcp — Workplace Gender Equality Agency

  • aus-identity — Postcode / state / ABN normalisation helper used by all sisters

Data attribution

Weather data is provided by Open-Meteo, licensed under CC BY 4.0. The underlying observations include data from the Australian Bureau of Meteorology under Open-Meteo's licensing arrangement.

Postcode resolutions (when location_resolution == "postcode") additionally use OpenStreetMap via the Nominatim service, licensed under the Open Database Licence (ODbL). The OSM attribution is automatically appended to the response's attribution field for any postcode lookup, so redistribution is licence-compliant out of the box.

If you redistribute responses, credit Open-Meteo + BOM (always) and OpenStreetMap (when postcode lookup was used).

Changelog

See CHANGELOG.md for release history.

License

MIT — Harry Vass, 2026.

Available Tools

7 tools
air_qualityA

Return current air-quality readings for any Australian location.

Sourced from Open-Meteo's air-quality API, which merges Copernicus CAMS European + global air-composition models. Returns PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, carbon monoxide (all µg/m³), plus the European and US AQI indices with plain-English labels.

Especially useful during AU bushfire season (Oct–Mar) when smoke can push PM2.5 above safe levels across whole regions.

Examples: # Current Sydney air quality resp = await air_quality("sydney") # resp.current.pm2_5_ugm3 == 8.8 # resp.current.european_aqi == 21 # resp.current.european_aqi_label == 'Good' # resp.current.us_aqi == 39 # resp.current.us_aqi_label == 'Good'

# Bushfire smoke check for the Blue Mountains
resp = await air_quality("-33.7,150.3")

# Brisbane CBD via postcode
resp = await air_quality("4000")

When to use: - "Is the air clean enough to go for a run in ?" - Bushfire smoke or burn-off impact checks - Asthma / allergy planning - Long-term air quality monitoring (call periodically and chart)

Returns: AirQualityResponse with current populated (pollutants + AQI scales), plus location metadata, source_url, attribution, and server_version.

Inputs: location (required). Returns: Air-quality response envelope. Same trust contract as WeatherResponse: source_u…

compare_locationsA

Compare current weather across multiple Australian locations in one call.

Fans out concurrently via asyncio.gather, so all locations come back in roughly the time of a single call (after the cache is warm). Each location is independently resolved (curated / state / postcode / geocode / etc.) and independently fetched. If one location fails (e.g. geocoder can't find it), that row gets an error field while the rest still return.

Examples: # Capital-city dashboard resp = await compare_locations(["sydney","melbourne","brisbane","perth"]) for row in resp.locations: print(row.location_name, row.current.temperature_c)

# Tropical north today
resp = await compare_locations(["Cairns","Darwin","Townsville","Broome"])

# Mixed input shapes work
resp = await compare_locations(["sydney","NSW","2026","-33.87,151.21"])

When to use: - "Compare weather in " — the canonical use case - Build a multi-region dashboard in one tool call - Plan a holiday across regions

Returns: ComparisonResponse with one ComparisonRow per input location. Successful rows have current populated; failed rows have error.

Inputs: locations (required). Returns: Side-by-side weather comparison across N locations. Each ComparisonRow has the…

describe_locationA

Return metadata for an Australian location — name, lat/lng, timezone, elevation, and (for curated locations) the nearest BOM station ID.

Accepts a wide range of input shapes for compatibility — see the location parameter description. The returned id is None for non-curated lookups (geocoded place names, raw coordinates) and a snake_case curated key when the input matched the curated set.

Examples: await describe_location("sydney") # → curated path await describe_location("Sydney") # → curated path (case-insensitive) await describe_location("NSW") # → state capital (Sydney) await describe_location("Margaret River") # → geocoded (Western Australia) await describe_location("-33.87,151.21") # → raw coordinates

When to use: - Before calling get_weather, to confirm coordinates and timezone - To cross-reference with BOM's own observation network (for curated) - To verify how the server resolved an ambiguous customer input

Returns: LocationDetail with id (or None), name, state, lat/lng, timezone, elevation, nearest BOM station ID (curated only), the Open-Meteo URL, and the CC-BY attribution.

Inputs: location (required). Returns: Full metadata for one location — surface for describe_location. `id` is the cur…

get_weatherA

Query weather over a date range. Routes to historical archive or forecast endpoint automatically based on the date range.

Routing logic: - end_date in the past (>= 5 days ago) → historical archive (1940+) - start_date in the future → forecast (today + 16 days max) - range straddles today → forecast with past_days set

Examples: # Historical: how was Sydney summer 2020? resp = await get_weather( "sydney", start_date="2020-01-01", end_date="2020-01-31", granularity="daily", ) # → 31 DailyAggregate rows with temp_max, temp_min, precip per day

# 7-day forecast for Melbourne, hourly detail
resp = await get_weather(
    "melbourne",
    start_date="2026-05-12",
    end_date="2026-05-19",
    granularity="hourly",
)
# → 168 hourly WeatherObservation rows

# Just today (omit both dates)
resp = await get_weather("brisbane")
# → today's daily aggregate

When to use: - Time-series queries (forecast over the next week, or historical comparison) - Multi-day weather analysis - Climate research and historical look-backs (decade-scale via archive)

Returns: WeatherResponse with either daily or hourly populated depending on granularity. Period bounds populated from actual returned data.

Inputs: location (required), end_date, start_date, granularity. Returns: Common response envelope for current/forecast/historical queries. Trust contrac…

latestA

Return the current weather observation for any Australian location.

Wraps Open-Meteo's /forecast endpoint with current=... parameters and a 15-minute cache TTL (matches Open-Meteo's own update cadence). Use for "what's the weather right now?" — warm-cache latency < 100 ms.

Examples: resp = await latest("sydney") # curated, fast path resp = await latest("Sydney") # case-insensitive resp = await latest("Byron Bay") # geocoded resp = await latest("NSW") # state → Sydney resp = await latest("-33.87,151.21") # raw coordinates

The response's location_resolution field tells the agent how the input was interpreted ('curated', 'state_alias', 'geocoded', 'raw_coordinates', or 'fuzzy_curated').

When to use: - "What's the weather right now in ?" — canonical use case - Multi-city current-conditions dashboards (call once per place) - Anchoring agent conversations to live weather context

Returns: WeatherResponse with current populated, plus location metadata, resolution source, source_url, CC-BY attribution, and server_version.

Inputs: location (required). Returns: Common response envelope for current/forecast/historical queries. Trust contrac…

list_curatedA

List the 45 curated Australian location IDs supported by this MCP.

The curated set covers all 8 state/territory capitals plus 37 major regional centres. Any Australian place name outside this set still works via the place-name geocoder; the curated entries just get fast-path lookup (no network call) and appear in search_locations.

Coverage by state: - 8 capitals: sydney, melbourne, brisbane, perth, adelaide, hobart, darwin, canberra - NSW regional (10): newcastle, wollongong, tamworth, wagga_wagga, albury, orange, bathurst, dubbo, coffs_harbour, port_macquarie - VIC regional (6): geelong, ballarat, bendigo, mildura, shepparton, warrnambool - QLD regional (9): gold_coast, sunshine_coast, cairns, townsville, mackay, toowoomba, rockhampton, bundaberg, hervey_bay - WA regional (5): broome, bunbury, geraldton, albany, kalgoorlie - SA regional (2): mount_gambier, whyalla - TAS regional (3): launceston, devonport, burnie - NT regional (2): alice_springs, katherine

When to use: - You want to enumerate which locations have first-class support - You're building a UI / dashboard that needs the supported set up front - You want to plan a multi-location dashboard call

Returns: Sorted list of location IDs (currently 45). Adding a location is a YAML edit in src/au_weather_mcp/data/curated/locations.yaml.

Inputs: no named parameters. Returns: result

search_locationsA

Fuzzy-search the 45 curated Australian locations.

The curated set covers all 8 state/territory capitals plus 37 major regional centres (every AU population centre over ~25k). Anything outside the curated set still resolves via place-name geocoding or postcode lookup — see list_curated() for the full set.

Examples: results = await search_locations("sydney") # → [{id: 'sydney', name: 'Sydney', state: 'NSW', ...}]

results = await search_locations("nsw")
# → Newcastle, Wollongong, Sydney (all NSW locations)

When to use: - Discover the location ID for a city you know by name - Find all supported locations in a state - Verify whether a place is in the curated set before calling get_weather

Returns: List of LocationSummary (id, name, state, description), ranked by relevance.

Inputs: query (required), limit. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clear, distinct role: get_weather handles time-series, latest handles current conditions, air_quality handles pollutants, compare_locations handles multi-city current weather, and the three location tools each serve different discovery/metadata purposes. No two tools appear interchangeable.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern: get_weather, search_locations, describe_location, compare_locations, and list_curated. The exceptions are 'latest' and 'air_quality', which are still readable and unambiguous but break the pattern slightly.

    Tool Count5/5

    Seven tools is well-scoped for a weather-focused MCP. Each tool covers a distinct part of the domain—time-series weather, current conditions, air quality, comparison, and location lookup—without redundancy or bloat.

    Completeness4/5

    The tool surface covers the core Australian weather workflows end to end: location resolution, current observations, forecasts, historical data, air quality, and multi-location comparison. Minor gaps exist—such as historical air quality, weather alerts, or sunrise/sunset data—but these are workable omissions rather than dead ends.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive access to Open-Meteo weather APIs, including forecasts, historical data, air quality, marine weather, and geocoding, enabling LLMs to retrieve weather information and location data.
      17
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to Australian weather data from the Bureau of Meteorology, enabling location search, forecasts, and current observations.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides weather forecasts and geocoding lookup using free Open-Meteo APIs, enabling LLMs to query real-time weather and multi-day forecasts for any location.
      1
      ISC