wgea-mcp
This server provides plain-English MCP access to WGEA's Australian workplace gender equality data, letting you search, describe, query, and rank curated datasets on per-employer workforce composition, gender pay gaps, policies, and more.
Search datasets – fuzzy-search the curated catalog by keywords like "parental leave" or "pay gap".
Describe datasets – list filterable dimensions, measures, units, and source URLs before querying.
Query data – filter by employer, ANZSIC division, gender, manager category, policy responses, etc., with period ranges and records/series/csv output.
Get latest year – restrict queries to the most recent WGEA reporting year, with row caps via
limit(or legacymax_rows).Top N rankings – return the largest or smallest rows by a numeric measure (e.g.
n_employees,n_responses) for the latest or a specified year.List curated datasets – enumerate all available dataset IDs.
Fuzzy employer lookup – resolve abbreviations like "CBA", "NAB", "Woolies" to legal names, with
did_you_meansuggestions when no exact match exists.Attribution and reliability – every response includes source attribution, download URLs, staleness flags, and server version; live CKAN URL resolution with a bundled fallback seed manifest.
wgea-mcp
mcp-name: io.ausdata/wgea-mcp
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-mcpClaude Desktop
{
"mcpServers": {
"wgea": { "command": "uvx", "args": ["--upgrade", "wgea-mcp"] }
}
}Claude Code
claude mcp add wgea --command uvx --args -- --upgrade wgea-mcpRelated MCP server: aemo-mcp
What it exposes
Six tools, all plain-English in, structured out:
Tool | Purpose |
| Fuzzy-search the curated catalog by keyword |
| List a dataset's filterable dimensions and returnable measures |
| Query with |
| Restrict to the latest reporting year. Row cap parameter is |
| Rank rows by a numeric measure (e.g. |
| 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 |
| Industry gender pay gap mid-points by ANZSIC division + national rollup | EGPG xlsx on |
| Per-employer headcount by occupation × manager category × gender |
|
| Manager movements (promotions, hires, resignations) by gender |
|
| Pay-gap analyses, gender targets, governance — Q&A responses |
|
| Parental leave + flexible-work policy responses |
|
| Sexual harassment + domestic-violence policy responses |
|
| Carer leave, EAP, mental-health programs |
|
| Board composition, governing-body diversity, CEO + KMP demographics |
|
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:
Live CKAN —
package_show?id=wgea-datasetreturns every resource; the newest "WGEA Data — Public Data File" wins. Cached 6h.Bundled seed manifest — when CKAN is unreachable, fall back to
data/seed_urls.jsonshipped in the wheel. The response is flaggedstale: truewith 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.
Fuzzy employer-name search
Pass any abbreviation, alias, or substring and rapidfuzz resolves it:
You type | Resolved to |
| Commonwealth Bank of Australia |
| Commonwealth Bank of Australia |
| National Australia Bank Limited |
| Westpac Banking Corporation |
| Woolworths Group Limited |
| Atlassian Pty Ltd |
| 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 toolsdescribe_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
data.gov.au MCP — Australia open-data CKAN catalogue.
Public MCP server for discovering open jobs. Search, filter, and get application links.
Japanese law, corporation & statistics data as MCP, normalized to English with source attribution.
Data Commons MCP — harmonised public statistics for places, from Google Data Commons (REST v2).
Related MCP Servers
- AlicenseAqualityFmaintenanceOne-call Australian health and welfare data plumbing via AIHW — cited responses for practical analysis, not a data broker.671 PyPIMIT
- AlicenseAqualityFmaintenanceOne-call Australian energy-market plumbing via AEMO — cited, structured responses for market data and analysis, not a data broker.5196 PyPIMIT
- AlicenseAqualityAmaintenanceIndependent MCP server for retrieval of Australian economic and financial data - supports ABS, RBA and APRA14742 PyPI5MIT
- AlicenseAqualityBmaintenanceMCP server over the U.S. Department of Labor Wage and Hour Division (WHD) enforcement dataset: employer wage-theft history, back wages owed, civil penalties, and affected-employee counts. Built for worker-justice nonprofits, legal-aid intake, and union researchers.47 npmMIT