ShepDogSk/slovak-statistics-mcp

Slovak Statistics MCP Server

MCP server for accessing the Statistical Office of the Slovak Republic (ŠÚ SR) API.

| English Version

Description

This MCP server provides access to official statistical data from the Slovak Republic through the Statistical Office of Slovakia API. The server offers tools for retrieving statistical collections, dimensions, and datasets in various formats.

Features

• Collection Listing: Browse available statistical collections
• Dimension Access: Retrieve dimension elements for specific statistical cubes
• Dataset Download: Access statistical data in various formats (JSON-stat, CSV, XML, XLSX, ODS)
• URL Generation: Create direct links to datasets

Installation

npm install slovak-statistics-mcp

Usage

MCP Client Configuration

Manual Configuration

Add to your MCP configuration:

{
  "mcpServers": {
    "slovak-statistics": {
      "command": "npx",
      "args": ["slovak-statistics-mcp"]
    }
  }
}

JSON Import

You can import the server directly using a JSON file:

{
  "import": {
    "type": "github",
    "url": "https://github.com/ShepDogSk/slovak-statistics-mcp",
    "config_file": "mcp-server.json"
  }
}

Or use direct npm import:

{
  "import": {
    "type": "npm",
    "package": "slovak-statistics-mcp",
    "version": "^1.0.0"
  }
}

Configuration file examples can be found in: examples/json-configs/

Available Tools

1. get_collections

Retrieves the list of available statistical collections.

Parameters:

• language (optional): "sk" or "en" (default: "sk")

2. get_dimension

Retrieves dimension elements for a specific statistical cube.

Parameters:

• cube_code (required): Cube code
• dimension_code (required): Dimension code
• language (optional): "sk" or "en" (default: "sk")

3. get_dataset

Retrieves statistical data for a specific cube with parameters.

Parameters:

• cube_code (required): Cube code
• parameters (required): Array of parameters for data filtering
• language (optional): "sk" or "en" (default: "sk")
• format (optional): "jsonstat", "csv", "xml", "xlsx", "ods" (default: "jsonstat")

4. build_dataset_url

Creates a URL for direct dataset access.

Parameters:

• cube_code (required): Cube code
• parameters (required): Array of parameters for data filtering
• language (optional): "sk" or "en" (default: "sk")
• format (optional): "jsonstat", "csv", "xml", "xlsx", "ods" (default: "jsonstat")

Usage Examples

Getting Collections List

// Get all available collections in Slovak
await callTool("get_collections", { language: "sk" });

Getting Dimension

// Get dimension elements for a specific cube
await callTool("get_dimension", {
  cube_code: "np3106rr",
  dimension_code: "NUTS",
  language: "sk"
});

Downloading Dataset

// Get statistical data in JSON-stat format
await callTool("get_dataset", {
  cube_code: "np3106rr",
  parameters: ["SK021", "2016,2017,2018", "E_PRIEM_HR_MZDA", "7"],
  language: "sk",
  format: "jsonstat"
});

Creating URL

// Create URL for CSV export
await callTool("build_dataset_url", {
  cube_code: "np3106rr",
  parameters: ["SK021", "2016,2017,2018", "E_PRIEM_HR_MZDA", "7"],
  format: "csv"
});

API Limitations

• Maximum URL length: 2000 characters
• Maximum data transfer: 10,000 items per request
• Data updates: Daily at 10:00 and 22:00

License and Terms of Use

Data is provided under Creative Commons Attribution (CC-BY) 4.0 license. When using the data, you must:

• Cite "Štatistický úrad Slovenskej republiky" (Statistical Office of the Slovak Republic) as the source
• Not imply that the Statistical Office endorses your use
• Provide a direct link to www.statistics.sk when redistributing

Warning: The use of robots, spiders, and similar data collection tools is expressly prohibited.

Technical Details

• Node.js: >=18.0.0
• Module Type: ESM
• Dependencies: @modelcontextprotocol/sdk, node-fetch

Support

For bug reports or feature requests, please use GitHub Issues.

Contributing

Contributions are welcome! Please see our contributing guidelines.

License

MIT License - see the LICENSE file for details.