Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

ARES (Czech business registry)

NPM · @MILOS106/ARES-MCP · SCANNED AUG 4

MCP for ARES, the Czech business registry: lookup, due diligence, insolvency, signed provenance

Available components

+24 this week 69 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (100 of 104), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (100 of 104), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability76
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1756 tokens (~125/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @milos106/ares-mcp

# add to Claude Code
claude mcp add milos106-ares-mcp -- npx -y @milos106/ares-mcp
# add to Codex CLI
codex mcp add milos106-ares-mcp -- npx -y @milos106/ares-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "milos106-ares-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@milos106/ares-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add milos106-ares-mcp --command npx --arg -y --arg @milos106/ares-mcp
# ~/.hermes/config.yaml
mcp_servers:
  milos106-ares-mcp:
    command: "npx"
    args: ["-y", "@milos106/ares-mcp"]
// mcp.json
{
  "mcpServers": {
    "milos106-ares-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@milos106/ares-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.23 functional
  • 2 Aug 26 +45
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Security disclosure: fail → unverified functional
    • Tool coverage: 100 → unverified functional
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • First check of Schema quality: unverified functional
    • Licence: MIT functional
  • 31 Jul 26 −7
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 27 Jul 26 45

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@milos106/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 100 packages

100 packages in the resolved dependency tree · 99 deprecated · 31 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 14 exposed · ~1,756 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
ares_check_insolvenci ~102

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.

NameTypeReqDescription
icostringyesCzech IČO of the entity to check.

No output schema declared.

No examples provided.

ares_check_vat_payer ~128

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

NameTypeReqDescription
expectedDicstringOptional DIČ to cross-check against ARES (e.g. 'CZ27074358'). Tool will report a mismatch.
icostringyesCzech IČO of the company.

No output schema declared.

No examples provided.

ares_cross_company_persons ~193

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

NameTypeReqDescription
emitMermaidbooleanIf true, also include a Mermaid `graph LR` string that MCP clients (e.g. Claude) can render as a visual person→companies diagram.
icosarrayyesList of 2–50 Czech IČOs to cross-reference. Each will be validated and looked up in the Public Register (VR).
includeHistoricalbooleanIf true, include former members (those with `datumVymazu` set). Useful for nominee director detection and tracking director musical chairs. Default false = active members only.

No output schema declared.

No examples provided.

ares_export_for_invoicing ~198

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.

NameTypeReqDescription
icostringyesCzech IČO of the entity to export.
targetstringyesInvoice-system target format. `fakturoid` returns a JSON shape ready to POST to https://app.fakturoid.cz/api/v3/{slug}/subjects.json. `idoklad` returns a JSON shape compatible with https://api.idokla…

No output schema declared.

No examples provided.

ares_full_due_diligence ~111

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.

NameTypeReqDescription
icostringyesCzech IČO of the company.

No output schema declared.

No examples provided.

ares_get_res_classification ~90

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.

NameTypeReqDescription
icostringyesCzech IČO of the company.

No output schema declared.

No examples provided.

ares_get_statutory_bodies ~110

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.

NameTypeReqDescription
icostringyesCzech IČO of the company.
includeHistoricalbooleanIf true, include members already removed (datumVymazu set). Default: only currently active.

No output schema declared.

No examples provided.

ares_get_trade_licenses ~84

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.

NameTypeReqDescription
icostringyesCzech IČO of the entity.

No output schema declared.

No examples provided.

ares_lookup_company ~75

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

NameTypeReqDescription
icostringyesCzech IČO. Will be normalized and Mod-11 checked before lookup.

No output schema declared.

No examples provided.

ares_lookup_cz_nace ~90

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

NameTypeReqDescription
limitintegerMax number of results.
querystringyesCZ-NACE code (e.g. '620') or name fragment (e.g. 'informačn'). Used to look up classification entries.

No output schema declared.

No examples provided.

ares_search_by_address ~156

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.

NameTypeReqDescription
adresastringyesFree-form Czech address text — e.g. 'Vratimovská 689/117, Ostrava' or 'Pyšelská 2327/2, Praha'. The tool forwards it to ARES as a sidlo.textovaAdresa filter.
limitintegerMax number of IČOs to return per page.
offsetintegerPagination offset.

No output schema declared.

No examples provided.

ares_search_companies ~213

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.

NameTypeReqDescription
czNacearrayList of CZ-NACE classification codes (e.g. ['620'] for IT activities).
limitintegerPage size, max 100.
obchodniJmenostringFull or partial company name (full-text search).
offsetintegerPagination offset.
pravniFormaarrayList of legal-form codes (e.g. ['112'] for s.r.o., ['121'] for a.s.).
sidloKodObceintegerNumeric municipality code (RÚIAN). Use ares_lookup_czNace or your own lookup if unknown.
sidloPscstringPostal code of the registered seat, e.g. '11000' or '110 00'.

No output schema declared.

No examples provided.

ares_standardize_address ~95

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.

NameTypeReqDescription
adresastringyesFree-form address text to standardize against RÚIAN (e.g. 'Za Prachárnou 4962/45, Jihlava').
limitintegerMax number of suggestions.

No output schema declared.

No examples provided.

ares_validate_ico ~111

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.

NameTypeReqDescription
icostringyesCzech IČO (Identifikační číslo osoby). Accepts 1–8 digits, optional 'CZ' prefix, whitespace, dashes or dots. Examples: '27074358', 'CZ27074358', '270 743 58'.

No output schema declared.

No examples provided.