← QuantoNetto.Com

Documentación API y agentes

Los datos y cálculos están disponibles mediante API REST, servidor MCP remoto y herramientas WebMCP en la página. No se necesitan cuentas, claves API ni OAuth.

Servidor MCP

El servidor utiliza Streamable HTTP en https://quantonetto.com/api/mcp. No emite identificadores de sesión; sus herramientas son de solo lectura y las llamadas pueden repetirse. /.well-known/mcp/server-card.json describe las herramientas.

  • calculate_net_salary — Calcula el neto anual y la media por paga, con desglose y avisos.
  • search_comuni — Busca municipios y códigos catastrales Belfiore.
  • compare_comuni — Compara el neto entre municipios con los mismos datos.
  • get_rate_curve — Calcula una curva de salario neto y retención marginal.
  • get_relevant_questions — Identifica los datos que faltan y que afectan al resultado.
  • get_employer_cost — Devuelve una referencia parcial del coste empresarial.
  • get_tax_sources — Devuelve las fuentes de las reglas aplicadas.

Busca primero el municipio con search_comuni: las demás herramientas requieren el código catastral Belfiore. Usa get_relevant_questions para identificar solo los datos adicionales que afectan al resultado.

API REST

La especificación OpenAPI 3.1 de /openapi.json describe parámetros, respuestas y errores.

  • GET /api/comuni — Busca municipios por nombre, provincia, prefijo o código catastral.
  • GET /api/rules — Devuelve las reglas fiscales de un municipio.
  • GET /api/exchange-rates — Devuelve tipos BCE con fecha para comparar monedas.

Los errores siguen RFC 9457 problem+json, con un código estable y una sugerencia para corregir la solicitud. Las respuestas incluyen API-Version. Los cambios incompatibles requieren una nueva versión fechada; la anterior se mantiene al menos seis meses con cabeceras Sunset y Deprecation.

Reproducir el cálculo

El paquete de /api/rules incluye tramos, deducciones, perfiles INPS, reglas locales y huellas de los datos. El mismo motor y los mismos datos de entrada reproducen el resultado.

Comprueba regional.status y municipal.status: carryover indica una estimación con datos anteriores; partial exige revisión; unpublished indica un impuesto excluido. Conserva los avisos junto con cada resultado.

WebMCP en el navegador

La página registra herramientas mediante document.modelContext. Las herramientas de lectura devuelven el cálculo visible; las de escritura actualizan formulario, desglose, gráfico y dirección. Para integraciones fuera de la página utiliza el servidor MCP remoto.

Descubrimiento de recursos

Límites y uso

Respeta Cache-Control y, ante una respuesta 429, Retry-After. La red de distribución puede limitar tráfico abusivo. Los GET y las herramientas MCP de lectura pueden repetirse sin modificar el estado.

Ámbito: empleo y ejercicio fiscal 2026. Los resultados son estimaciones orientativas; presenta siempre las hipótesis y los avisos junto con cada cifra.

Versión Markdown