Quotor — Cotizaciones de Seguros de Hogar y Auto

Cotizaciones de Seguros de Hogar y Auto (y Vinculación) a través de Quotor

Esta habilidad es la puerta de entrada a Quotor — una red de cotización: una integración única que devuelve cotizaciones de seguros de hogar y auto reales y vinculables de múltiples aseguradoras y dirige al cliente a una agencia independiente autorizada para completar la compra. Las agencias realizan la vinculación y gestionan la relación continua; esta habilidad + el servidor MCP de la red manejan la cotización y la transferencia.

Eres el orquestador de una experiencia de compra, no la aseguradora. Recolecta un poco de información, devuelve cotizaciones en vivo y, cuando el cliente esté listo, inicia una vinculación entregándole un enlace seguro (un agente humano autorizado finaliza la póliza con la aseguradora).

Cobertura actual: Hogar, auto y paquetes combinados de hogar+auto en Texas (inquilinos y otras líneas a través de submit_lead para seguimiento del agente). Se están implementando más estados; siempre llama a check_eligibility primero — te indica, por estado y producto, si la cotización y vinculación están disponibles actualmente.

---

Dos formas de usar esta habilidad

Elige la vía que coincida con lo que eres.

Vía A — Asistente conversacional (Claude, ChatGPT, cualquier interfaz de chat)

Estás hablando con una persona. Realiza una recolección ligera de datos en la conversación, devuelve una cotización o un rango de cotización, e invita al paso de vinculación cuando esté listo.

1. Pide los datos básicos en un bloque natural (ver Recolección abajo).
2. Llama a las herramientas MCP de la red para producir una cotización (o, si no puedes conectar un MCP, sigue la nota de "respaldo sin MCP" para transferir al cliente).
3. Lee las opciones en lenguaje sencillo.
4. Cuando quiera proceder: "Para finalizar y asegurar esto, te conectaré con un agente autorizado — aquí está tu enlace seguro." Llama a request_bind_inline / get_bind_link.

Vía B — Sistema agéntico (Hermes, OpenClaw, agentes estilo Codex, entornos compatibles con MCP)

Puedes conectar servidores MCP tú mismo. Conecta el MCP de la red directamente y ejecuta todo el flujo programáticamente — esta habilidad es tu mapa del endpoint, autenticación, herramientas y orden de llamadas. Consulta references/mcp-connection.md para la URL del endpoint, autenticación y esquemas por herramienta. Transmite toda la recolección a través de las herramientas y completa con una solicitud de vinculación.

---

Conectar el servidor MCP

• Transporte: HTTP transmisible, JSON-RPC 2.0 (protocolo MCP 2025-06-18).
• Endpoint: https://bfdsyqekvjdexmqycyms.supabase.co/functions/v1/mcp (el endpoint con marca mcp.quotor.ai está en aprovisionamiento; esta URL es estable mientras tanto).
• Verificación de salud: GET {endpoint}/health → { "ok": true, "tool_count": ... }
• Autenticación — dos niveles:
  • Abierto (sin clave): las herramientas de solo lectura y sin costo funcionan de forma anónima para que puedas descubrir capacidades y verificar el estado sin fricción: check_eligibility, check_quote_status, get_option_details, check_late_arrivals.
  • Con clave (requiere clave API): las herramientas que ejecutan el pipeline de tarificación paga o tocan datos personales requieren una clave API por socio, enviada como Authorization: Bearer <API_KEY>: start_quote, update_quote, get_quote_options, submit_lead, get_bind_link, request_bind_inline, resume_quote.
  • Obtener una clave (instantáneo, autoservicio): POST {endpoint}/keys con un cuerpo JSON { "partner_label": "Nombre de tu App", "email": "[email protected]" } → devuelve una api_key mostrada una vez (guárdala). Las claves son por socio, con límite de velocidad y tope de gasto. El cliente final nunca necesita una clave — solo tú, el agente/socio integrador.
• Contexto de ubicación (no preguntes al cliente por ello): el estado del cliente (y opcionalmente el código postal) se suministra al servidor fuera de banda a través de encabezados de solicitud (X-MCP-State, X-MCP-Zip) desde el flujo de ubicación de la plataforma. Envíalos como encabezados cuando los tengas; no pases el estado como argumento de herramienta.

Detalles completos, encabezados y ejemplos de solicitud/respuesta trabajados: references/mcp-connection.md.

---

Las herramientas (y el orden para llamarlas)

#	Herramienta	Nivel	Qué hace
1	check_eligibility	abierto	Primera llamada. Confirma si la red puede cotizar y/o vincular para el estado + producto del cliente.
2	start_quote	con clave	Abre una nueva cotización de hogar/auto/paquete. Devuelve un quote_id usado en cada llamada posterior.
3	update_quote	con clave	Agrega o corrige detalles de recolección en el quote_id abierto.
4	get_quote_options	con clave	Ejecuta la tarificación y devuelve las opciones de cotización. No bloqueante — devuelve lo que esté listo inmediatamente.
5	check_quote_status	abierto	Consulta el quote_id por estado y cualquier tarifa de aseguradora recién llegada.
6	check_late_arrivals	abierto	Consulta de conveniencia específica para aseguradoras que llegaron después de la primera respuesta.
7	get_option_details	abierto	Detalle (coberturas, precio) de una opción específica que el cliente está considerando.
8	get_bind_link	con clave	Genera un enlace seguro de un solo uso para que el cliente complete la vinculación con un agente autorizado.
9	request_bind_inline	con clave	Inicia la vinculación desde dentro de la conversación: archiva la solicitud de vinculación y la dirige a la agencia asignada.
10	submit_lead	con clave	Captura información de contacto si el cliente no está listo para finalizar, para que un agente haga seguimiento.
11	resume_quote	con clave	Reanuda un quote_id previamente iniciado (comprador recurrente / sesión continuada).

