registeruz-mcp 0.1.0

MCP server for Slovak Registry of Financial Statements (Register účtovných závierok)

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
• 5 MCP Prompts: Pre-built workflows for common tasks
• 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:

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

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

Prompt	Description
search_company_by_ico	Search for company by IČO and get financial statements
search_company_by_dic	Search for company by DIČ
get_latest_financials	Get latest financial statements for a company
analyze_changes	Analyze changes in accounting units over a period
explore_template	Explore financial report template structure

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