Register UZ MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Register UZ MCP Server show me the financial statements for Slovnaft"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mcpClaude 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/mcpAPI 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-mcpOr using uvx to run directly without installation:
uvx registeruz-mcpFrom source
# Clone the repository
git clone https://github.com/alhafoudh/registeruz-mcp.git
cd registeruz-mcp
# Install dependencies
uv syncUsage
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.pyRun with FastMCP CLI
uv run fastmcp run registeruz_mcp.pyInspect available tools
uv run fastmcp inspect registeruz_mcp.pyDevelopment mode with MCP Inspector
uv run fastmcp dev registeruz_mcp.pyAvailable Tools
List Tools (Get IDs)
Tool | Description |
| Get accounting unit IDs changed since a date (supports filtering by IČO, DIČ, legal form) |
| Get accounting closure IDs changed since a date |
| Get financial report IDs changed since a date |
| Get annual report IDs changed since a date |
Count Tools (Pagination)
Tool | Description |
| Count remaining accounting unit IDs |
| Count remaining accounting closure IDs |
| Count remaining financial report IDs |
| Count remaining annual report IDs |
Detail Tools
Tool | Description |
| Get accounting unit details by ID |
| Get accounting closure details by ID |
| Get financial report with tables and data |
| Get annual report details by ID |
Template Tools
Tool | Description |
| Get template structure by ID |
| Get all available templates |
Classifier Tools
Tool | Description |
| Get all legal forms |
| Get SK NACE classification codes |
| Get ownership types |
| Get organization sizes |
| Get Slovak regions |
| Get Slovak districts |
| Get Slovak settlements |
Download Tools
Tool | Description |
| Get download URL for attachment |
| Get PDF download URL for financial report |
Labeled Data Tools
Tool | Description |
| Get financial report with labeled tables (combines report with template labels in one call) |
| Search for specific values by row label, row code, column label, or table name |
Available Resources
Static Resources (Classifiers)
URI | Description |
| Legal forms |
| SK NACE codes |
| Ownership types |
| Organization sizes |
| Regions |
| Districts |
| Settlements |
| All templates |
Dynamic Resource Templates
URI Pattern | Description |
| Accounting unit by ID |
| Accounting closure by ID |
| Financial report by ID |
| Annual report by ID |
| Template by ID |
Available Prompts
Company Search Prompts
Prompt | Description |
| Search for company by IČO and get financial statements |
| Search for company by tax ID (DIČ) |
| Search for companies by legal form (e.g., s.r.o., a.s.) |
Financial Analysis Prompts
Prompt | Description |
| Get latest financial statements for a company |
| Compare company financials across multiple years |
| Extract specific financial metrics (profit, assets, liabilities) |
| Get balance sheet (Súvaha) data for a company |
| Get income statement (Výkaz ziskov a strát) for a company |
Change Tracking & Monitoring Prompts
Prompt | Description |
| Analyze changes in accounting units over a period |
| Monitor new financial statements filed since a date |
| Track a specific company for recent changes |
Document & Download Prompts
Prompt | Description |
| Get all downloadable documents for a company |
| Download annual reports (Výročné správy) for a company |
Template & Structure Prompts
Prompt | Description |
| Explore financial report template structure |
| List all available report templates with their purposes |
Classifier & Reference Data Prompts
Prompt | Description |
| Get all Slovak regions and districts hierarchy |
| Get all legal forms with explanations |
| Explore SK NACE industry classification codes |
Bulk/Export Prompts
Prompt | Description |
| Export basic data for multiple companies |
| 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-mcpUsing local installation
If you've cloned the repository:
claude mcp add registeruz -- uv run --directory /path/to/registeruz-mcp python registeruz_mcp.pyClaude 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-extrasRun tests
uv run pytest -vLicense
MIT
Available Tools
25 toolsget_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
Scored across 25 tools
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.
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.
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.
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
Related MCP Connectors
Slovak and Czech company registers: lookup, VAT payers, e-invoicing readiness, company history.
Company lookups in the official registers of Slovakia and Czechia, with the source on each record.
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Agent-native SEC data, 20 tools: statements assembled, any line item, filings synthesized. No key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to Poland's largest business registry database, enabling company search, beneficiary checks, and financial document retrieval via natural language.1-
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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