Co znamená chyba tier_required?

Odpověď tier_required je tvar, kterým hostovaný nástroj EU registru nebo due-diligence MCP signalizuje, že požadavek je mimo váš tarif: buď potřebuje Extended pokrytí (zemi mimo free Core sadu), nebo DD+ hloubku (obohacenou due-diligence, ne základní lookup). Obsahuje pole dimension (coverage nebo depth) a upgrade_url směřující sem.

Můžu získat všechny země zdarma?

Ano, self-hostingem open-source serveru @czagents/eu-registry (MIT licence). Coverage gate platí jen pro hostovaný endpoint eu-registry.cz-agents.dev; self-hostovaný kód nemá žádné omezení zemí, i když u některých národních registrů potřebujete vlastní API klíč.

Jaký je rozdíl mezi coverage a depth?

Coverage určuje, které země patří do tarifu Core vs Extended. Depth určuje, jak hluboký due-diligence detail tarif zahrnuje u firmy, ke které se už dostanete (basic vs DD+ ddplus). Obě osy jsou nezávislé: Core země jako Česko je součástí free tarifu na vyhledání, a plný AML/DD report na ni je součástí placeného tarifu DD+.

Jak odemknu Extended pokrytí nebo DD+?

Předplaťte Compliance (99 €/měs) nebo Agency (199 €/měs) na stránce ceníku, nebo si vyžádejte 14denní zkušební token zdarma. Oba tarify odemykají Extended pokrytí i DD+ hloubku dohromady.

Ověření firmy v EU: pokrytí registru podle země a tarifu

cz-agents dává AI agentovi nebo skriptu jedno EU company registry API a MCP server pro vyhledání, lookup a ověření firmy napříč Evropou — národní registr tam, kde existuje, jinde GLEIF LEI lookup a identitu přes VIES VAT. Co je odemčené, řídí dvě nezávislá nastavení: coverage (které země) a depth (jak hluboký due-diligence detail).

Přišli jste sem z chyby tier_required? Tenhle tvar odpovědi signalizuje hranici na jedné ze dvou os níže. Pole dimension v chybě říká na které: "coverage" znamená, že daná země je součástí tarifu Extended; "depth" znamená, že samotný lookup je v pořádku, ale obohacený DD+ výsledek je součástí stejného tarifu. V obou případech odemyká Compliance nebo Agency oboje — viz ceník níže.

Coverage: Core vs Extended

Coverage určuje, které země patří do tarifu Core vs Extended pro hostované volání search_company / get_company / lookup_company_by_vat.

Tarif	Země	Plán
Core	GB · CZ · SK · PL · NL	Zdarma, hostováno, bez registrace
Extended	AT · BE · DE · DK · EE · ES · FI · FR · IT · LT · NO · SE	Compliance (99 €/měs) nebo Agency (199 €/měs)

Seznam pokrytí platný k 2026-07-22 — kopíruje živou tabulku country_policies, takže pole available_in_tier v samotné chybě tier_required je vždy autoritativní a aktuální; tahle stránka je jen jeho snímek.

Self-hosting open-source serveru @czagents/eu-registry (MIT) coverage gate úplně odstraní — gate platí jen pro hostovaný endpoint eu-registry.cz-agents.dev. GLEIF/LEI a VIES VAT lookupy jsou zdarma a bez klíče; u pár národních registrů potřebujete vlastní API klíč. Přesně který zdroj používá která země je na stránce EU registry MCP serveru.

Depth: basic vs DD+ (ddplus)

Depth je nezávislá na zemi — určuje, jak hluboký due-diligence detail tarif zahrnuje u firmy, ke které se už dostanete. Core země jako Česko je součástí free tarifu na vyhledání a ověření; obohacený AML/DD report na tu samou firmu je součástí placeného tarifu DD+.

Tarif	Zahrnuje	Plán
basic	Vyhledání a lookup firmy, ověření identity, VAT/VIES validace, základní české DD (ARES + sankce, bez statutárního řetězce)	Zdarma
ddplus	Mapování vlastnické sítě (ownership network), detekce nominee/phoenix, risk timeline, watchlist monitoring, bulk lookup	Compliance (99 €/měs) nebo Agency (199 €/měs)

