@pipeworx/macau-stats

Macau (Macao SAR) official statistics — 143 headline indicators (population, visitor arrivals, gaming revenue, CPI, unemployment, births/deaths and more) from DSEC, the Macao Statistics and Census Service (澳門統計暨普查局 / Direcção dos Serviços de Estatística e Censos).

Part of Pipeworx — an MCP gateway connecting AI agents to 1865+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

• macau_indicators({ query? }) — the catalogue of all 143 key indicators (id, name in English/中文/Portuguese, reporting frequency). Pass query to filter by keyword in any of the three languages.
• macau_indicator({ id?, name?, periods? }) — latest value for one indicator by numeric id or name/keyword, plus a historical series when a reliable match exists in DSEC's general statistics database (see the ID-space note below). periods defaults to 24.
• macau_gaming_revenue() — Macau's monthly gross revenue of games of chance (澳門博彩毛收入) in million MOP — the same figure the gaming regulator DICJ publishes as an HTML table, sourced here as structured data instead.
• macau_population() — total resident population, quarterly.
• macau_tourism() — visitor arrivals, monthly.
• macau_employment() — unemployment rate, total employment and median monthly earnings in one call.

Auth

Keyless. No registration, no API key, despite the DSEC /zh-MO/Service/WebService page describing a "contact us" styled-widget product — that copy is about the branded embed, not the raw data call used here.

Data sources

• https://www.dsec.gov.mo/TimeSeriesDatabase.asmx — DSEC's public SOAP web service (WSDL at ?WSDL). Old-school ASP.NET ASMX: every SOAP operation also answers a plain HTTP GET (the framework's HttpGet binding), so this pack calls it with GET + query string and parses the XML response — no SOAP envelope needed.

Traps for the next person

• Two disjoint id spaces. The 143 curated KeyIndicatorIDs (getKeyIndicatorList/getKeyIndicatorValue) are NOT the same numbering as the general IndicatorID catalog (getIndicatorID/getIndicatorByID/ getIndicatorLatestNValues) — getIndicatorByID(15) for KeyIndicatorID 15 returns an empty result. There is no documented mapping table. This pack resolves a mapping by searching the general catalog for a description that matches a key indicator's own name, and only trusts the match when it resolves to exactly one series (an ambiguous or empty search means "no reliable history", not a guess) — confirmed working for "Live births" -> IndicatorID 9014, confirmed absent for "Gross revenue of games of chance" (it exists only in the curated key-indicator set, not the general catalog).
• The curated key-indicator endpoint (getKeyIndicatorValue) returns only the LATEST value — no period parameter, no history. Real time series require the general-catalog mapping above, which does not resolve for every indicator.
• Chart operations (getChart, getCommonChart) return a base64-encoded PNG image (ChartData), not structured numbers — not usable for a data API, so this pack does not call them.
• Language enum values: English, TraditionalChinese, SimplifiedChinese, Portuguese — NOT Chinese (that value 500s with a .NET conversion error).
• This pack supersedes any DICJ (gaming regulator) HTML-table scrape — the same monthly gross-gaming-revenue number is available here as clean XML.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "macau-stats": {
      "url": "https://gateway.pipeworx.io/macau-stats/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/macau-stats/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, `d

... View full README on GitHub