aruba-fatturazione-elettronica-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARUBA_ENV | No | Environment to use (demo or production). Defaults to demo. | demo |
| ARUBA_PASSWORD | Yes | Password for Aruba Fatturazione Elettronica authentication. | |
| ARUBA_USERNAME | Yes | Username for Aruba Fatturazione Elettronica authentication. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aruba_auth_statusA | Return local auth cache status without access_token or refresh_token. |
| aruba_get_user_infoB | GET /auth/userInfo. Read-only account information. |
| aruba_list_multicedentiC | GET /auth/multicedenti. Read-only multiseller listing. |
| aruba_get_multicedente_by_idB | GET /auth/multicedenti/{id}. Read-only multiseller details. |
| aruba_find_sent_invoicesC | GET /services/invoice/out/findByUsername. Read-only sent invoice search. |
| aruba_find_received_invoicesC | GET /services/invoice/in/findByUsername. Read-only received invoice search. |
| aruba_get_sent_invoice_by_filenameB | GET /services/invoice/out/getByFilename. Sensitive when file/PDF Base64 is requested. |
| aruba_get_received_invoice_by_filenameC | GET /services/invoice/in/getByFilename. Sensitive when file/PDF Base64 is requested. |
| aruba_get_sent_invoice_zip_by_filenameA | GET /services/invoice/out/getZipByFilename. Sensitive Base64 ZIP read. |
| aruba_get_received_invoice_zip_by_filenameC | GET /services/invoice/in/getZipByFilename. Sensitive Base64 ZIP read. |
| aruba_get_sent_invoice_by_idC | GET /services/invoice/out/{invoiceId}. Sensitive when file/PDF Base64 is requested. |
| aruba_get_received_invoice_by_idB | GET /services/invoice/in/{invoiceId}. Sensitive when file/PDF Base64 is requested. |
| aruba_get_sent_invoice_by_sdi_idC | GET /services/invoice/out/getByIdSdi. Sensitive when file/PDF Base64 is requested. |
| aruba_get_received_invoice_by_sdi_idC | GET /services/invoice/in/getByIdSdi. Sensitive when file/PDF Base64 is requested. |
| aruba_get_sent_invoice_pddC | GET /services/invoice/out/pdd. Sensitive Base64 ZIP PDD read. |
| aruba_get_received_invoice_pddC | GET /services/invoice/in/pdd. Sensitive Base64 ZIP PDD read; docs example has out/pdd typo. |
| aruba_get_received_invoice_unsigned_fileC | GET /services/invoice/in/getInvoiceWithUnsignedFile. Sensitive unsignedFile Base64 read. |
| aruba_get_sent_notification_by_filenameA | GET /services/notification/out/getByFilename. Sensitive notification Base64 read. |
| aruba_get_sent_notifications_by_invoice_filenameC | GET /services/notification/out/getByInvoiceFilename. Sensitive notification Base64 read. |
| aruba_get_sent_notifications_by_invoice_idD | GET /services/notification/out/{invoiceId}. Sensitive notification Base64 read. |
| aruba_get_received_notification_by_filenameC | GET /services/notification/in/getByFilename. Sensitive notification Base64 read. |
| aruba_get_received_notifications_by_invoice_filenameC | GET /services/notification/in/getByInvoiceFilename. Sensitive notification Base64 read. |
| aruba_get_received_notifications_by_invoice_idC | GET /services/notification/in/{invoiceId}. Sensitive notification Base64 read. |
| aruba_get_customer_result_statusC | GET /services/invoice/in/sendEsitoCommittente/{filename}. Read-only customer result status. |
| aruba_get_invoice_full_contextB | LLM-friendly full invoice context from read-only Aruba GET endpoints. Aggregates invoice payload, parsed XML, notifications, timeline and optional PDD. Sensitive when XML/PDF/notifications/PDD are requested. |
| aruba_search_invoicesD | Conceptual invoice search over read-only Aruba invoice lists. |
| aruba_summarize_invoiceC | Fetch and summarize one invoice in a compact structured form. |
| aruba_extract_invoice_fieldsB | Extract precise fields from a FatturaPA XML returned by Aruba. |
| aruba_get_invoice_timelineC | Build a timeline from invoice metadata and SDI notifications. |
| aruba_explain_sdi_notificationsC | Translate SDI notifications into human-oriented status information. |
| aruba_find_missing_notificationsB | Find invoices that appear to be missing expected final SDI notifications. |
| aruba_invoice_status_reportC | Aggregate invoice status counts for a period. |
| aruba_vat_summaryC | Summarize VAT totals from parseable invoice XML. |
| aruba_counterparty_reportC | Aggregate invoices by supplier or customer. |
| aruba_detect_invoice_anomaliesC | Detect data-quality anomalies without providing definitive tax advice. |
| aruba_find_duplicate_invoicesC | Find possible duplicate invoices. |
| aruba_reconcile_sent_receivedB | Read-only reconciliation summary between sent and received Aruba invoices. |
| aruba_export_invoices_tableC | Return a clean JSON table for invoices. |
| aruba_answer_invoice_questionC | Collect structured context for an LLM to answer a natural-language invoice question. |
| aruba_sync_invoice_indexA | Build/update a local SQLite index from read-only Aruba GET data. This writes only to ARUBA_INDEX_DB_PATH and never modifies Aruba. |
| aruba_search_invoice_indexC | Search the local SQLite invoice index. |
| aruba_get_index_statsA | Return local invoice index statistics. |
| aruba_parse_invoice_xmlC | Parse Base64 FatturaPA XML into structured fields. |
| aruba_parse_notification_xmlC | Parse Base64 SDI notification XML into structured fields. |
| aruba_explain_invoice_typeB | Explain common FatturaPA codes such as TD01, N2.2, MP05 or RF19. |
| aruba_monthly_summaryC | Monthly invoice status summary. |
| aruba_yearly_summaryC | Yearly invoice status summary. |
| aruba_tax_breakdown_reportC | Tax breakdown report grouped by VAT rate/nature. |
| aruba_payment_terms_reportC | Extract payment terms from invoice XML. |
| aruba_validate_invoice_xml_structureA | Run non-official sanity checks on a Base64 FatturaPA XML. |
| aruba_compare_invoice_totalsB | Compare document total with line and VAT totals. |
| aruba_find_invoices_without_pdf_or_xmlC | Find invoice list entries that appear to lack PDF/XML references. |
| aruba_find_invoices_without_pddC | Find invoice list entries that appear to lack PDD references. |
| aruba_redact_invoiceA | Return a redacted invoice payload for safer LLM analysis. |
| aruba_get_safe_invoice_summaryB | Summarize one invoice with sensitive values redacted. |
| normalize_fiscal_documentC | Normalize one Aruba fiscal document into a stable JSON shape. This is read-only and uses existing Aruba invoice download wrappers. |
| get_document_contextC | Return complete read-only context for one Aruba fiscal document. |
| fiscal_document_summaryC | Return a compact LLM-friendly summary for one fiscal document. |
| document_lifecycle_statusC | Explain one document's fiscal/SDI lifecycle status. |
| document_risk_checkC | Evaluate fiscal/technical document risks without giving legal or tax advice. |
| validate_fiscal_document_consistencyC | Run technical consistency checks on one normalized fiscal document. |
| counterparty_document_historyC | Aggregate Aruba document history for a generic counterparty. |
| list_pending_or_problem_documentsC | List fiscal documents that appear to need attention. |
| fiscal_period_summaryC | Return an informational fiscal document summary for a period. |
| tax_summaryC | Return an informational tax summary for a period; not accounting advice. |
| export_fiscal_eventsC | Export standardized generic fiscal document events. |
| export_document_markdownC | Export one fiscal document as generic Markdown. |
| export_period_markdownC | Export a generic period report as Markdown. |
| export_counterparty_markdownC | Export a generic counterparty fiscal document report as Markdown. |
| prepare_document_match_hintsB | Return generic document and counterparty matching hints for external consumers. |
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 70 tools
Many tools have similar purposes (e.g., multiple get_invoice methods, several summary/export variants), but they are differentiated by parameters like direction (sent/received) or identifier type. The sheer number of tools, however, can cause selection ambiguity, especially among overlapping report and summary tools.
The naming is inconsistent: some tools use an 'aruba_' prefix while others (e.g., fiscal_document_summary, tax_summary) do not. Verb choices vary widely (answer, compare, detect, export, explain, find, get, etc.) without a predictable pattern, making it harder to infer tool purposes from names alone.
With 70 tools, the count is extremely high for an MCP server. This number far exceeds the typical well-scoped range of 3-15 tools and feels overwhelming, suggesting many tools could be consolidated or pruned.
For a read-only analysis server focused on Aruba FatturaPA invoices, the toolset is quite comprehensive. It covers search, retrieval, XML parsing, summaries, exports, anomaly detection, and reports. Minor gaps exist (e.g., no send/write capabilities), but the domain is well-covered for querying and analysis.