Cz Agents MCP Server

cz-agents-mcp

Model Context Protocol servers for Czech government & business data. Give your AI agent native access to ARES, ČNB, ISIR, sanctions screening, and a unified due-diligence aggregator.

Landing page: cz-agents.dev

Available servers

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" } }
  }
}

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" }
  }
}

Tools

@czagents/ares (9 tools)

• lookup_by_ico({ ico }) — full company record
• search_companies({ query, city, street, psc, nace, pocet }) — combined search
• search_by_address({ street, city, psc }) — all companies at an address
• search_by_nace({ nace, city }) — by CZ-NACE activity code
• get_statutaries({ ico }) — current statutory body (for due diligence)
• validate_dic({ dic }) — DIČ format + MOD11 checksum
• check_vat_payer({ ico }) — VAT registration + transparent accounts
• get_bank_accounts({ ico }) — DPH-published accounts
• get_history({ ico }) — previous names, address changes

@czagents/cnb (3 tools)

• get_rates({ date? }) — full daily FX sheet
• convert({ amount, from, to, date? }) — CZK-crossed conversion
• get_rate({ code, date? }) — single currency rate

@czagents/sanctions (5 tools)

• search_person({ name, dob?, nationality?, threshold? }) — fuzzy KYC screen against EU + OFAC
• search_entity({ name, country?, threshold? }) — entity / company screen
• check_ico({ ico, name? }) — direct lookup of a Czech IČO on sanctions lists
• get_listing({ id }) — full record by ${source}:${id}
• list_recent_updates({ since, source? }) — daily monitoring (added/removed/modified)

@czagents/isir (3 tools)

• check_ico_insolvency({ ico }) — direct lookup of a Czech IČO in the insolvency register
• search_person_insolvency({ ico?, rc?, dob?, firstname?, surname? }) — find a person by IČO, birth number, or name + DOB
• poll_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 date
• check_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 (3 tools)

• get_dd_report({ ico, depth }) — unified ARES + sanctions + ISIR report with risk score
• get_risk_score({ ico }) — fast 0–100 score + top red flags
• get_statutory_chain({ ico, max_depth }) — UBO / shell-company tree walk

What this is good for

The aggregator (@czagents/dd) was built for one specific recurring chore: checking new business partners before signing or paying. The kinds of prompts it handles well:

• KYC pre-invoice — "Before we send a 350 000 Kč invoice to IČO 27074358, 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."
• Bookkeeping triage — "For these 12 incoming invoices, screen each issuer's IČO against EU sanctions and active insolvency. Sort by risk."

The standalone packages (@czagents/ares, cnb, sanctions, isir) are thinner — useful when you only need one specific data source, or when you're building your own custom workflow on top.

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