Aruba Fatture MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARUBA_PASSWORD | Yes | Password del servizio | |
| ARUBA_USERNAME | Yes | Username del servizio Fatturazione Elettronica | |
| ARUBA_ENVIRONMENT | No | demo (default) oppure production | demo |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_user_infoA | Restituisce le informazioni dell'account Aruba Fatturazione Elettronica: partita IVA, codice fiscale, stato del servizio, spazio di conservazione utilizzato. |
| search_invoicesA | Cerca fatture elettroniche inviate (ciclo attivo) o ricevute (ciclo passivo) su Aruba Fatturazione Elettronica, filtrando per periodo, stato, tipo documento e controparte. Risultati paginati. NOTA: richiede un'utenza Premium (o delega da Premium); con utenza base risponde 401 per mancanza di deleghe. |
| get_invoice_detailA | Restituisce i metadati completi di una singola fattura (mittente, destinatario, stato, notifiche SDI). Identificarla con uno tra id, filename o idSdi. Per scaricare XML/PDF/ZIP usare download_invoice. |
| download_invoiceB | Scarica una fattura su disco nel formato scelto: xml (il file fattura originale), pdf (versione leggibile), zip (fattura + notifiche SDI), pdd (pacchetto di distribuzione della conservazione, disponibile solo se pddAvailable=true nel dettaglio). |
| send_invoiceA | Carica una fattura elettronica XML su Aruba per l'invio al Sistema di Interscambio (SDI). ATTENZIONE: con dryRun=false la fattura viene inviata realmente a SDI. Per default dryRun=true: il file viene solo validato, senza invio. Il file XML deve indicare come trasmittente l'intermediario Aruba (IdTrasmittente 01879020517). Fornire il file tramite xmlFilePath (consigliato) oppure xmlContent. |
| get_invoice_notificationsA | Restituisce le notifiche SDI di una singola fattura a partire dal nome file (es. ricevuta di consegna, scarto, mancata consegna). Funziona anche con utenza base: è il modo per tracciare lo stato di una fattura inviata via API (il filename è restituito da send_invoice come uploadFileName). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a clearly distinct purpose: account info, searching, detail retrieval, downloading, sending, and notifications. The overlap between get_invoice_detail and get_invoice_notifications is minimal since one returns metadata while the other returns SDI notifications. download_invoice is clearly distinguished from get_invoice_detail by its download focus.
Tools follow a consistent verb_noun pattern: get_user_info, search_invoices, get_invoice_detail, download_invoice, send_invoice, get_invoice_notifications. The verbs (get/search/download/send) are consistent and descriptive. Minor stylistic inconsistency exists in user_info (underscore) vs invoice tools being all snake_case but readable.
Six tools is a well-scoped set for an e-invoicing service covering the core lifecycle. Not overly heavy or thin for the domain, though a few more could be expected (e.g., managing uploads or listing all uploads), but this feels within reason.
The set covers the core invoicing workflow: retrieving user info, searching, getting details, downloading files, sending, and checking notifications. Minor gaps exist—there's no tool to manage/update the account, cancel invoices, or list uploads as a whole—but the essential active/passive cycle workflows are covered.