@czagents/cnb
π βοΈ π π πͺ π§ - Czech National Bank (ΔNB) daily FX rates: fetch official CZK exchange rates, convert between currencies, fetch historical rates. Cached 10 min to ease upstream load. npm @czagents/cnb or HTTP at cnb.cz-agents.dev/mcp.
Quick Install
{
"mcpServers": {
"-czagents-cnb": {
"command": "npx",
"args": [
"-y",
"-czagents-cnb"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
cz-agents-mcp
Model 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).
Want a hosted, production-ready version? cz-agents.dev β managed API with a 14-day free trial (no credit card). Adds higher quotas, nominee detection, risk timeline, address crowding, watchlist monitoring, and a web compliance dashboard. Your self-hosted config keeps working after upgrade β same endpoints, same token format.
No-code web app
Don't want to wire an MCP client? The same data is available as a web application:
- Company verification by IΔO (ovΔΕenΓ firmy)
- AML company check (AML kontrola firmy)
- Sanctions list screening (kontrola sankΔnΓch seznamΕ―)
- Business partner due diligence (provΔΕenΓ obchodnΓho partnera)
- Company change monitoring (monitoring zmΔn ve firmΔ)
- Case study: company due diligence with an AI agent β 20 minutes β 30 seconds
Landing page: cz-agents.dev Β· Listed in: official MCP Registry under DNS-verified namespace dev.cz-agents/*
Available servers
| Package | Source | Status |
|---|---|---|
@czagents/ares | ARES β Czech Business Register | β live |
@czagents/cnb | ΔNB β daily FX rates | β live |
@czagents/sanctions | EU + OFAC sanctions screening (KYC/AML) | β live |
@czagents/isir | ISIR β Czech insolvency register | β live |
@czagents/adis | ADIS β unreliable VAT payer (nespolehlivΓ½ plΓ‘tce DPH) + transparent accounts | β live |
@czagents/dd | Due-diligence aggregator (ARES + sanctions + ISIR + ADIS + statutory chain) | β live |
@czagents/realestate | Czech distress real estate intelligence (ISIR sales + portΓ‘l draΕΎeb) | β live (v0.1) |
@czagents/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 |
@czagents/payqr | Payment QR codes (SPAYD / EPC-GiroCode) β bonus utility | β live |
Premium tier β closed source
| Server | What it adds | Where |
|---|---|---|
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 |
Quick start
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" } },
"adis": { "command": "npx", "args": ["-y", "@czagents/adis"], "env": { "ADIS_SOAP_ENABLED": "1" } },
"dd": { "command": "npx", "args": ["-y", "@czagents/dd"], "env": { "SANCTIONS_DB": "/path/to/sanctions.db", "ADIS_SOAP_ENABLED": "1" } },
"eu-registry": { "command": "npx", "args": ["-y", "@czagents/eu-registry"] },
"payqr": { "command": "npx", "args": ["-y", "@czagents/payqr"] },
"realestate": { "command": "npx", "args": ["-y", "@czagents/realestate"] }
}
}
Remote / Streamable 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" },
"adis": { "url": "https://adis.cz-agents.dev/mcp" },
"dd": { "url": "https://dd.cz-agents.dev/mcp" },
"eu-registry": { "url": "https://eu-registry.cz-agents.dev/mcp" },
"payqr": { "url": "https://payqr.cz-agents.dev/mcp" },
"realestate": { "url": "https://realestate.cz-agents.dev/mcp" }
}
}
Tools
@czagents/ares (10 tools)
lookup_by_ico({ ico })β full company recordsearch_companies({ query, city, street, psc, nace, pocet })β combined searchsearch_by_address({ street, city, psc })β all companies at an addresssearch_by_nace({ nace, city })β by CZ-NACE activity codeget_statutaries({ ico })β current statutory body (for due diligence)validate_dic({ dic })β DIΔ format + MOD11 checksumcheck_vat_payer({ ico })β VAT registration + transparent accountsget_bank_accounts({ ico })β DPH-published accountsget_history({ ico })β previous names, address changeswatch_entity({ ico })β start free monitoring onboarding for one company
@czagents/cnb (3 tools)
get_rates({ date? })β full daily FX sheetconvert({ amount, from, to, date? })β CZK-crossed conversionget_rate({ code, date? })β single currency rate
@czagents/sanctions (6 tools)
search_person({ name, dob?, nationality?, threshold? })β fuzzy KYC screen against EU + OFACsearch_entity({ name, country?, threshold? })β entity / company screencheck_ico({ ico, name? })β direct lookup of a Czech IΔO on sanctions listsget_listing({ id })β full record by${source}:${id}list_recent_updates({ since, source? })β daily monitoring (added/removed/modified)rescreen_portfolio({ subjects[], since, source? })(paid; available when x402 is enabled) β re-screen your own subject list against sanctions-list changes
@czagents/isir (3 tools)
check_ico_insolvency({ ico })β direct lookup of a Czech IΔO in the insolvency registersearch_person_insolvency({ ico?, rc?, dob?, firstname?, surname? })β find a person by IΔO, birth number, or name + DOBpoll_isir_events({ since })β append-only event feed for daily monitoring
@czagents/adis (3 tools)
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 datecheck_bulk_dph_payer({ icos[] OR dics[] })β batch up to 100 subjects (lighter response, status + accounts only)list_unreliable_payers()β full list of currently unreliable payers (50β100 MB, intended for daily mirroring)
@czagents/dd (12 tools)
person_companies({ name, birth_year? })β Czech VR companies connected to a person (free, anonymous)get_owners({ ico })β direct + upstream Czech VR ownership tree (free, anonymous)get_dd_report({ ico, depth })β unified ARES + sanctions + ISIR report with risk scorewatch_entity({ ico })β start free monitoring onboarding for one companyget_risk_score({ ico })β fast 0β100 score + top red flagsget_statutory_chain({ ico, max_depth })β surname-based statutory-body walk for shell-company unwindingdetect_nominee_director({ ico })β 3-indicator "white horse" director detection (Compliance tier+)detect_phoenix({ ico })β phoenix-company pattern detection (Compliance tier+)get_risk_timeline({ ico })β chronological company lifecycle/risk timeline (Compliance tier+)detect_address_crowding({ ico })β shell-firm "address hotel" detection (Compliance tier+)get_eu_dd_report({ lei OR name, country? })β EU DD report: GLEIF entity data + EU/OFAC sanctions check (Compliance tier+)get_eu_parent({ ico })β find EU/international parent via ARES β GLEIF LEI matching (Compliance tier+)
@czagents/eu-registry (3 tools)
search_company({ name, country?, limit? })β search non-Czech registries by company name across 16 countriesget_company({ id, country })β company record by national ID (CRN / IΔO / KRS / SIREN / LEI / VAT / β¦)lookup_company_by_vat({ vat })β free VIES VAT validity + name/address lookup
@czagents/payqr (6 tools)
qr_payment({ iban, bic?, amount?, ... })β payment QR (auto SPAYD for CZ/SK, EPC/GiroCode for other SEPA)qr_text({ text })β plain-text QRqr_wifi({ ssid, password?, security? })β Wi-Fi network QRqr_vcard({ name, phone?, email?, ... })β vCard 3.0 contact QRqr_read({ image_data })β decode + classify a QR code from a base64 imageqr_payment_batch({ payments[] })(paid; available when x402 is configured) β payment QRs for a whole invoice run in one call
@czagents/realestate (1 tool, free tier only)
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
What this is good for
A toolkit for compliance, KYC/AML, accounting and cross-border checks over Czech & EU registries:
- VAT & invoicing β verify VAT-payer status (ADIS) and convert at official ΔNB FX rates before booking.
- Counterparty screening β ARES identity, EU + OFAC sanctions, ISIR insolvency.
- Due diligence (flagship) β the
@czagents/ddaggregator combines the above into a risk score, statutory-chain / UBO walk, and EU-parent lookup. - Cross-border β company lookups across 16 EU registries (
@czagents/eu-registry).
Use a single-source server when you need just one dataset; use the due-diligence aggregator for combined, scored output.
Example prompts the aggregator handles well:
- 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."
- Vendor onboarding β "Run KYC on this prospective supplier and tell me if anything looks off. Use the full statutory chain."
- 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."
Score & validation
A/A/A on Glama (quality / security / license), claimed and maintained.
Listed in the official MCP registry
under DNS-verified namespace dev.cz-agents/*.
Further reading
- Building MCP servers for a country that isn't in the dataset β design rationale, gotchas (MOD11, ARES Swagger bugs), and how this pattern adapts MCP to non-English locales.
License
MIT Β© Martin Havel β see LICENSE