ARES (Czech business registry)

ares-mcp

MCP server for ARES — the Czech business registry. Validate IČO/DIČ, look up companies, statutory bodies, trade licenses and addresses directly from Claude Desktop, Claude Code, Cursor and any other MCP-compatible client.

Open-source (MIT), self-hosted. Runs against the public ARES API — your queries never leave your machine. Optionally emits Ed25519-signed, sourced answers so anyone can verify their integrity and origin offline.

Hosted version: icovazby.cz — full web company-checks across 10+ Czech registers (ARES, Public Register, trade licenses, insolvency, sanctions, …).

ARES (Administrativní registr ekonomických subjektů) is the official public registry of Czech businesses, operated by the Czech Ministry of Finance (MFČR). This project is an independent, community-built MCP server that calls the public ARES REST API.

Not affiliated with the Czech Ministry of Finance. This project is not affiliated with, endorsed by, or sponsored by MFČR or the ARES operator. "ARES" refers to the public information system; this MCP server is third-party software.

• Free, MIT-licensed code. No API key required (ARES is a public API).
• 14 stable tools covering the full due-diligence + invoicing workflow: validation, lookup, structured search, search-by-address (virtual-office detection), statutory bodies, trade licenses, VAT check, address standardization, NACE lookup, RES statistical classification (size bracket, ESA 2010 sector), insolvency check, cross-company person graph with Mermaid + optional historical mode for nominee detection, a one-shot ares_full_due_diligence macro with 🟢🟡🔴 risk flag, and an export adapter that emits Fakturoid / iDoklad / Pohoda payloads ready to POST.
• Two transports. Stdio (default) for local AI clients, Streamable HTTP (/mcp) for remote / web deployment.
• Verifiable provenance (optional). With a signing key set, the due-diligence, statutory-bodies and insolvency tools return a signed envelope where every fact carries its registry source + date; verify it offline against the published JWKS. A *technical integrity & origin proof — not a qualified e-signature or an official extract.*
• Defensive by design. Rate-limit aware (token bucket + exponential backoff with Retry-After), per-IP request throttling on the HTTP variant, structured errors, no PII stored or logged by default.

Setup

Two ways to run ares-mcp — pick one:

Option A — npx (no install, recommended)

{

"mcpServers": { "ares": { "command": "npx", "args": ["-y", "@milos106/ares-mcp"] } } }

Option B — from source

git clone git@github.com:milos106/ares-mcp.git

cd ares-mcp npm install npm run build npm test

Then point your MCP client at the absolute path of dist/index.js. The per-client examples below use this from-source form — swap "command": "node", "args": ["…/dist/index.js"] for the npx form above if you prefer a zero-install setup.

Claude Desktop

Edit your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{

"mcpServers": { "ares": { "command": "node", "args": ["/absolute/path/to/ares-mcp/dist/index.js"] } } }

Restart Claude Desktop.

Claude Code

claude mcp add ares -- node /absolute/path/to/ares-mcp/dist/index.js

Cursor

In Cursor settings → MCP servers:

{

"ares": { "command": "node", "args": ["/absolute/path/to/ares-mcp/dist/index.js"] } }

Get ready-to-paste client config

After npm run build, this prints absolute-path config blocks for Claude Desktop, Cursor, Claude Code, and the local HTTP transport:

npm run config

Copy the JSON block straight into your client's MCP config — no path editing needed.

Try it interactively with MCP Inspector

npm run inspector

(Equivalent to npx @modelcontextprotocol/inspector node dist/index.js.)

Opens a browser UI at http://localhost:6274 where you can list tools, fill arguments, and run them against live ARES — no client configuration needed.

Run as a local HTTP service

A second entry point exposes the same tools over MCP Streamable HTTP. Useful when sharing one running instance across multiple local clients.

PORT=3030 npm run start:http

Endpoints:

• POST /mcp — Streamable HTTP transport (JSON-RPC over HTTP / SSE)
• GET /healthz — liveness + session count

Configuration via environment variables:

There is no built-in authentication — bind it to 127.0.0.1 only or put a reverse proxy in front if you ever need to expose it.

Tools

Example prompts

"Validate IČO 27074358 and tell me if it's a VAT payer and which region it's based in."

"Find Czech IT companies (CZ-NACE 620) registered in Prague."

"Who are the statutory directors of IČO 26168685? When were they appointed?"

