Nsi Bg

What Nsi Bg MCP server does

Nsi Bg MCP server exposes selected access paths to the Bulgarian National Statistical Institute’s open-data service. It is intended for agents that need to find and read official NSI datasets rather than interact with a general-purpose database.

The server has three pack-specific tools. list_datasets returns available datasets with numeric IDs and English or Bulgarian names. It accepts an optional case-insensitive substring filter, which helps narrow results by terms such as population, export, or inflation. get_dataset retrieves one dataset using its numeric ID. get_fields returns the dataset’s field and dimension metadata as parsed CSV rows, including column codes and Bulgarian and English names.

How it works

A typical request starts with list_datasets. The resulting numeric ID is then supplied to get_dataset, which returns a JSON-stat 2.0 object. That response contains dimensions, category information, and a flat value array. Because the values are represented separately from the dimension metadata, use get_fields and the dimension details to interpret codes and map values to their meanings.

Example dataset IDs documented by the project include 107, for children in kindergartens by municipality, and 242, for aggregate replacement ratio. These examples identify available datasets but do not define the complete catalog.

The gateway endpoint also exposes shared Pipeworx meta-tools alongside the pack-specific tools. Its initialization response is the authoritative source for the tools available at a particular time. The standalone package exposes only the Nsi Bg tools and does not add the gateway’s shared routing tools.

Setup and configuration

For an MCP client, use the streamable HTTP endpoint:

{
  "mcpServers": {
    "nsi-bg": {
      "url": "https://gateway.pipeworx.io/nsi-bg/mcp"
    }
  }
}

The package also supports local stdio execution with no Pipeworx account or gateway round trip:

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

Run npx -y @pipeworx/mcp-nsi-bg directly to start the local server. Clients that do not use MCP can call the gateway’s HTTP tool endpoint, such as POST https://gateway.pipeworx.io/v1/tools/nsi_bg_list_datasets with a JSON body containing an optional filter.

Tools and capabilities

• list_datasets: Finds NSI datasets by name and returns their IDs.
• get_dataset: Retrieves one dataset as JSON-stat 2.0.
• get_fields: Supplies field and dimension definitions for interpreting a dataset.

Nsi Bg MCP server is useful for workflows that need official statistical figures, dataset selection by natural-language topic, or structured inspection of NSI dimensions before processing values.

Limitations and notes

Dataset retrieval requires a numeric ID, so discovery or prior knowledge is needed before calling get_dataset. The returned value array is flat, and its interpretation depends on the accompanying dimensions, categories, and field metadata. The gateway and local modes expose different tool scopes: the gateway includes shared Pipeworx meta-tools, while the local process exposes only this pack’s three tools. The project documents MIT licensing.