LLM-first design system for the Italian public sector (AgID/Bootstrap Italia): a single machine-readable spec generates universal web components, an MCP server, llms.txt and validation so AI assistants produce compliant, accessible UIs
Server exposes 8 well-named, read-only tools for a design system (Bootstrap Italia). All tools follow verb_noun naming (list_*, get_*, search_*) and have descriptions. However, parameter descriptions are minimal or missing entirely, and output schemas are not documented in the code. Tool descriptions are adequate (100-200 chars) but lack actionable guidance on when to use each tool vs. alternatives. No error handling guidance visible. The server is functional but lacks the rigor expected of production-grade agent tools.
Restituisce le regole di accessibilità trasversali da rispettare in ogni interfaccia PA. Consulta questo tool prima di consegnare una UI.
Restituisce il markup conforme e le note di accessibilità di un componente Bootstrap Italia dato il suo id.
Restituisce lo scheletro completo e conforme di una pagina PA (es. pagina di un servizio comunale), componendo header, breadcrumb, contenuto e footer con i link obbligatori.
Restituisce la documentazione completa di un Web Component universale (props, accessibilità incapsulata, esempio di utilizzo).
Elenca i componenti Bootstrap Italia disponibili (id, nome, categoria). Usa questo tool per scoprire cosa esiste prima di generare una UI PA.
Elenca le ricette di pagina conformi ai modelli di sito PA (Comuni, Scuole, Sanità). Una ricetta compone più componenti in una pagina intera.
Output schemas not documented. Tools return complex objects (Component, Recipe, WebComponent) but the code does not expose structured output schemas to the MCP client. LLMs cannot plan downstream operations or extract fields reliably.
Parameter descriptions are minimal. 'category' in list_components has a description, but 'query' in search_component lacks guidance on what keywords work best. 'topic' in get_accessibility_rules lists examples but does not explain the filtering behavior.
No pagination or result limits documented. list_components and list_recipes may return large datasets. No limit, offset, or cursor parameters visible. LLMs cannot control result size, risking context window exhaustion.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Elenca i Web Components universali AI-first (funzionano in React, Vue, Angular, HTML puro). L'accessibilità è già incapsulata: preferisci SEMPRE questi tag ai markup grezzi quando il progetto può caricarli.
Cerca un componente Bootstrap Italia per parola chiave (nome, descrizione, tag). Usa questo tool quando devi realizzare un elemento di UI e non conosci l'id esatto.
No error handling guidance. If a component ID is invalid or a recipe does not exist, the code does not show how errors are communicated or what the LLM should do next (retry, search, ask user).
Tool descriptions lack discovery guidance. No hint on when to call list_components vs. search_component, or when to use get_component_code vs. get_page_recipe. LLMs must infer intent from names alone.