Gastat MCP server

@pipeworx/gastat

Saudi Arabia's official statistics — GASTAT (General Authority for Statistics) population, employment/unemployment, GDP, consumer prices and trade indicators, each carrying both Arabic and English titles under one indicator id.

Part of Pipeworx — an MCP gateway connecting AI agents to 1576+ live data sources.

Tools

(population, GDP, unemployment rate, growth rate, per-capita income).

• gastat_headline() — quick snapshot of GASTAT's own homepage indicators

Arabic across ~2,600 indicators; returns indicator ids + bilingual titles.

• gastat_search(term, limit?) — find indicators by keyword in English or

id (from gastatsearch / gastatheadline) — multiple periods for comparison over time, not just a latest-value lookup.

• gastatseries(indicatorid, recent?) — full time series for an indicator

Auth

Keyless. Every endpoint here is served to anonymous visitors with no login, token, or registration — verified live.

Data sources

— headline indicators (population, GDP, unemployment, etc.).

• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/cardsinfo

— the full indicator catalog (~2,600 REP nodes), ~4.5MB, no server-side filtering. This is the same endpoint GASTAT's own Angular app (database.stats.gov.sa) fetches and searches client-side; there is no documented developer portal, so this was found by reading the app's own JS bundle rather than any published API docs. gastatsearch and gastatseries both fetch it fresh per call (no cross-request cache available without a binding) — expect a few seconds of latency, that's GASTAT's shape, not ours.

• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/public

— the actual observation data for one indicator, where is the opaque api_url field carried on that indicator's catalog entry (stable across repeated fetches in testing — not session-bound).

• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/getDataForChart?api=

Trap: most catalog entries carry a bare title + apiurl token that resolves cleanly with no extra parameters. A meaningful minority — anything broken out by region, nationality, sector, or commodity in its title — needs dimension filters this endpoint doesn't expose through a plain GET, and comes back either an HTTP 400 or a row of all-null values. gastatseries detects both cases and returns a clear error/message rather than surfacing the raw failure, and gastat_search ranks indicators without a breakdown hint in their title first, since those are the ones that resolve.

Bilingual trap: GASTAT indexes everything by Arabic AND English title under one indicator id — never two ids for the same series. Every tool here preserves both titleen and titlear on the same record rather than treating the Arabic filing as a separate entity.

Query-string parameters on indicators/public (e.g. ?term=) are rejected by GASTAT's own WAF — confirmed live. There is no server-side search; the whole catalog must be fetched and filtered client-side, which is what gastat_search does.

Quick Start

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

{
  "mcpServers": {
    "gastat": {
      "url": "https://gateway.pipeworx.io/gastat/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/gastat/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — askpipeworx, discovertools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

Shortened. The full README is on GitHub.