ukrainian-stats

The Ukrainian Statistics MCP Server provides AI-friendly access to the State Statistics Service of Ukraine via the SDMX v3 API. It exposes a set of MCP tools that let you discover available data, inspect data structures and metadata, view concept schemes and codelists, and retrieve actual observations efficiently. This server is designed to be bilingual (Ukrainian and English) and supports domain exploration across energy, demographics, trade, and other statistical areas. Use the available tools to list dataflows, fetch detailed dataflow and DSD information, obtain concept schemes and codelists, and finally query real data with flexible filtering.

To use the tools, connect to the server through your MCP client (for example Claude Desktop or your own MCP client) and invoke commands such as list_dataflows, get_dataflow, get_data_structure, get_concept_scheme, list_codelists, get_codelist, get_data, and check_data_availability. Each tool documents its required parameters and optional filters, allowing you to explore datasets, understand their structure, and retrieve time-series data with precise filters. This makes it straightforward to integrate Ukrainian statistical data into applications, dashboards, or AI workflows.

Prerequisites:

• Node.js v18 or higher and npm
• Administrative permissions to install global npm packages

Installation methods (choose one):

1. Install from npm (recommended)

• Run: npm install -g ukrainian-stats-mcp-server
• Add to Claude Desktop configuration (example): { "mcpServers": { "ukrainian-stats": { "command": "ukrainian-stats-mcp" } } }
• Restart Claude Desktop to enable the server.

2. Quick install scripts (local/global)

• Clone the repo and run the install script or use the provided commands in README to install dependencies, build, and link the command globally. After installation, configure Claude Desktop similarly as above.

3. Install from GitHub

• Install globally via npm from GitHub: npm install -g git+https://github.com/VladyslavMykhailyshyn/ukrainian-stats-mcp-server.git
• Configure Claude Desktop with: { "mcpServers": { "ukrainian-stats": { "command": "ukrainian-stats-mcp" } } }

4. Local development installation

• Clone the repository and install locally: git clone https://github.com/VladyslavMykhailyshyn/ukrainian-stats-mcp-server.git cd ukrainian-stats-mcp-server npm install npm run build
• To run locally without global install, configure Claude Desktop to run the built index.js via node: { "mcpServers": { "ukrainian-stats": { "command": "node", "args": ["/absolute/path/to/ukrainian-stats-mcp-server/build/index.js"] } } }

Tips and considerations:

• The server relies on the Ukrainian SDMX API v3; network access to the SDMX endpoints is required.
• If you encounter permission issues during global npm installs on Linux/macOS, you may need to prepend sudo or configure npm to use a user directory.
• For Claude Desktop integration, ensure the path to the command is correct (absolute path when using a local build).
• The tools support filtering and metadata exploration, enabling efficient data discovery before querying time-series data.
• The npm package name is ukrainian-stats-mcp-server; the executable command exposed after installation is ukrainian-stats-mcp.