Referenční no-secret MCP connector nad ARES (R1-WP06). FastMCP Streamable HTTP server nad veřejným ARES REST API pro vyhledávání ekonomických subjektů bez vyžadování přihlašovacích údajů.
ARES MCP demonstrates solid definition quality with complete input schemas, clear descriptions in Czech, and proper parameter typing. All 8 tools have documented schemas with type constraints (string, integer). Descriptions are domain-specific and contextual (avg ~120 chars), explaining what data each registry returns. However, descriptions lack explicit guidance on WHEN to use each tool vs alternatives, and output schemas are not formally documented in the tool definitions themselves. Error handling is present but minimal, no recovery guidance or actionable error messages visible. Tool naming follows a consistent pattern (ares_subjekt_*) but lacks action verbs (lookup/search are present but inconsistent). No tool annotations (readOnlyHint, destructiveHint) despite all being READ_ONLY operations.
Standardizuje adresu podle RÚIAN (Registr územní identifikace, adres a nemovitostí). Vrací seznam možných adres s kódy.
Vrací položky ARES číselníku (např. PravniForma, DruhZarizeni). Umožňuje překlad kódů z odpovědí ostatních nástrojů na lidské názvy.
Vyhledá ekonomický subjekt podle IČO v ARES. Vrací základní údaje: obchodní jméno, právní formu, sídlo, NACE kódy a seznam registrů s aktivním záznamem.
Vrací data z Národního registru poskytovatelů zdravotních služeb: zdravotnická zařízení a pracoviště subjektu. Bez osobních údajů.
Vrací data z Registru ekonomických subjektů (RES): NACE kódy a kategorii počtu zaměstnanců.
Vrací data ze Živnostenského rejstříku: aktuální živnosti a provozovny subjektu. Bez osobních údajů.
Tool naming lacks consistent action verbs. Mix of 'lookup' (ares_subjekt_lookup) and 'vyhledat' (search in Czech) creates ambiguity. LLMs cannot reliably distinguish when to use lookup vs vyhledat vs vr/rzp/res variants without explicit WHEN guidance in descriptions.
Output schemas not formally documented in tool definitions. Code shows Pydantic models (SubjektResult, AdresaSeznamResult, etc.) but these are not exposed in the tool schema visible to LLMs. LLMs cannot plan downstream operations without knowing what fields to expect.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | <=2025-11-25 | v2 |
Vrací data z Veřejného (obchodního) rejstříku pro dané IČO: aktuální statutáře a předmět podnikání. Obsahuje osobní údaje (jména fyzických osob z veřejného rejstříku).
Vyhledá ekonomické subjekty podle volného textu (obchodní jméno, sídlo, DIČ). Vrací stránkovaný seznam s možností filtrování a řazení.
No tool annotations despite all tools being READ_ONLY. FastMCP supports readOnlyHint annotation, applying it would signal to LLMs that these tools are safe to call without confirmation and can be retried freely.
Descriptions lack WHEN guidance. Each tool description states WHAT it returns but not WHEN to call it vs similar tools. E.g., ares_subjekt_lookup (by IČO) vs ares_subjekt_vyhledat (by text) distinction is not explained in descriptions, LLMs must infer from parameter names.
Error handling not visible in tool definitions. Code shows timeout (5s) and retry policy (max_attempts=1) but no error recovery guidance. If ARES returns 404 or validation error, LLM receives no actionable next step.