Register UZ MCP Server

Model Context Protocol (MCP) server for Slovak Registry of Financial Statements (Register účtovných závierok) from Slovak Ministry of Finance based on the API documentation.

Author: @alhafoudh

Features

Complete API Coverage: All endpoints from the RegisterUZ Open API
Pydantic Models: Fully typed response models for all API entities
25 MCP Tools: Search, list, retrieve, and analyze financial data with labeled tables
8 MCP Resources: Static classifier data and dynamic entity lookups
20 MCP Prompts: Pre-built workflows for common integration scenarios
CLI Client: Command-line tool for testing and exploration

Data Available

Accounting Units (Účtovné jednotky): Company/organization details including IČO, DIČ, address, legal form
Accounting Closures (Účtovné závierky): Financial statement metadata and periods
Financial Reports (Účtovné výkazy): Balance sheets, income statements with full data tables
Annual Reports (Výročné správy): Annual report metadata and attachments
Templates (Šablóny): Report structure definitions
Classifiers: Legal forms, SK NACE codes, regions, districts, settlements

Quick Start (Hosted Version)

Add the hosted MCP server to your Claude integration:

Claude Code Integration (Hosted)

claude mcp add registeruz --transport http https://registeruz.fastmcp.app/mcp

Claude Desktop Integration (Hosted)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "registeruz": {
      "type": "streamable-http",
      "url": "https://registeruz.fastmcp.app/mcp"
    }
  }
}

Make.com Integration (Hosted)

You can use the Autoform MCP server in Make.com (formerly Integromat) using the MCP Client - Call a tool app:

Add the MCP Client - Call a tool module to your scenario
Create a new MCP server connection with these settings:
- URL: https://registeruz.fastmcp.app/mcp
- API key / Access token: Leave empty (no authentication required)
Select the tool you want to call and configure your query parameters

Self-Hosted Installation

From PyPI (recommended)

pip install registeruz-mcp

Or using uvx to run directly without installation:

uvx registeruz-mcp

From source

# Clone the repository
git clone https://github.com/alhafoudh/registeruz-mcp.git
cd registeruz-mcp

# Install dependencies
uv sync

Usage

Run the MCP server (STDIO transport)

# If installed from PyPI
registeruz-mcp

# Or using uvx
uvx registeruz-mcp

# Or from source
uv run python registeruz_mcp.py

Run with FastMCP CLI

uv run fastmcp run registeruz_mcp.py

Inspect available tools

uv run fastmcp inspect registeruz_mcp.py

Development mode with MCP Inspector

uv run fastmcp dev registeruz_mcp.py

Available Tools

List Tools (Get IDs)

Tool	Description
`get_uctovne_jednotky`	Get accounting unit IDs changed since a date (supports filtering by IČO, DIČ, legal form)
`get_uctovne_zavierky`	Get accounting closure IDs changed since a date
`get_uctovne_vykazy`	Get financial report IDs changed since a date
`get_vyrocne_spravy`	Get annual report IDs changed since a date

Count Tools (Pagination)

Tool	Description
`get_zostavajuce_id_uctovne_jednotky`	Count remaining accounting unit IDs
`get_zostavajuce_id_uctovne_zavierky`	Count remaining accounting closure IDs
`get_zostavajuce_id_uctovne_vykazy`	Count remaining financial report IDs
`get_zostavajuce_id_vyrocne_spravy`	Count remaining annual report IDs

Detail Tools

Tool	Description
`get_uctovna_jednotka`	Get accounting unit details by ID
`get_uctovna_zavierka`	Get accounting closure details by ID
`get_uctovny_vykaz`	Get financial report with tables and data
`get_vyrocna_sprava`	Get annual report details by ID

Template Tools

Tool	Description
`get_sablona`	Get template structure by ID
`get_sablony`	Get all available templates

Classifier Tools

Tool	Description
`get_pravne_formy`	Get all legal forms
`get_sk_nace`	Get SK NACE classification codes
`get_druhy_vlastnictva`	Get ownership types
`get_velkosti_organizacie`	Get organization sizes
`get_kraje`	Get Slovak regions
`get_okresy`	Get Slovak districts
`get_sidla`	Get Slovak settlements

Download Tools

Tool	Description
`get_attachment_url`	Get download URL for attachment
`get_financial_report_pdf_url`	Get PDF download URL for financial report

Labeled Data Tools

Tool	Description
`get_uctovny_vykaz_with_labeled_tables`	Get financial report with labeled tables (combines report with template labels in one call)
`get_uctovny_vykaz_table_value_by_labels`	Search for specific values by row label, row code, column label, or table name

