← QuantoNetto.Com

Documentazione API e agenti

I dati e i calcoli sono disponibili tramite API REST, server MCP remoto e strumenti WebMCP nella pagina. Non servono account, chiavi API o OAuth.

Server MCP

Il server usa Streamable HTTP all’indirizzo https://quantonetto.com/api/mcp. Non emette identificativi di sessione; gli strumenti sono di sola lettura e le chiamate possono essere ripetute. La scheda /.well-known/mcp/server-card.json descrive gli strumenti.

  • calculate_net_salary — Calcola il netto annuo e medio per mensilità, con dettagli e avvisi.
  • search_comuni — Cerca comuni e codici catastali Belfiore.
  • compare_comuni — Confronta il netto in più comuni con gli stessi dati.
  • get_rate_curve — Calcola una curva di netto e trattenuta marginale.
  • get_relevant_questions — Individua le informazioni mancanti che incidono sul risultato.
  • get_employer_cost — Restituisce un riferimento parziale per il costo aziendale.
  • get_tax_sources — Restituisce le fonti delle regole applicate.

Cerca prima il comune con search_comuni: gli altri strumenti richiedono il codice catastale Belfiore. Usa get_relevant_questions prima di chiedere informazioni aggiuntive, per individuare solo quelle che incidono sul risultato.

API REST

La specifica OpenAPI 3.1 in /openapi.json descrive parametri, risposte e modello degli errori.

  • GET /api/comuni — Cerca comuni per nome, provincia, prefisso o codice catastale.
  • GET /api/rules — Restituisce le regole fiscali per un comune.
  • GET /api/exchange-rates — Restituisce tassi BCE datati per il confronto in altre valute.

Gli errori seguono RFC 9457 problem+json, con codice stabile e suggerimento per correggere la richiesta. Le risposte riportano API-Version. Le modifiche incompatibili richiedono una nuova versione datata; la precedente resta disponibile per almeno sei mesi con intestazioni Sunset e Deprecation.

Riprodurre il calcolo

Il pacchetto restituito da /api/rules comprende scaglioni, detrazioni, profili INPS, regole locali e impronte dei dati. Lo stesso motore con gli stessi input riproduce il risultato.

Controlla regional.status e municipal.status: carryover indica una stima con dati precedenti; partial richiede verifica; unpublished indica un’imposta esclusa. Conserva sempre gli avvisi insieme al risultato.

WebMCP nel browser

La pagina registra gli strumenti tramite document.modelContext. Gli strumenti di lettura restituiscono il calcolo visibile; quelli di scrittura aggiornano input, prospetto, grafico e indirizzo. Per integrazioni fuori dalla pagina usa il server MCP remoto.

Scoperta delle risorse

Limiti e uso delle risorse

Rispetta Cache-Control e, in caso di risposta 429, Retry-After. La rete di distribuzione può limitare traffico abusivo. Gli endpoint GET e gli strumenti MCP di lettura possono essere ripetuti senza effetti sullo stato.

Ambito: lavoro dipendente e periodo d’imposta 2026. I risultati sono stime per orientarsi; le ipotesi e gli avvisi devono accompagnare ogni cifra presentata a un utente.

Versione Markdown