"Standardize this address: 'Za prachárnou 4962/45, Jihlava'."

"Look up the CZ-NACE code for software development."

"I have IČOs 26185610, 46967851, 46900411, 27435148. Are any people on the boards of more than one? Draw it."

"Run a full due-diligence check on IČO 45193258 before I sign anything."

The DD prompt calls ares_full_due_diligence and returns a complete risk-flagged report. Real example (Liberty Ostrava a.s., captured 2026-06-07):

# Due diligence: Liberty Ostrava a.s.

Risk level: 🔴 RED

Findings:

• 🚨 Active insolvency or bankruptcy on record.

Identification

• IČO: 45193258
• DIČ: CZ45193258 (VAT payer: yes)
• Legal form: 121
• Founded: 1992-01-22
• Registered seat: Vratimovská 689/117, Kunčice, 71900 Ostrava

Governance

• Active statutary members: 3

Insolvency

• Insolvenční rejstřík: ACTIVE
• Centrální evidence úpadců: NONE
• Currently insolvent.

The same prompt on a healthy company (AGROFERT IČO 26185610) yields 🟢 GREEN with 12 active statutary members and no findings.

The last prompt uses ares_cross_company_persons. The tool returns a Mermaid graph that Claude Desktop, Claude Code, and Cursor will render inline. On the Agrofert holding example above, the tool reports that *Michal Jedlička* sits on three of the four boards and *Jaroslav Kurčík* on two — a classic holding-group fingerprint.

A note on person→companies search

ARES's public REST v3 API does not expose a search-by-person endpoint (the AngazovanaOsobaFiltr schema is defined but unused). ares_cross_company_persons therefore operates over a known set of IČOs that you provide — it does not enumerate the registry. Full reverse lookup ("which companies has Jan Novák ever sat on?") requires a mirrored graph database and is out of scope for this MIT-licensed server.

Real example — the Agrofert holding

Run ares_cross_company_persons with four IČOs from the Agrofert group (AGROFERT itself + three subsidiaries) and the tool returns the full board overlap. Captured from a live ARES call on 2026-06-07:

zpracovanoIco: 4

totalActivePersons: 29 sharedCount: 3

• Ing. MICHAL JEDLIČKA (1978-01-06) AGROFERT, a.s. — člen představenstva Kostelecké uzeniny a.s. — předseda představenstva Vodňanské kuře, s.r.o. — Jednatel

• Ing. JAROSLAV KURČÍK (1969-08-24) AGROFERT, a.s. — člen představenstva PENAM, a.s. — předseda představenstva

• AGROFERT, a.s. (právnická osoba, IČO 26185610) PENAM, a.s. — člen představenstva Kostelecké uzeniny a.s. — člen představenstva

Rendered as Mermaid (Claude Desktop / Claude Code / Cursor render this inline):

graph LR

C_26185610["AGROFERT, a.s. 26185610"]:::company C_46967851["PENAM, a.s. 46967851"]:::company C_46900411["Kostelecké uzeniny a.s. 46900411"]:::company C_27435148["Vodňanské kuře, s.r.o. 27435148"]:::company P_0(["Ing. MICHAL JEDLIČKA"]):::person P_0 ---|"člen představenstva"| C_26185610 P_0 ---|"předseda představenstva"| C_46900411 P_0 ---|"Jednatel"| C_27435148 P_1(["Ing. JAROSLAV KURČÍK"]):::person P_1 ---|"člen představenstva"| C_26185610 P_1 ---|"předseda představenstva"| C_46967851 P_2["AGROFERT, a.s. (IČO 26185610)"]:::legal P_2 ---|"člen představenstva"| C_46967851 P_2 ---|"člen představenstva"| C_46900411 classDef company fill:#e0f7fa,stroke:#006064,stroke-width:2px; classDef person fill:#fff3e0,stroke:#bf360c,stroke-width:2px; classDef legal fill:#f3e5f5,stroke:#4a148c,stroke-width:2px;

The third connection — AGROFERT a.s. itself listed as a corporate director in two of its subsidiaries — is a real holding-company pattern that flat per-company listings miss but the graph helper surfaces automatically.

Configuration

The server reads optional environment variables:

Error handling

Errors are returned as a JSON payload inside the tool result (with isError: true) so the agent can reason about them. Codes:

Data attribution & license

ARES data is published by the Czech Ministry of Finance as open data under the Creative Commons Attribution 4.0 (CC BY 4.0)