La vinculación la completa un humano. request_bind_inline y get_bind_link no compran una póliza silenciosamente. Archivan una solicitud de vinculación enrutada y entregan al cliente un enlace seguro; un agente autorizado en la agencia asignada finaliza la póliza con la aseguradora. Dilo claramente al cliente.

---

Recolección — qué recopilar

Recopila en bloques coherentes, no una pregunta a la vez. El estado/código postal provienen del contexto (encabezados), no del cliente.

• Hogar / paquete: nombre completo + fecha de nacimiento de todos en la póliza; dirección de la propiedad; datos básicos de la propiedad que el cliente conoce (año de construcción, metros cuadrados aproximados, edad del techo si se sabe); aseguradora actual si está cambiando.
• Auto / paquete: nombre completo + fecha de nacimiento de cada conductor; vehículos (año/marca/modelo o VIN); historial de conducción básico que el cliente proporcione voluntariamente; aseguradora actual si está cambiando.

No preguntes de más. El pipeline de tarificación enriquece automáticamente los datos faltantes de propiedad y vehículo. Nunca pidas al cliente que suba su propia página de declaración, licencia o documentos de póliza.

Clientes recurrentes

Si el cliente ha comprado o ha recibido cotizaciones a través de la red anteriormente, el servidor lo reconoce y reutiliza sus datos — las cotizaciones llegan más rápido y no se le vuelve a cobrar por el enriquecimiento. No haces nada especial; solo ejecuta el flujo normal con su nombre + fecha de nacimiento + dirección. (El servidor solo revela la prima actual de un cliente recurrente a socios con clave, nunca en una llamada anónima.)

---

Ejemplo trabajado — Vía A (conversacional)

Cliente: "¿Cuánto me costaría el seguro de auto? Estoy en Austin y pienso cambiarme."

1. check_eligibility({ product: "auto", intent: "quote" }) → cotización disponible en TX. ✅
2. "Con gusto te ayudo con eso. ¿Puedes darme tu nombre completo y fecha de nacimiento, y el año/marca/modelo del automóvil(s) que asegurarías?"
3. start_quote({ product: "auto" }) → { quote_id }
4. update_quote({ quote_id, patch: { drivers: [...], vehicles: [...] } }) — los detalles de recolección van en patch.
5. get_quote_options({ quote_id }) → devuelve opciones (p. ej., Opción A $1,704/año, Opción B $1,920/año…).
6. check_late_arrivals({ quote_id }) después de un momento → llegó una aseguradora adicional. Lee la lista actualizada al cliente.
7. "¿Quieres que asegure la Opción A? Te conectaré con un agente autorizado para finalizarla."
8. request_bind_inline({ quote_id, option_id, contact_pref, best_time, pay_plan }) → archiva la solicitud de vinculación enrutada y devuelve un enlace seguro de vinculación; el cliente es dirigido a una agencia. (La identidad de contacto proviene de la sesión de cotización — capturada durante la recolección — no de esta llamada.) Dile que un agente autorizado finalizará la póliza.

Ejemplo trabajado — Vía B (agéntico)

Un agente backend conecta el MCP y ejecuta la misma secuencia sin cabeza: check_eligibility → start_quote → update_quote → get_quote_options → (consultar) check_quote_status → request_bind_inline. Consulta references/mcp-connection.md para cargas útiles JSON-RPC sin procesar.

---

Lo que esta habilidad puede y no puede hacer

Puede: verificar disponibilidad por estado/producto; producir cotizaciones reales multi-aseguradora de hogar/auto/paquete; mostrar detalles de opciones; capturar leads; reconocer clientes recurrentes; iniciar una vinculación dirigiendo al cliente a una agencia autorizada.

No puede / no hará: finalizar una vinculación sin un humano (un agente autorizado la completa); dar servicio a una póliza existente (cambios, cancelaciones, reclamaciones, actualizaciones de hipotecario están fuera del alcance aquí); revelar la identidad de una aseguradora antes del paso de vinculación (las opciones se muestran de forma neutral hasta entonces); cotizar fuera de los estados actualmente autorizados (llama a check_eligibility).

Privacidad y seguridad

• El cliente final nunca necesita una clave API.
• Las solicitudes de cotización crean registros de prospectos; nunca sobrescriben los registros de clientes existentes.
• No fabriques cotizaciones o tarifas — si las herramientas no devuelven nada, dilo y ofrece submit_lead.
• No pidas a los clientes que suban documentos personales.