Skip to main content
Glama

wgea-mcp

mcp-name: io.ausdata/wgea-mcp

PyPI Python License Tests CodeQL Glama MCP server quality

MCP server for the Workplace Gender Equality Agency (WGEA) public data file. Plain-English access to per-employer workforce composition, gender-equality policy answers, parental leave, flexible work, and harm-prevention data — every WGEA-reporting employer in Australia (~9,600 employers), every year, from a single uvx command.

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).

"What's the gender breakdown at Commonwealth Bank?"
"Which mining companies set gender targets in 2024-25?"
"Workforce composition by occupation at Qantas"
"Sexual harassment policy responses across financial services"
"Promotions to manager by gender at Atlassian"

Sister to abs-mcp, rba-mcp, ato-mcp, apra-mcp, aihw-mcp, asic-mcp, and au-weather-mcp.


Install

uvx --upgrade wgea-mcp

Claude Desktop

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

Claude Code

claude mcp add wgea --command uvx --args -- --upgrade wgea-mcp

Related MCP server: aemo-mcp

What it exposes

Six tools, all plain-English in, structured out:

Tool

Purpose

search_datasets

Fuzzy-search the curated catalog by keyword

describe_dataset

List a dataset's filterable dimensions and returnable measures

get_data

Query with filters, period range, output format

latest

Restrict to the latest reporting year. Row cap parameter is limit (portfolio-standard); max_rows retained as legacy alias.

top_n

Rank rows by a numeric measure (e.g. n_employees) and return the top (or bottom) N for one reporting year.

list_curated

Enumerate the curated dataset IDs

Every response is the same shape — dataset_id, dataset_name, query, reporting_year, unit, row_count, records, source_url, download_url, did_you_mean, attribution, stale flag, server_version.


Curated datasets (8)

ID

What it is

Source

HEADLINE_GAP

Industry gender pay gap mid-points by ANZSIC division + national rollup

EGPG xlsx on wgea.gov.au (aggregated server-side)

WORKFORCE_COMPOSITION

Per-employer headcount by occupation × manager category × gender

wgea_workforce_composition_<year>.csv

WORKFORCE_MANAGEMENT

Manager movements (promotions, hires, resignations) by gender

wgea_workforce_management_statistics_<year>.csv

GENDER_EQUALITY_ACTIONS

Pay-gap analyses, gender targets, governance — Q&A responses

wgea_questionnaire_action_on_gender_equality_<year>.csv

PARENTAL_LEAVE_FLEX

Parental leave + flexible-work policy responses

wgea_questionnaire_flexible_work_<year>.csv

HARM_PREVENTION

Sexual harassment + domestic-violence policy responses

wgea_questionnaire_harm_prevention_<year>.csv

EMPLOYEE_SUPPORT

Carer leave, EAP, mental-health programs

wgea_questionnaire_employee_support_<year>.csv

WORKPLACE_OVERVIEW

Board composition, governing-body diversity, CEO + KMP demographics

wgea_questionnaire_workplace_overview_<year>.csv

The headline gender pay-gap %. HEADLINE_GAP (added in 0.6.0) carries the industry mid-points WGEA publishes annually in its Employer Gender Pay Gaps Report — e.g. Mining 18.9%, Financial and Insurance Services 21.4%, "All employers" national mid-point 11.2% (2024-25 reporting year). Numbers match WGEA's published Figure 4 to within rounding. For the workforce-weighted national aggregate (~21.1% private sector) WGEA states in its public materials, see the WGEA Data Explorer — that figure requires payroll data WGEA holds before public release and is not derivable from the published employer-level xlsx.


Reliability — 2-tier URL resolution

WGEA publishes the public data file annually under a single CKAN package on data.gov.au. Each annual release gets a fresh resource UUID:

  1. Live CKAN — package_show?id=wgea-dataset returns every resource; the newest "WGEA Data — Public Data File" wins. Cached 6h.

  2. Bundled seed manifest — when CKAN is unreachable, fall back to data/seed_urls.json shipped in the wheel. The response is flagged stale: true with an honest reason.

Net effect: a fresh uvx wgea-mcp always gets the current reporting year; a 12-month-old install still works because the seed manifest is refreshed and --upgrade pulls a new wheel.


Pass any abbreviation, alias, or substring and rapidfuzz resolves it:

You type

Resolved to

"CBA"

Commonwealth Bank of Australia

"Commonwealth Bank"

Commonwealth Bank of Australia

"NAB"

National Australia Bank Limited

"Westpac"

Westpac Banking Corporation

"Woolies" / "woolworths"

Woolworths Group Limited

"Atlassian"

Atlassian Pty Ltd

"qantas"

Qantas Airways Limited

When nothing exact matches, did_you_mean carries the top-5 closest legal names so the agent can ask the user to pick.


Attribution

Data sourced from the Workplace Gender Equality Agency. Licensed under Creative Commons Attribution 3.0 Australia (CC BY 3.0 AU). wgea-mcp is MIT-licensed; WGEA's data carries the upstream CC-BY 3.0 AU licence, echoed in every response's attribution field.

Per-employer reporting is a deliberate disclosure under the Workplace Gender Equality Act 2012 — redistribution is explicitly intended.


Sister MCPs (Australian Public Data portfolio)

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 — Open-Meteo (Bureau of Meteorology aggregator)

  • wgea-mcp — this one. Workplace gender equality.

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


Development

git clone https://github.com/Bigred97/wgea-mcp.git
cd wgea-mcp
uv venv
uv pip install -e ".[dev]"
pytest                  # unit tests
pytest -m live          # integration tests against data.gov.au (downloads the ~71 MB ZIP)

Issues and contributions welcome: github.com/Bigred97/wgea-mcp/issues.

Available Tools

6 tools
describe_datasetA

