Self-hosted bridge between web platforms and AI assistants (MCP + OpenAPI). Exposes a unified tool registry through REST, OpenAPI, and the Model Context Protocol.
Keryx provides 4 tools with explicit Zod schemas and descriptions in Serbian. Naming follows verb_noun convention (create_shortcut, gateway_status, echo, site_stats). Schemas are well-structured with validation (URL format, token regex, enum methods). However, descriptions lack LLM-optimization guidance (e.g., 'when to use', prerequisites), parameter descriptions are minimal, and error handling lacks recovery guidance. create_shortcut has strong input validation but no documented output schema. gateway_status handler throws 'not wired', incomplete implementation. No tool annotations (readOnlyHint/destructiveHint). Descriptions average ~120 chars (within baseline 194), but lack actionable context for agent selection.
Generiše Apple `.shortcut` fajl koji poziva zadati HTTPS URL sa ciljnim Bearer tokenom. Download link je kratak, nasumičan i može se iskoristiti samo jednom.
Vraća prosleđenu poruku; koristi se za testiranje konekcije.
Vraća osnovne informacije o Keryx gateway-u i listu trenutno registrovanih alata.
Dohvata JSON sa konfigurisanog SITE_STATS_URL endpointa i prosleđuje caller token. Upstream servis sam određuje korisnički scope i prava pristupa.
gateway_status handler throws 'not wired', tool is non-functional. Implementation incomplete.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). create_shortcut is destructive (WRITE risk) but unmarked; echo and site_stats are read-only but unmarked.
Descriptions lack LLM-optimization: no 'when to use' guidance, no prerequisites, no recovery hints. E.g., site_stats says 'Upstream servis sam određuje...' but doesn't explain when to call it or what to do if SITE_STATS_URL is unset.
create_shortcut output schema documented in responseExample but not in formal schema definition. LLM cannot parse expected fields from tool definition alone.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Error messages lack recovery guidance. E.g., 'site_stats nije konfigurisan' tells agent nothing about next steps. Should suggest 'Set SITE_STATS_URL environment variable' or 'Contact admin'.