{
  "markdown": "# cz-agents-mcp\n\n[![CI](https://github.com/martinhavel/cz-agents-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/martinhavel/cz-agents-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=cz-agents)\n[![Glama](https://img.shields.io/badge/glama.ai-listed-success)](https://glama.ai/mcp/servers/lgs0fwjrl8)\n\nModel Context Protocol servers for **Czech & EU due diligence and KYC/AML** — company facts, insolvency (ISIR), EU + OFAC sanctions screening, VAT-payer reliability, phoenix & nominee-director detection, quantified risk score and statutory-chain (UBO) ownership analysis. Built on native access to ARES (company registry), ČNB (FX rates), ADIS (VAT-payer status) and 16 EU business registries (GB, SK, PL, NL, IT, AT, ES, BE, LT, DE, FR, NO, DK, FI, EE, SE).\n\n> **Want a hosted, production-ready version?**\n> [cz-agents.dev](https://cz-agents.dev) — managed API with a 14-day free trial (no credit card).\n> Adds higher quotas, nominee detection, risk timeline, address crowding, watchlist monitoring, and a web compliance dashboard.\n> Your self-hosted config keeps working after upgrade — same endpoints, same token format.\n\n### No-code web app\n\nDon't want to wire an MCP client? The same data is available as a web application:\n\n- [Company verification by IČO (ověření firmy)](https://app.cz-agents.dev/overeni-firmy)\n- [AML company check (AML kontrola firmy)](https://app.cz-agents.dev/aml-kontrola-firmy)\n- [Sanctions list screening (kontrola sankčních seznamů)](https://app.cz-agents.dev/kontrola-sankcnich-seznamu)\n- [Business partner due diligence (prověření obchodního partnera)](https://app.cz-agents.dev/provereni-obchodniho-partnera)\n- [Company change monitoring (monitoring změn ve firmě)](https://app.cz-agents.dev/monitoring-zmen-ve-firme)\n- Case study: [company due diligence with an AI agent — 20 minutes → 30 seconds](https://cz-agents.dev/case-study/company-due-diligence-with-ai-agent/)\n\n**Landing page:** [cz-agents.dev](https://cz-agents.dev) · **Listed in:** [official MCP Registry](https://registry.modelcontextprotocol.io) under DNS-verified namespace `dev.cz-agents/*`\n\n## Available servers\n\n| Package | Source | Status |\n|---|---|---|\n| [`@czagents/ares`](./packages/ares) | ARES — Czech Business Register | ✅ live |\n| [`@czagents/cnb`](./packages/cnb) | ČNB — daily FX rates | ✅ live |\n| [`@czagents/sanctions`](./packages/sanctions) | EU + OFAC sanctions screening (KYC/AML) | ✅ live |\n| [`@czagents/isir`](./packages/isir) | ISIR — Czech insolvency register | ✅ live |\n| [`@czagents/adis`](./packages/adis) | ADIS — unreliable VAT payer (nespolehlivý plátce DPH) + transparent accounts | ✅ live |\n| [`@czagents/dd`](./packages/dd) | Due-diligence aggregator (ARES + sanctions + ISIR + ADIS + statutory chain) | ✅ live |\n| [`@czagents/realestate`](./packages/realestate) | Czech distress real estate intelligence (ISIR sales + portál dražeb) | ✅ live (v0.1) |\n| [`@czagents/eu-registry`](./packages/eu-registry) | EU business registries — 16 countries (GB, SK, PL, NL, IT, AT, ES, BE, LT, DE, FR, NO, DK, FI, EE, SE) via Companies House / ORSR / KRS / SIRENE / BRREG / CVR / PRH / RIK / Bolagsverket / VIES / GLEIF | ✅ live |\n| [`@czagents/payqr`](./packages/payqr) | Payment QR codes (SPAYD / EPC-GiroCode) — bonus utility | ✅ live |\n\n### Premium tier — closed source\n\n| Server | What it adds | Where |\n|---|---|---|\n| `dev.cz-agents/ddplus` | 8-indicator nominee director detection (cross-DB), phoenix recidiva, enriched risk timeline with AI narrative, recursive linked-entities risk analysis (depth 1-3), shell-firm address crowding with provider detection, daily watchlist monitoring with email digest | Hosted-only at `ddplus.cz-agents.dev/mcp` — see [pricing](https://cz-agents.dev/pricing.html) |\n\n## Quick start\n\n### Claude Desktop / Cursor (stdio)\n\n```json\n{\n  \"mcpServers\": {\n    \"ares\":      { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/ares\"] },\n    \"cnb\":       { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/cnb\"] },\n    \"sanctions\": { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/sanctions\"], \"env\": { \"SANCTIONS_DB\": \"/path/to/sanctions.db\" } },\n    \"isir\":      { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/isir\"], \"env\": { \"ISIR_SOAP_ENABLED\": \"1\" } },\n    \"adis\":      { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/adis\"], \"env\": { \"ADIS_SOAP_ENABLED\": \"1\" } },\n    \"dd\":          { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/dd\"], \"env\": { \"SANCTIONS_DB\": \"/path/to/sanctions.db\", \"ADIS_SOAP_ENABLED\": \"1\" } },\n    \"eu-registry\": { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/eu-registry\"] },\n    \"payqr\":       { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/payqr\"] },\n    \"realestate\":  { \"command\": \"npx\", \"args\": [\"-y\", \"@czagents/realestate\"] }\n  }\n}\n```\n\n### Remote / Streamable HTTP\n\n```json\n{\n  \"mcpServers\": {\n    \"ares\":        { \"url\": \"https://ares.cz-agents.dev/mcp\" },\n    \"cnb\":         { \"url\": \"https://cnb.cz-agents.dev/mcp\" },\n    \"sanctions\":   { \"url\": \"https://sanctions.cz-agents.dev/mcp\" },\n    \"isir\":        { \"url\": \"https://isir.cz-agents.dev/mcp\" },\n    \"adis\":        { \"url\": \"https://adis.cz-agents.dev/mcp\" },\n    \"dd\":          { \"url\": \"https://dd.cz-agents.dev/mcp\" },\n    \"eu-registry\": { \"url\": \"https://eu-registry.cz-agents.dev/mcp\" },\n    \"payqr\":       { \"url\": \"https://payqr.cz-agents.dev/mcp\" },\n    \"realestate\":  { \"url\": \"https://realestate.cz-agents.dev/mcp\" }\n  }\n}\n```\n\n## Tools\n\n### `@czagents/ares` (10 tools)\n\n- `lookup_by_ico({ ico })` — full company record\n- `search_companies({ query, city, street, psc, nace, pocet })` — combined search\n- `search_by_address({ street, city, psc })` — all companies at an address\n- `search_by_nace({ nace, city })` — by CZ-NACE activity code\n- `get_statutaries({ ico })` — current statutory body (for due diligence)\n- `validate_dic({ dic })` — DIČ format + MOD11 checksum\n- `check_vat_payer({ ico })` — VAT registration + transparent accounts\n- `get_bank_accounts({ ico })` — DPH-published accounts\n- `get_history({ ico })` — previous names, address changes\n- `watch_entity({ ico })` — start free monitoring onboarding for one company\n\n### `@czagents/cnb` (3 tools)\n\n- `get_rates({ date? })` — full daily FX sheet\n- `convert({ amount, from, to, date? })` — CZK-crossed conversion\n- `get_rate({ code, date? })` — single currency rate\n\n### `@czagents/sanctions` (6 tools)\n\n- `search_person({ name, dob?, nationality?, threshold? })` — fuzzy KYC screen against EU + OFAC\n- `search_entity({ name, country?, threshold? })` — entity / company screen\n- `check_ico({ ico, name? })` — direct lookup of a Czech IČO on sanctions lists\n- `get_listing({ id })` — full record by `${source}:${id}`\n- `list_recent_updates({ since, source? })` — daily monitoring (added/removed/modified)\n- `rescreen_portfolio({ subjects[], since, source? })` *(paid; available when x402 is enabled)* — re-screen your own subject list against sanctions-list changes\n\n### `@czagents/isir` (3 tools)\n\n- `check_ico_insolvency({ ico })` — direct lookup of a Czech IČO in the insolvency register\n- `search_person_insolvency({ ico?, rc?, dob?, firstname?, surname? })` — find a person by IČO, birth number, or name + DOB\n- `poll_isir_events({ since })` — append-only event feed for daily monitoring\n\n### `@czagents/adis` (3 tools)\n\n- `check_dph_payer({ ico OR dic })` — full reliability check via ADIS V2: status (ANO/NE/NENALEZEN), subject type, name, address, transparent bank accounts (§ 96a ZDPH), unreliable-since date\n- `check_bulk_dph_payer({ icos[] OR dics[] })` — batch up to 100 subjects (lighter response, status + accounts only)\n- `list_unreliable_payers()` — full list of currently unreliable payers (50–100 MB, intended for daily mirroring)\n\n### `@czagents/dd` (12 tools)\n\n- `person_companies({ name, birth_year? })` — Czech VR companies connected to a person (free, anonymous)\n- `get_owners({ ico })` — direct + upstream Czech VR ownership tree (free, anonymous)\n- `get_dd_report({ ico, depth })` — unified ARES + sanctions + ISIR report with risk score\n- `watch_entity({ ico })` — start free monitoring onboarding for one company\n- `get_risk_score({ ico })` — fast 0–100 score + top red flags\n- `get_statutory_chain({ ico, max_depth })` — surname-based statutory-body walk for shell-company unwinding\n- `detect_nominee_director({ ico })` — 3-indicator \"white horse\" director detection (Compliance tier+)\n- `detect_phoenix({ ico })` — phoenix-company pattern detection (Compliance tier+)\n- `get_risk_timeline({ ico })` — chronological company lifecycle/risk timeline (Compliance tier+)\n- `detect_address_crowding({ ico })` — shell-firm \"address hotel\" detection (Compliance tier+)\n- `get_eu_dd_report({ lei OR name, country? })` — EU DD report: GLEIF entity data + EU/OFAC sanctions check (Compliance tier+)\n- `get_eu_parent({ ico })` — find EU/international parent via ARES → GLEIF LEI matching (Compliance tier+)\n\n### `@czagents/eu-registry` (3 tools)\n\n- `search_company({ name, country?, limit? })` — search non-Czech registries by company name across 16 countries\n- `get_company({ id, country })` — company record by national ID (CRN / IČO / KRS / SIREN / LEI / VAT / …)\n- `lookup_company_by_vat({ vat })` — free VIES VAT validity + name/address lookup\n\n### `@czagents/payqr` (6 tools)\n\n- `qr_payment({ iban, bic?, amount?, ... })` — payment QR (auto SPAYD for CZ/SK, EPC/GiroCode for other SEPA)\n- `qr_text({ text })` — plain-text QR\n- `qr_wifi({ ssid, password?, security? })` — Wi-Fi network QR\n- `qr_vcard({ name, phone?, email?, ... })` — vCard 3.0 contact QR\n- `qr_read({ image_data })` — decode + classify a QR code from a base64 image\n- `qr_payment_batch({ payments[] })` *(paid; available when x402 is configured)* — payment QRs for a whole invoice run in one call\n\n### `@czagents/realestate` (1 tool, free tier only)\n\n- `get_district_aggregate({ okres, window_days? })` — anonymised district-level distress real-estate stats (ISIR insolvencies + portál dražeb/CEVD forced sales); counts under 5 are banded to protect individual identification\n\n## What this is good for\n\nA toolkit for compliance, KYC/AML, accounting and cross-border checks over Czech & EU registries:\n\n- **VAT & invoicing** — verify VAT-payer status (ADIS) and convert at official ČNB FX rates before booking.\n- **Counterparty screening** — ARES identity, EU + OFAC sanctions, ISIR insolvency.\n- **Due diligence (flagship)** — the `@czagents/dd` aggregator combines the above into a risk score, statutory-chain / UBO walk, and EU-parent lookup.\n- **Cross-border** — company lookups across 16 EU registries (`@czagents/eu-registry`).\n\nUse a single-source server when you need just one dataset; use the due-diligence aggregator for combined, scored output.\n\nExample prompts the aggregator handles well:\n\n- **KYC pre-invoice** — *\"Before we send a 350 000 Kč invoice to IČO 11122234, flag any insolvency, sanctions, unreliable-VAT-payer status, or nominee-director red flags.\"*\n- **Vendor onboarding** — *\"Run KYC on this prospective supplier and tell me if anything looks off. Use the full statutory chain.\"*\n- **M&A pre-due-diligence** — *\"Generate a DD report on the acquisition target and walk the statutory body two levels deep — flag any insolvent firms in the network.\"*\n\n## Score & validation\n\n[![Glama Score](https://glama.ai/mcp/servers/martinhavel/cz-agents-mcp/badges/score.svg)](https://glama.ai/mcp/servers/martinhavel/cz-agents-mcp)\n\nA/A/A on Glama (quality / security / license), claimed and maintained.\nListed in the [official MCP registry](https://registry.modelcontextprotocol.io)\nunder DNS-verified namespace `dev.cz-agents/*`.\n\n## Further reading\n\n- [Building MCP servers for a country that isn't in the dataset](https://dev.to/martinhavel/building-mcp-servers-for-a-country-that-isnt-in-the-dataset-czech-gov-apis-1lo8) — design rationale, gotchas (MOD11, ARES Swagger bugs), and how this pattern adapts MCP to non-English locales.\n\n## License\n\nMIT © Martin Havel — see [LICENSE](./LICENSE)\n",
  "bytes": 12111,
  "sha": "f1627fe4dab48b0a6f0dc826e80e4544027365b4907318ce64f621c0e2f902cc",
  "repo_slug": "martinhavel/cz-agents-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_cz_agents_eu_registry_fc3cf6ff/readme"
}