cz-agents-mcp
cz-agents-mcp
체코 정부 및 비즈니스 데이터를 위한 Model Context Protocol 서버입니다. AI 에이전트에게 ARES, ČNB, ISIR, 제재 심사 및 통합 실사(due-diligence) 애그리게이터에 대한 네이티브 액세스 권한을 부여하세요.
랜딩 페이지: cz-agents.dev
사용 가능한 서버
패키지 | 소스 | 상태 |
ARES — 체코 기업 등록부 | ✅ live | |
ČNB — 일일 환율 | ✅ live | |
EU + OFAC 제재 심사 (KYC/AML) | ✅ live | |
ISIR — 체코 파산 등록부 | ✅ live | |
실사 애그리게이터 (ARES + 제재 + ISIR + 법정 체인) | ✅ live |
Related MCP server: eu-company-mcp-server
빠른 시작
Claude Desktop / Cursor (stdio)
{
"mcpServers": {
"ares": { "command": "npx", "args": ["-y", "@czagents/ares"] },
"cnb": { "command": "npx", "args": ["-y", "@czagents/cnb"] },
"sanctions": { "command": "npx", "args": ["-y", "@czagents/sanctions"], "env": { "SANCTIONS_DB": "/path/to/sanctions.db" } },
"isir": { "command": "npx", "args": ["-y", "@czagents/isir"], "env": { "ISIR_SOAP_ENABLED": "1" } },
"dd": { "command": "npx", "args": ["-y", "@czagents/dd"], "env": { "SANCTIONS_DB": "/path/to/sanctions.db" } }
}
}원격 / 스트리밍 HTTP
{
"mcpServers": {
"ares": { "url": "https://ares.cz-agents.dev/mcp" },
"cnb": { "url": "https://cnb.cz-agents.dev/mcp" },
"sanctions": { "url": "https://sanctions.cz-agents.dev/mcp" },
"isir": { "url": "https://isir.cz-agents.dev/mcp" },
"dd": { "url": "https://dd.cz-agents.dev/mcp" }
}
}도구
@czagents/ares (9개 도구)
lookup_by_ico({ ico })— 전체 기업 기록search_companies({ query, city, street, psc, nace, pocet })— 통합 검색search_by_address({ street, city, psc })— 주소별 모든 기업 검색search_by_nace({ nace, city })— CZ-NACE 활동 코드별 검색get_statutaries({ ico })— 현재 법정 기관 (실사용)validate_dic({ dic })— DIČ 형식 + MOD11 체크섬check_vat_payer({ ico })— VAT 등록 + 투명 계좌get_bank_accounts({ ico })— DPH 게시 계좌get_history({ ico })— 이전 이름, 주소 변경 내역
@czagents/cnb (3개 도구)
get_rates({ date? })— 전체 일일 환율 시트convert({ amount, from, to, date? })— CZK 교차 변환get_rate({ code, date? })— 단일 통화 환율
@czagents/sanctions (5개 도구)
search_person({ name, dob?, nationality?, threshold? })— EU + OFAC 대상 퍼지 KYC 심사search_entity({ name, country?, threshold? })— 법인/기업 심사check_ico({ ico, name? })— 제재 목록에서 체코 IČO 직접 조회get_listing({ id })—${source}:${id}별 전체 기록list_recent_updates({ since, source? })— 일일 모니터링 (추가/삭제/수정)
@czagents/isir (3개 도구)
check_ico_insolvency({ ico })— 파산 등록부에서 체코 IČO 직접 조회search_person_insolvency({ ico?, rc?, dob?, firstname?, surname? })— IČO, 주민등록번호 또는 이름+생년월일로 개인 찾기poll_isir_events({ since })— 일일 모니터링을 위한 추가 전용 이벤트 피드
@czagents/dd (3개 도구)
get_dd_report({ ico, depth })— 위험 점수가 포함된 통합 ARES + 제재 + ISIR 보고서get_risk_score({ ico })— 빠른 0–100 점수 + 주요 위험 요소get_statutory_chain({ ico, max_depth })— UBO / 페이퍼 컴퍼니 트리 탐색
추가 읽기
데이터셋에 없는 국가를 위한 MCP 서버 구축하기 — 설계 근거, 주의 사항(MOD11, ARES Swagger 버그), 그리고 이 패턴을 어떻게 비영어권 지역에 맞게 MCP를 조정하는지에 대한 내용입니다.
라이선스
MIT © Martin Havel — LICENSE 참조
Available Tools
9 toolsdetect_address_crowdingARead-onlyInspect
Detects "shell-firm hotel" patterns — counts how many companies share the same registered address. Threshold-based risk: 1-9 normal (multi-tenant office), 10-49 mild (legitimate coworking), 50-199 medium (virtual office provider), 200+ high (shell-firm hotel). Compliance tier or higher.
Inputs: ico (required).
detect_nominee_directorARead-onlyInspect
Detect "white horse" / nominee director patterns — 3 surface indicators (age outlier, multi-board membership, recent appointment) computable from ARES data alone. Returns indicator breakdown with riskScore 0-100. Pro Compliance tier or higher. For 8-indicator deep analysis including ISIR cross-reference, sanctions, address crowding and phoenix pattern, see detect_nominee_director_rich in @czagents/ddplus.
Inputs: ico (required).
detect_phoenixARead-onlyInspect
Detect phoenix company pattern — 3 surface indicators (surname match with prior insolvent director, founding proximity < 12 months to insolvency, NACE sector presence) computable from ARES + ISIR data alone. Returns PhoenixReport with riskScore 0-100. Pro Compliance tier or higher. For 4 additional deep indicators (founder identity, asset transfer, multi-cycle, address continuity) see detect_phoenix_rich in @czagents/ddplus.
Inputs: ico (required).
get_dd_reportARead-onlyInspect
Generate a complete due-diligence report for a Czech IČO. Returns company facts (name, address, legal form, VAT status, bank accounts), statutory body with per-member sanctions check, and a transparent risk score with all triggered red flags.
Inputs: ico (required), depth.
get_eu_dd_reportARead-onlyInspect
EU Due-Diligence report for an international company. Input: 20-char LEI code, or company name + optional country. Returns GLEIF entity data (status, address, registration number) plus sanctions screening against EU/OFAC lists. Coverage notes per country included. Note: GLEIF covers mid/large firms with LEI — SMEs may not be found. Pro Compliance tier or higher.
Inputs: identifier (required), country.
get_eu_parentARead-onlyInspect
Find the EU/international parent company for a Czech IČO. Looks up the company name in ARES, then searches GLEIF (Global LEI Foundation) for a matching LEI-registered entity. Returns LEI, name, country, and confidence level (HIGH/MEDIUM/LOW). Note: GLEIF covers mid/large international firms; SMEs without an LEI will not be found. Pro Compliance tier or higher.
Inputs: ico (required).
get_risk_scoreARead-onlyInspect
Lightweight version of get_dd_report — returns just the numeric score (0-100), risk level, and top triggered red flags. Faster when you only need a yes/no/maybe screen.
Inputs: ico (required).
get_risk_timelineARead-onlyInspect
Build a chronologically sorted lifecycle timeline for a Czech company — basic events include company formation, statutory appointments, active insolvency, sanctions matches, VAT reliability flips. Returns events[] with riskScore 0-100. Pro Compliance tier or higher. For enriched timeline with ISIR lifecycle, address history, cross-entity events, and AI narrative summary, see get_risk_timeline_rich in @czagents/ddplus.
Inputs: ico (required).
get_statutory_chainARead-onlyInspect
Surname-based heuristic walk through statutory bodies of related Czech companies. Best for shell-company unwinding in small s.r.o. with RARE surnames. NOT a true UBO source — for actual beneficial ownership use the ESM (evidence skutečných majitelů, separate registry, future @czagents/esm). For boards of large public companies with common Czech surnames (Novák, Zima, Kolář…) results are noisy by design; the tool auto-skips persons whose surname matches >50 companies with a SURNAME_TOO_COMMON note.
Inputs: ico (required), max_depth.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct niche: full report, light score, statutory chain, nominee detection, phoenix detection, timeline, address crowding, EU report, and EU parent lookup. Even the overlapping get_dd_report and get_risk_score are clearly delineated as a comprehensive vs. lightweight version, preventing confusion.
All tool names follow a consistent verb_noun pattern in snake_case: get_dd_report, get_risk_score, get_statutory_chain, detect_nominee_director, detect_phoenix, get_risk_timeline, detect_address_crowding, get_eu_dd_report, get_eu_parent. Verbs are get/detect, nouns are descriptive, and no mixed conventions appear.
Nine tools form a well-scoped set for the domain of Czech due-diligence and risk analysis. Each tool addresses a distinct analytical need without redundancy, and the count is neither sparse nor overwhelming for an MCP server.
The tool surface covers the full due-diligence lifecycle: comprehensive report, quick risk screening, statutory chain analysis, nominee and phoenix pattern detection, timeline, address crowding, EU cross-border checks, and parent lookup. No critical gap is apparent for the stated purpose of Czech company risk assessment.
Maintenance
Related MCP Connectors
Czech ARES company registry: VAT, insolvency, RÚIAN addresses, IČO/DIČ checks. All free, no auth.
Czech company and VAT checks, EU VAT validation, IBAN checksums and Czech National Bank rates.
AI VAT Number Validation: hosted MCP server for EU VAT number checks via VIES.
Czech business register (ARES) — look up any Czech company or sole trader by IČO or by name, and…
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for Slovak business registers (RPO) — AI agents can query 1.4M+ Slovak legal entities via Slovakia's official Statistical Office API. Search companies by name, IČO, or get full entity details including legal form, address, and statutory representatives.21MIT
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- AlicenseAqualityDmaintenanceMCP server providing AI assistants access to Polish public registries (KRS, CEIDG) and statistical data (GUS BDL) for querying companies, sole proprietorships, and regional statistics.7MIT
- AlicenseAqualityDmaintenanceMCP server that provides AI agents with Polish business data tools: identifier validation (NIP, PESEL, REGON, KRS, IBAN), VAT whitelist checks, EU VIES lookups, and NBP exchange rates.58 npmMIT