Official MCP server for integration with Fatture in Cloud API. Provides tools for managing invoices, payments, clients, expenses, analytics, company info, reminders, products, quotes, and cashbook operations.
Server has 8 tools with consistent naming (verb_noun pattern: get_*) and Italian descriptions. All tools are READ_ONLY analytics/reporting. Schemas are present but minimal, most parameters lack type constraints (no enums, no min/max bounds). Descriptions are adequate (50-150 chars) but lack actionable guidance on when to use each tool vs. alternatives. No error handling guidance, no output schema documentation, no parameter validation rules stated. Tool composition is sound (single responsibility), but parameter descriptions are generic ('Data inizio periodo' without format examples). Missing: pagination guidance for list tools, output field documentation, recovery hints for common failures.
Prima nota (cashbook): movimenti di entrata/uscita per periodo con riepilogo per tipo (fattura emessa/ricevuta, F24, ricevuta, movimento manuale) e per conto. Serve per quadrare i flussi di cassa reali con fatture e costi del personale. Read-only. Richiede scope cashbook:r.
Tutte le fatture per un cliente specifico con riepilogo
Lista clienti con filtro opzionale per nome
Elenco F24 registrati (contributi, ritenute, imposte) via REST grezzo. Usa la REST diretta perche' il modello SDK `ListF24ResponseAggregatedData` non deserializza la risposta reale (errore di validazione pydantic).
Conti di pagamento configurati (conti correnti, carte, cassa) con ID e IBAN. Read-only.
No parameter type constraints (enums, min/max, patterns). Parameters like 'type' in get_cashbook_entries accept free-form strings ('in', 'out', 'all') but lack enum declaration. LLMs will hallucinate invalid values.
Output schemas not documented. Tools return data but LLMs cannot plan downstream calls without knowing response field names and types. E.g., get_clients returns what fields? client_id, client_name, email?
Parameter descriptions lack format/constraint guidance. 'Data inizio periodo (YYYY-MM-DD)' is stated but no validation rules, no examples of valid ranges, no guidance on defaults. LLMs cannot infer whether '2020-01-01' is valid or if there's a lookback limit.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Fatturato per cliente ordinato per importo
Fatturato mensile aggregato per anno
Statistiche annuali complete
No error handling guidance. Tools lack recovery hints. E.g., if get_clients returns empty, should LLM try a broader search? If get_client_invoices fails, what's the fallback?
Pagination not documented. get_clients and get_client_invoices accept 'limit' but no mention of offset/cursor, total count, or whether results are sorted. Large result sets risk context window exhaustion.