Chyba tier_required v dimenzi depth vypisuje přesná jména zablokovaných nástrojů ve vlastním poli available_in_tier — kategorie výše jsou shrnutí, ne doslovný seznam.

DD+ je uzavřený hostovaný konektor — na rozdíl od coverage gate pro něj neexistuje self-host varianta.

Obě osy dohromady

Požadavek	Coverage	Depth	Plán
Vyhledání/ověření britské nebo české firmy	Core	basic	Zdarma, bez registrace
Vyhledání/ověření německé nebo španělské firmy	Extended	basic	Compliance/Agency
Plný AML/DD report na českou firmu (nominee, phoenix, timeline)	Core	ddplus	Compliance/Agency
Plný AML/DD report na německého partnera	Extended	ddplus	Compliance/Agency

Ceny a jak aktivovat

Ceny a plné srovnání funkcí/kvót jsou na stránce ceníku — tahle stránka čísla neduplikuje, aby se od ceníku nemohla rozjet. Ve zkratce:

Free — Core pokrytí, basic hloubka. Self-host na GitHubu, nebo hostované endpointy bez tokenu.
Compliance a Agency — oba odemykají Extended pokrytí i DD+ hloubku dohromady; Agency navíc přidává hlubší rekurzi propojených subjektů a watchlist monitoring. Předplaťte přes Stripe checkout na ceníku, nebo si vyžádejte 14denní zkušební token zdarma (bez platební karty).
Vlastní objem, fakturace nebo dotazy: e-mail na [email protected].

Tvar chyby tier_required

Když je požadavek mimo váš tarif, hostované MCP a REST endpointy jsou navržené vrátit strukturovanou chybu místo částečných dat nebo tichého selhání. Takhle vypadá ta chyba, až bude vynucování tarifů aktivní:

{
  "error": "tier_required",
  "dimension": "coverage",
  "required_tier": "extended",
  "country": "DE",
  "country_group": "extended",
  "available_in_tier": ["AT","BE","DE","DK","EE","ES","FI","FR","IT","LT","NO","SE"],
  "message": "Extended European coverage unlocks lookups for Germany and the rest of the Extended country group — activate it at https://cz-agents.dev/pricing.html.",
  "upgrade_url": "https://cz-agents.dev/pricing.html"
}

Tohle je tvar pro dimenzi coverage. Chyba v dimenzi depth má stejnou obálku, ale available_in_tier obsahuje jména ddplus nástrojů místo zemí.

Řekněte agentovi nebo skriptu, ať přestane nástroj volat, ukáže uživateli message a zkusí to znovu až po upgradu. upgrade_url teď vede na ceník; tenhle přehled pokrytí je z něj jeden klik.

FAQ

Co znamená chyba tier_required?: Odpověď tier_required je tvar, kterým hostovaný nástroj EU registru nebo due-diligence MCP signalizuje, že požadavek je mimo váš tarif: buď potřebuje Extended pokrytí (zemi mimo free Core sadu), nebo DD+ hloubku (obohacenou due-diligence, ne základní lookup). Pole dimension v chybě říká na které, a upgrade_url vede sem.
Můžu získat všechny země zdarma?: Ano, self-hostingem open-source serveru @czagents/eu-registry (MIT licence). Coverage gate platí jen pro hostovaný endpoint eu-registry.cz-agents.dev; self-hostovaný kód nemá žádné omezení zemí, i když u některých národních registrů potřebujete vlastní API klíč.
Jaký je rozdíl mezi coverage a depth?: Coverage určuje, které země patří do tarifu Core vs Extended. Depth určuje, jak hluboký due-diligence detail tarif zahrnuje u firmy, ke které se už dostanete (basic vs DD+ ddplus). Obě osy jsou nezávislé: Core země jako Česko je součástí free tarifu na vyhledání, a plný AML/DD report na ni je součástí placeného tarifu DD+.
Jak odemknu Extended pokrytí nebo DD+?: Předplaťte Compliance (99 €/měs) nebo Agency (199 €/měs) na stránce ceníku, nebo si vyžádejte 14denní zkušební token zdarma. Oba tarify odemykají Extended pokrytí i DD+ hloubku dohromady.