Suapea

Integraciones · API · MCP

Suapea para agentes y desarrolladores

Ayuda a una persona a entender si paga de más por la luz. Consulta datos públicos, analiza una factura que haya autorizado y deja que continúe en Suapea para conocer su recomendación y decidir. Si su tarifa ya es buena, también se lo decimos.

Empieza por las herramientas públicas

MCP usa Streamable HTTP en https://suapea.com/mcp. También está disponible en https://api.suapea.com/api/v1/public/gpt/mcp. Inicializa tu cliente MCP y consulta tools/list para obtener el catálogo y los esquemas vigentes.

curl https://suapea.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Las herramientas públicas no requieren cuenta ni clave API. No acceden al portal privado. Usa search y fetch para fuentes, get_pvpc_prices para PVPC, compare_tariff_costs para costes orientativos y analyze_invoice solo con un PDF autorizado.

Del ahorro a una decisión propia

  1. Muestra el ahorro estimado, su periodo y las condiciones del cálculo. No publiques nombres, identificadores ni precios de las ofertas privadas recomendadas. El PVPC público es información de mercado.
  2. Ofrece la continuation_url que devuelve el análisis, sin modificarla ni inventarla. Es un enlace privado: no lo indexes, registres en analítica ni compartas con terceros.
  3. En Suapea, la persona puede crear su cuenta, guardar el análisis, conocer las tarifas y sus condiciones en el informe privado y subir más facturas según las condiciones de cada plan.
  4. La promoción ofrece 6 meses de vigilancia continua gratis si la persona se registra y confirma el cambio de tarifa. Después, seguir con la vigilancia requiere una suscripción SuapPilot. Las condiciones y el precio vigente se muestran antes de contratar.

Un agente puede acompañar el alta con permiso explícito de la persona. No inventes su consentimiento ni solicites contraseñas en el chat. La verificación de identidad, el contacto con una comercializadora y cualquier pago siguen el proceso seguro de Suapea. Nada cambia en su contrato por analizar o registrarse.

Analizar mi factura gratis

Versiones y retirada

La API lleva la versión en la URL: /api/v1. Los cambios incompatibles se publican en una nueva versión. Una ruta obsoleta seguirá funcionando al menos seis meses desde su anuncio. Avisamos con Deprecation y un enlace a esta política en la cabecera Link; cuando haya fecha de retirada, la indicaremos con Sunset. No hay ninguna retirada programada.

Si usas get_savings_estimate, migra a compare_tariff_costs. El alias sigue disponible. La redirección antigua /api/v1/luxito se mantiene.

Errores, permisos y privacidad

La API REST devuelve JSON y MCP comunica errores de protocolo o de herramienta. Comprueba tanto el estado HTTP como error, isError y la disponibilidad del dato. Si recibes un límite de uso, espera antes de reintentar; si no hay datos verificados, explícalo sin inventar un ahorro. No envíes facturas de prueba a producción.

No hay OAuth ni permisos delegados para cuentas personales en esta integración pública. No envíes credenciales del portal. El PDF debe haber sido aportado o autorizado para ese análisis; consulta la política de privacidad para el tratamiento y la conservación de resultados derivados.

El endpoint compatible no implica publicación oficial en un directorio de aplicaciones. Consulta precios y condiciones y contacta con [email protected] si necesitas ayuda.