Available Resources

Static Resources (Classifiers)

URI	Description
`ruz://classifiers/pravne-formy`	Legal forms
`ruz://classifiers/sk-nace`	SK NACE codes
`ruz://classifiers/druhy-vlastnictva`	Ownership types
`ruz://classifiers/velkosti-organizacie`	Organization sizes
`ruz://classifiers/kraje`	Regions
`ruz://classifiers/okresy`	Districts
`ruz://classifiers/sidla`	Settlements
`ruz://templates`	All templates

Dynamic Resource Templates

URI Pattern	Description
`ruz://uctovna-jednotka/{id}`	Accounting unit by ID
`ruz://uctovna-zavierka/{id}`	Accounting closure by ID
`ruz://uctovny-vykaz/{id}`	Financial report by ID
`ruz://vyrocna-sprava/{id}`	Annual report by ID
`ruz://sablona/{id}`	Template by ID

Available Prompts

Company Search Prompts

Prompt	Description
`search_company_by_ico`	Search for company by IČO and get financial statements
`search_company_by_dic`	Search for company by tax ID (DIČ)
`search_companies_by_legal_form`	Search for companies by legal form (e.g., s.r.o., a.s.)

Financial Analysis Prompts

Prompt	Description
`get_latest_financials`	Get latest financial statements for a company
`compare_financials_year_over_year`	Compare company financials across multiple years
`extract_financial_metrics`	Extract specific financial metrics (profit, assets, liabilities)
`get_balance_sheet`	Get balance sheet (Súvaha) data for a company
`get_income_statement`	Get income statement (Výkaz ziskov a strát) for a company

Change Tracking & Monitoring Prompts

Prompt	Description
`analyze_changes`	Analyze changes in accounting units over a period
`monitor_new_filings`	Monitor new financial statements filed since a date
`track_company_changes`	Track a specific company for recent changes

Document & Download Prompts

Prompt	Description
`get_company_documents`	Get all downloadable documents for a company
`get_annual_reports`	Download annual reports (Výročné správy) for a company

Template & Structure Prompts

Prompt	Description
`explore_template`	Explore financial report template structure
`list_all_templates`	List all available report templates with their purposes

Classifier & Reference Data Prompts

Prompt	Description
`get_location_hierarchy`	Get all Slovak regions and districts hierarchy
`get_legal_forms_explained`	Get all legal forms with explanations
`explore_sk_nace`	Explore SK NACE industry classification codes

Bulk/Export Prompts

Prompt	Description
`bulk_export_companies`	Export basic data for multiple companies
`generate_financial_summary`	Generate comprehensive company financial summary report

Claude Code Integration (Self-Hosted)

Using uvx (recommended)

Run the server directly from PyPI without installation:

claude mcp add registeruz -- uvx registeruz-mcp

Using local installation

If you've cloned the repository:

claude mcp add registeruz -- uv run --directory /path/to/registeruz-mcp python registeruz_mcp.py

Claude Desktop Integration (Self-Hosted)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

Using uvx (recommended)

{
  "mcpServers": {
    "registeruz": {
      "command": "uvx",
      "args": ["registeruz-mcp"]
    }
  }
}

Using local installation

{
  "mcpServers": {
    "registeruz": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/registeruz-mcp", "python", "registeruz_mcp.py"]
    }
  }
}

Development

Install dev dependencies

uv sync --all-extras

Run tests

uv run pytest -v

License

MIT

Register UZ MCP Server

Register UZ MCP Server

Features

Data Available

Quick Start (Hosted Version)

Claude Code Integration (Hosted)

Claude Desktop Integration (Hosted)

Make.com Integration (Hosted)

Self-Hosted Installation

From PyPI (recommended)

From source

Usage

Run the MCP server (STDIO transport)

Run with FastMCP CLI

Inspect available tools

Development mode with MCP Inspector

Available Tools

List Tools (Get IDs)

Count Tools (Pagination)

Detail Tools

Template Tools

Classifier Tools

Download Tools

Labeled Data Tools

Available Resources

Static Resources (Classifiers)

Dynamic Resource Templates

Available Prompts

Company Search Prompts

Financial Analysis Prompts

Change Tracking & Monitoring Prompts

Document & Download Prompts

Template & Structure Prompts

Classifier & Reference Data Prompts

Bulk/Export Prompts

Claude Code Integration (Self-Hosted)

Using uvx (recommended)

Using local installation

Claude Desktop Integration (Self-Hosted)

Using uvx (recommended)

Using local installation

Development

Install dev dependencies

Run tests

License

Reviews