Skip to main content
Glama
Register UZ MCP Server

Register UZ MCP Server

by freevisionsk

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

Related MCP server: edinet-mcp

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:

  1. Add the MCP Client - Call a tool module to your scenario

  2. Create a new MCP server connection with these settings:

    • URL: https://registeruz.fastmcp.app/mcp

    • API key / Access token: Leave empty (no authentication required)

  3. Select the tool you want to call and configure your query parameters


Self-Hosted Installation

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)

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):

{
  "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

Available Tools

25 tools
get_attachment_urlB

Get the download URL for a financial report attachment. Returns the full URL to download the attachment file.

Inputs: id (required). Returns: result

get_druhy_vlastnictvaB

Get list of ownership types (druhy vlastníctva) with their codes.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_financial_report_pdf_urlB

Get the URL for PDF version of a financial report. Returns the full URL to download the PDF.

Inputs: id (required). Returns: result

get_krajeA

Get list of Slovak regions (kraje) with their codes.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_okresyA

Get list of Slovak districts (okresy) with their codes. Each district includes reference to parent region via nadradenaLokacia.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_pravne_formyB

Get list of all legal forms (právne formy) with their codes and names.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_sablonaB

Get detailed information about a financial report template. Templates define the structure of financial reports including table headers and rows. Use this to interpret the data in financial reports.

Inputs: id (required). Returns: Financial report template.

get_sablonyA

Get list of all available financial report templates. Returns basic information about each template (id, name, regulation, validity period).

Inputs: no named parameters. Returns: Response for templates list endpoint.

get_sidlaB

Get list of Slovak settlements (sídla) with their codes. Each settlement includes reference to parent district via nadradenaLokacia.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_sk_naceB

Get SK NACE classification codes (economic activity classification). SK NACE is the Slovak statistical classification of economic activities.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_uctovna_jednotkaB

Get detailed information about an accounting unit (company/organization). Returns company details including name, IČO, DIČ, address, legal form, and references to related financial documents.

Inputs: id (required). Returns: Accounting unit (company/organization) detail.

get_uctovna_zavierkaB

Get detailed information about an accounting closure (financial statement). Returns closure details including periods, dates, type, and references to financial reports.

Inputs: id (required). Returns: Accounting closure (financial statement) detail.

get_uctovne_jednotkyA

Get list of accounting unit IDs changed since a given date. Use this to discover entities that have been modified. Returns up to max_zaznamov IDs (default 1000, max 10000). Use pokracovat_za_id for pagination when existujeDalsieId is true.

Inputs: zmenene_od (required), pokracovat_za_id, max_zaznamov, ico, +2 more. Returns: Response for list endpoints returning IDs.

get_uctovne_vykazyA

Get list of financial report IDs changed since a given date. Returns up to max_zaznamov IDs (default 1000, max 10000). Use pokracovat_za_id for pagination when existujeDalsieId is true.

Inputs: zmenene_od (required), pokracovat_za_id, max_zaznamov. Returns: Response for list endpoints returning IDs.

get_uctovne_zavierkyA

Get list of accounting closure IDs changed since a given date. Returns up to max_zaznamov IDs (default 1000, max 10000). Use pokracovat_za_id for pagination when existujeDalsieId is true.

Inputs: zmenene_od (required), pokracovat_za_id, max_zaznamov. Returns: Response for list endpoints returning IDs.

get_uctovny_vykazA

Get detailed information about a financial report. Returns report content including title page data, tables with financial data, and attachment information. Use idSablony to get the template for interpreting tables.

Inputs: id (required). Returns: Financial report detail.

get_uctovny_vykaz_table_value_by_labelsB

Search for specific values in a financial report by matching row and/or column labels. Returns only the values that match the specified criteria. Useful for extracting specific metrics like 'Výsledok hospodárenia' (profit/loss), 'SPOLU MAJETOK' (total assets), etc.

Inputs: id (required), row_label, row_code, column_label, +1 more. Returns: Result of searching for table values by labels.

get_uctovny_vykaz_with_labeled_tablesA

Get financial report with labeled tables. Fetches both the report and its template, then combines them to provide labeled data where each value has row and column labels. This makes it easy to understand what each value represents without manually cross-referencing the template.

Inputs: id (required). Returns: Financial report with labeled tables.

get_velkosti_organizacieB

Get list of organization sizes (veľkosti organizácie) with their codes.

Inputs: no named parameters. Returns: Response for classifier endpoints. Note: The API returns 'klasifikacie' for mos…

get_vyrocna_spravaC

Get detailed information about an annual report. Returns report details including type, periods, attachments, and references.

Inputs: id (required). Returns: Annual report detail.

get_vyrocne_spravyA

Get list of annual report IDs changed since a given date. Returns up to max_zaznamov IDs (default 1000, max 10000). Use pokracovat_za_id for pagination when existujeDalsieId is true.

Inputs: zmenene_od (required), pokracovat_za_id, max_zaznamov. Returns: Response for list endpoints returning IDs.

get_zostavajuce_id_uctovne_jednotkyB

Get count of remaining accounting unit IDs after a given ID. Useful for estimating pagination progress.

Inputs: zmenene_od (required), pokracovat_za_id, ico, dic, +1 more. Returns: Response for remaining IDs count endpoints.

get_zostavajuce_id_uctovne_vykazyA

Get count of remaining financial report IDs after a given ID. Useful for estimating pagination progress.

Inputs: zmenene_od (required), pokracovat_za_id. Returns: Response for remaining IDs count endpoints.

get_zostavajuce_id_uctovne_zavierkyA

Get count of remaining accounting closure IDs after a given ID. Useful for estimating pagination progress.

Inputs: zmenene_od (required), pokracovat_za_id. Returns: Response for remaining IDs count endpoints.

get_zostavajuce_id_vyrocne_spravyA

Get count of remaining annual report IDs after a given ID. Useful for estimating pagination progress.

Inputs: zmenene_od (required), pokracovat_za_id. Returns: Response for remaining IDs count endpoints.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 25 tools

    Disambiguation4/5

    Most tools have distinct purposes, clearly targeting specific resources like financial reports, accounting units, or reference data. However, there is some overlap between get_uctovny_vykaz and get_uctovny_vykaz_with_labeled_tables, as both retrieve financial reports but with different formatting, which could cause confusion if an agent needs to choose between them. Other tools are well-separated by resource type and action.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations. The naming is predictable and uniform across all 25 tools, making it easy for agents to understand the pattern and infer tool purposes from their names.

    Tool Count3/5

    With 25 tools, the count is borderline high for a server focused on Slovak financial and business registry data. While it covers many aspects like reference data, financial reports, and pagination helpers, it may feel heavy and potentially overwhelming for agents, especially with multiple similar pagination tools. A more streamlined set could improve usability without losing functionality.

    Completeness5/5

    The tool set provides comprehensive coverage for the domain of accessing Slovak business and financial registry data. It includes retrieval of detailed entities (e.g., accounting units, financial reports), reference data (e.g., regions, legal forms), and pagination support for discovering changes. There are no obvious gaps; agents can perform all necessary operations from listing to detailed queries, ensuring no dead ends in workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides access to Poland's largest business registry database, enabling company search, beneficiary checks, and financial document retrieval via natural language.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables access and analysis of Japanese corporate financial data (PL/BS/CF) via EDINET API. Supports searching companies, listing reports, and comparing financials through natural language queries.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to query over 3 million Polish companies from the KRS and CEIDG registries, including financials, board members, shareholders, rankings, and sector statistics, plus public-register enrichments such as procurement awards, EU funding, insolvency records, and stock listings. Users can search, count, filter, and export company data or run read-only SQL through natural-language prompts.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to look up Polish company registry data from KRS, including registry profiles, current and historical board, shareholder and proxy connections with dates, change timelines, financial statements, state aid and public contracts. All tools are read-only and reachable over a remote Streamable HTTP endpoint, with the same data also exposed through a REST API.
      MIT