Ares (czech Business Registry) Mcp — Ares Mcp

SSE

by milos106

294 downloads Not rated yet

GitHub Website

Other

About

MCP server for ARES, the official Czech business registry — live against ares.gov.cz. 14 tools: company lookup, full due diligence, statutory bodies, insolvency, VAT-payer & trade-license checks, address search, and cross-company person graphs.

Details

Transport: SSE

Explore

- 14 tools covering company lookup, due diligence, and more
- Live queries against the official ARES registry (ares.gov.cz)
- Optional signed provenance with Ed25519 signatures for offline verification
- Each signed response includes source, date, and a verifiable signature
- Available as a Docker container or hosted beta service

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Ares (czech Business Registry) Mcp — Ares Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

From the repository

Run the Docker image ghcr.io/milos106/ares-mcp:0.1.0 or connect to the hosted beta endpoint at https://ares-mcp.icovazby.cz/mcp. No configuration parameters are described in the README.

`ares_validate_ico`

Validate a Czech IČO via the ČSÚ Mod-11 checksum. Pure function — does not call ARES. Returns the normalized 8-digit IČO and whether the checksum is valid.

`ares_lookup_company`

Look up a Czech company by IČO. Returns aggregated data from ARES (basic identification, legal form, registered address, VAT status, CZ-NACE classification, registrations in VR/RES/RŽP).

`ares_search_companies`

Search Czech companies by structured filters (name, postal code, municipality, legal form, CZ-NACE). At least one filter is required to avoid full-registry scans. Returns paginated results with totals.

`ares_search_by_address`

Find all Czech companies whose registered seat (sídlo) matches a given address. Useful for shell-company / virtual-office detection: an address with dozens or hundreds of entities at it is a strong signal. Returns IČOs, names, and the canonical address ARES holds for each.

`ares_get_statutory_bodies`

List statutory bodies (jednatelé, představenstvo, dozorčí rada) of a Czech company from the Public Register (VR). By default returns currently-active members only. Useful for due diligence, KYC, and verifying who is authorised to sign contracts.

`ares_get_trade_licenses`

List trade licenses (živnostenská oprávnění) of a Czech entity from the Trade Register (RŽP). Returns each license's subject, type (volná / vázaná / koncesovaná / řemeslná), validity period, and fields of activity.

`ares_check_vat_payer`

Check whether a Czech entity is registered as a VAT payer (plátce DPH) based on ARES. Returns the IČ DPH (= DIČ) if active. NOTE: ARES reflects VAT-payer status with up to 24h delay; the authoritative source is MFČR (adisspr.mfcr.cz).

`ares_standardize_address`

Standardize a free-form Czech address against the RÚIAN register. Returns canonical address text, RÚIAN address-point code, and confidence score for up to N suggestions.

`ares_lookup_cz_nace`

Look up CZ-NACE (Czech industry classification) entries by code or partial name. Useful when filtering ares_search_companies by industry.

`ares_cross_company_persons`

Given a list of Czech IČOs, find natural persons (and legal entities) who hold active statutory roles in two or more of them. Returns a structured cross-reference plus an optional Mermaid graph for visualization. Useful for due diligence (holding-group mapping, undisclosed beneficial connections, nominee director detection on a small known set).

`ares_check_insolvenci`

Fast red-flag check: is a Czech entity currently in insolvency proceedings or marked as bankrupt? Reads the ARES `seznamRegistraci` for the Insolvency Register (IR) and Central Bankruptcy Register (CEÚ). Returns a clear true/false on `isInsolvent` plus the underlying state codes. Useful as a pre-contract sanity check.

`ares_full_due_diligence`

One-shot due-diligence report for a Czech company. Fetches the aggregate ARES profile, Public Register record (statutory bodies), Trade Register (licenses), evaluates insolvency status (IR + CEÚ) and dissolution date, and returns a structured report with a green/yellow/red risk flag plus a Markdown summary suitable for chat display. Replaces 4–5 individual lookups with a single call.

`ares_get_res_classification`

Get statistical classification of a Czech company from RES (Registr ekonomických subjektů): headcount bracket (decoded into SME / large), institutional sector (ESA 2010), primary CZ-NACE, financial office (FÚ), and NUTS region. Useful for B2B segmentation, reporting and policy-style analysis.

`ares_export_for_invoicing`

Transform an ARES company profile into a payload ready for a Czech invoicing system: Fakturoid (JSON), iDoklad (JSON), or Pohoda (XML-hint JSON). Pure data transformation — no calls to the target system. The result is a paste-ready or post-ready object that fills the identification + address fields; the caller adds contact, bank and pricing.

Company lookup, full due diligence, statutory bodies, insolvency check, VAT-payer check, trade licenses, address search,
cross-company person graph, and more.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ares (czech business registry) mcp \u2014 ares mcp": {
            "ares-mcp": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "ghcr.io/milos106/ares-mcp:0.1.0"
                ]
            }
        }
    }
}

McpServers

{
    "ares-mcp": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "ghcr.io/milos106/ares-mcp:0.1.0"
        ]
    }
}

MCP server for ARES, the official Czech business registry. Live against ares.gov.cz.

14 tools

Company lookup, full due diligence, statutory bodies, insolvency check, VAT-payer check, trade licenses, address search, cross-company person graph, and more.

Optional signed provenance

Every signed response carries source + date + an Ed25519 signature, independently verifiable offline.

Install (Docker)

docker run -i --rm ghcr.io/milos106/ares-mcp:0.1.0

Hosted (beta)

https://ares-mcp.icovazby.cz/mcp MIT · https://icovazby.cz

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

ares_validate_ico

ares_lookup_company

ares_search_companies

ares_search_by_address

ares_get_statutory_bodies

ares_get_trade_licenses

ares_check_vat_payer

ares_standardize_address

ares_lookup_cz_nace

ares_cross_company_persons

ares_check_insolvenci

ares_full_due_diligence

ares_get_res_classification

ares_export_for_invoicing

Claude Desktop / Cursor

McpServers

14 tools

Optional signed provenance

Install (Docker)

Hosted (beta)

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`ares_validate_ico`

`ares_lookup_company`

`ares_search_companies`

`ares_search_by_address`

`ares_get_statutory_bodies`

`ares_get_trade_licenses`

`ares_check_vat_payer`

`ares_standardize_address`

`ares_lookup_cz_nace`

`ares_cross_company_persons`

`ares_check_insolvenci`

`ares_full_due_diligence`

`ares_get_res_classification`

`ares_export_for_invoicing`