Server MCP per le API di Aruba Fatturazione Elettronica
Server has 13 tools with mostly complete schemas and descriptions. Naming follows verb_noun convention (get_, search_, list_, upload_, generate_). Descriptions are present and substantive (avg ~120 chars). However, several critical gaps: (1) Many parameters lack type constraints, e.g., 'status' in search_invoices is a free-form string instead of enum; (2) Output schemas are not documented, callers don't know what fields to expect; (3) Error handling is generic (ArubaApiError/PanelError caught but recovery guidance is minimal); (4) Some tools accept overlapping parameters (id, filename, idSdi) without clear mutual-exclusivity guidance; (5) Tool descriptions lack WHEN-to-use context and prerequisites. Baseline: 549 production tools average 18-char names (this server: 10-24 chars ✓), 194-char descriptions (this server: ~120 chars, slightly short), 100% of A+ tools have param descriptions (this server: ~85% coverage).
Scarica una fattura dall'archivio locale e la salva su file
Genera una fattura XML FatturaPA da dati strutturati
Scarica una fattura specifica (XML o PDF)
Restituisce i dettagli completi di una fattura dall'archivio locale
Legge le notifiche di consegna/scarto/rifiuto per le fatture
Restituisce le informazioni dell'account Aruba
Andamento temporale delle fatture (per mese, trimestre o anno)
Output schemas not documented. Tools return JSON but callers don't know field names, types, or structure. Breaks downstream tool chaining and forces LLMs to guess field names.
Free-form string parameters should be enums. 'status' in search_invoices accepts arbitrary strings instead of documented enum (1=presa_in_carico, 2=errore, etc.). 'documentType' similarly unconstrained. Invites hallucinated values.
Overlapping identifier parameters (id, filename, idSdi) lack mutual-exclusivity guidance. Descriptions don't state which is required, which are optional, or if only one should be provided. LLMs may pass multiple conflicting values.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
Elenca le controparti (clienti/fornitori) con statistiche aggregate
Elenca le fatture caricate in archivio con filtri opzionali
Carica un archivio locale di fatture (XML, P7M, ZIP) per analisi offline
Ricerca fatture (inviate o ricevute) con filtri avanzati
Carica una fattura XML verso il Sistema di Interscambio (SDI)
Prospetto IVA: aggregazione per aliquota di vendite, acquisti e saldo
Error handling is generic. ArubaApiError and PanelError are caught and returned as text, but no recovery guidance. LLM doesn't know if error is retryable, user-fixable, or fatal.
generate_invoice accepts 'cedente' and 'cessionario' as bare objects without schema. No field documentation. LLM cannot know what properties to include (denominazione, partitaIva, indirizzo, etc.).