Describe a dataset's filterable dimensions, returnable measures, units, and source.

Use this before calling get_data on a new dataset — it tells you the valid filter keys ('employer_name', 'anzsic_division', 'gender', ...), enumerated filter values where they exist (e.g. 'women' → 'Women'), measure aliases ('n_employees'), and the canonical source URL.

Returns: DatasetDetail with id, name, description, period_coverage, list of dimensions, list of measures, source_url, and the resolved reporting year label.

Inputs: dataset_id (required). Returns: describe_dataset shape.

get_dataA

Query a curated WGEA dataset and return observations.

Examples: # Gender breakdown at Commonwealth Bank resp = await get_data( "WORKFORCE_COMPOSITION", filters={"employer_name": "Commonwealth Bank"}, )

# Promotions to manager by gender at Westpac in 2024-25
resp = await get_data(
    "WORKFORCE_MANAGEMENT",
    filters={"employer_name": "Westpac", "movement_type": "Promotions",
             "manager_category": "Managers"},
)

# Which employers in mining set gender targets?
resp = await get_data(
    "GENDER_EQUALITY_ACTIONS",
    filters={"anzsic_division": "Mining",
             "section": "Gender Pay Gap",
             "response": "Yes"},
)

# Sexual harassment policy responses across financial services
resp = await get_data(
    "HARM_PREVENTION",
    filters={"anzsic_division": "Financial and Insurance Services",
             "subsection": "Sexual Harassment"},
)

Returns: DataResponse with records (or csv), unit, reporting_year, row_count, source URL, the actual download_url used, "did you mean?" fuzzy hints if the employer-name filter didn't match exactly, and CC-BY 3.0 AU attribution.

Inputs: dataset_id (required), format, filters, max_rows, +2 more. Returns: get_data / latest shape — uniform across curated datasets. `records` carries ei…

latestA

Return rows from the most recent WGEA reporting year for a dataset.

Trims to the single latest reporting_year — useful for "what's the current gender breakdown at CBA?" without having to remember WGEA's annual cadence.

Examples: # Latest workforce composition at CBA resp = await latest("WORKFORCE_COMPOSITION", filters={"employer_name": "Commonwealth Bank"})

# Cap rows (portfolio-standard name)
resp = await latest("WORKFORCE_COMPOSITION",
                    filters={"anzsic_division": "Mining"}, limit=100)

# Legacy alias still works
resp = await latest("WORKFORCE_COMPOSITION",
                    filters={"anzsic_division": "Mining"}, max_rows=100)

Parameter notes: - Prefer limit (portfolio-standard; matches asic-mcp's latest(..., limit) parameter). - max_rows retained as legacy alias. - Supplying both raises ValueError — pick one. - get_data() keeps max_rows unchanged (separate surface, separate concern).

Inputs: dataset_id (required), limit, filters, max_rows. Returns: get_data / latest shape — uniform across curated datasets. `records` carries ei…

list_curatedA

List every curated dataset ID in this version of wgea-mcp.

Returns: Sorted list of dataset IDs.

Inputs: no named parameters. Returns: result

search_datasetsA

Fuzzy-search the curated WGEA dataset catalog.

All seven curated datasets cover the WGEA Public Data File: per-employer workforce composition, manager movements, gender-equality policy answers, parental-leave + flexible-work policies, harm-prevention policies, employee support, and workplace overview.

Examples: # Find datasets about parental leave results = await search_datasets("parental leave") # → [{id: 'PARENTAL_LEAVE_FLEX', ...}]

# Find workforce composition by gender
results = await search_datasets("women in management")

Returns: List of DatasetSummary (id, name, description, update_frequency, is_curated), ranked by relevance.

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

top_nA

Return the N rows with the largest (or smallest) value of a measure.

Ranks across one WGEA reporting year (the latest by default, or a specific year via reporting_year=). This is the most common agent workflow — "show me the top 10 X by Y" — collapsed into a single server-side call: rank-and-slice happens on the server so the agent never has to fetch a full table just to take the top of it.

Examples: # 10 employers with the most women managers (latest reporting year) top_n("WORKFORCE_COMPOSITION", "n_employees", n=10, filters={"gender": "Women", "manager_category": "Manager"})

# 5 ANZSIC divisions with the fewest Yes responses on Gender Pay Gap
top_n("GENDER_EQUALITY_ACTIONS", "n_responses", n=5, direction="bottom",
      filters={"section": "Gender Pay Gap", "response": "Yes"})

# Top 5 employers in Mining by total workforce in 2023-24
top_n("WORKFORCE_COMPOSITION", "n_employees", n=5,
      filters={"anzsic_division": "Mining"},
      reporting_year="2023-24")

Returns: DataResponse with at most n records, sorted by measure value in the requested direction. Other fields (reporting_year, unit, attribution) match a regular get_data call.

Inputs: measure (required), dataset_id (required), n, filters, +2 more. Returns: get_data / latest shape — uniform across curated datasets. `records` carries ei…

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: describe_dataset for metadata, get_data for raw queries, latest for latest year convenience, list_curated for dataset inventory, search_datasets for discovery, and top_n for ranked results. No functional overlap.

    Naming Consistency4/5

    Most tools follow verb_noun snake_case (describe_dataset, get_data, list_curated, search_datasets). 'latest' and 'top_n' deviate slightly but are predictable and in line with common conventions for convenience tools.

    Tool Count5/5

    Six tools is well-scoped for a specialized dataset query server. Each tool addresses a distinct workflow step: discovery, metadata inspection, data retrieval, latest-year convenience, and top-N ranking.

    Completeness5/5

    The tool set covers the full exploration-to-query lifecycle: list available datasets, search, describe, query with filters, get latest year, and get top/bottom rows. No obvious gaps for a read-only public data API.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers