Hagstova Fo

What the Hagstova Fo MCP server does

The Hagstova Fo MCP server gives MCP-compatible agents access to the Statistics Faroe Islands (Hagstova Føroya) PxWeb database. It supports a metadata-first workflow: find a subject or table, inspect the table's dimensions and allowed values, then request only the observations needed for the task.

The service is intended for questions that depend on structured statistical tables, such as selecting specific dimensions and retrieving machine-readable observations. It does not provide a general-purpose search interface to arbitrary websites; its listed tools operate on the Hagstova Føroya PxWeb subject tree and tables.

How it works

Start with subjects. Calling it with an empty path returns the database list. Further paths expose folders and tables. Under the H2 branch, folders have type l, while tables have type t and identifiers ending in .px. The path returned while browsing becomes the input for the other tools.

Use table_meta with a complete table path, such as H2/UO/UO01/land_oyfj.px. The response describes the table's dimensions and supplies the coded values accepted by each dimension. Those codes are needed to construct a valid query.

Finally, call query_table with a PxWeb request body. Each query item identifies a dimension by code and provides a selection containing a filter and selected values. The response format must be json-stat2. PxWeb enforces a cell limit, so select a narrow set of values for every dimension instead of requesting an entire large table.

Setup and configuration

The hosted connection uses this MCP URL:

https://gateway.pipeworx.io/hagstova-fo/mcp

The pack endpoint also exposes shared Pipeworx meta-tools in addition to the three Hagstova tools. Its initialize response is the authoritative source for the tools available at connection time. The full gateway is available at https://gateway.pipeworx.io/mcp when an agent needs direct access to all catalog packs.

For a local connection, install and run the package with npx:

{
  "mcpServers": {
    "hagstova-fo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hagstova-fo"]
    }
  }
}

The local process communicates over stdin and stdout and provides only this pack's tools.

Tools and capabilities

• subjects: Browse the Hagstova Føroya PxWeb hierarchy and locate folders or .px tables.
• table_meta: Read dimension definitions and valid coded values for a specific table.
• query_table: Submit filtered PxWeb selections and receive observations in json-stat2 format.

The Hagstova Fo MCP server can also be used through the hosted gateway's ask_pipeworx tool. That route accepts a plain-English question and can choose a catalog tool and populate its arguments, but it belongs to the shared gateway layer rather than the standalone local package.

Limitations and notes

Queries must use valid dimension codes and values obtained from the selected table's metadata. Requests that exceed PxWeb's cell limit are rejected, so narrowing selections is part of the normal workflow. The hosted pack endpoint includes shared gateway tools, whereas the standalone stdio server exposes only the three pack-specific tools. Both connection styles use the same Hagstova source and tool set for this pack.