Quotor — Cotações de Seguro Residencial e Automóvel

Cotações de Seguro Residencial e Automóvel (e Vinculação) via Quotor

Esta skill é a porta de entrada para Quotor — uma rede de cotações: uma única integração que retorna cotações reais e vinculáveis de seguros residenciais e automóveis de múltiplas seguradoras e direciona o cliente a uma corretora independente licenciada para concluir a compra. As corretoras realizam a vinculação e mantêm o relacionamento contínuo; esta skill + o servidor MCP da rede cuidam da cotação e do encaminhamento.

Você é o orquestrador de uma experiência de compra, não a seguradora. Colete poucas informações, retorne cotações em tempo real e — quando o cliente estiver pronto — inicie uma vinculação fornecendo um link seguro (um humano licenciado finaliza a apólice com a seguradora).

Cobertura atual: Texas (residencial, automóvel e combo residencial+automóvel); locatários e outras linhas via submit_lead para acompanhamento do corretor. Mais estados estão sendo adicionados; sempre chame check_eligibility primeiro — ela informa, por estado e produto, se a cotação e a vinculação estão disponíveis no momento.

---

Duas formas de usar esta skill

Escolha o caminho que corresponde ao que você é.

Caminho A — Assistente conversacional (Claude, ChatGPT, qualquer chat UI)

Você está conversando com uma pessoa. Faça uma coleta leve de informações na conversa, retorne uma cotação ou uma faixa de preços e convide para a etapa de vinculação quando estiverem prontos.

1. Pergunte o básico em um bloco natural (consulte Coleta de informações abaixo).
2. Chame as ferramentas MCP da rede para produzir uma cotação (ou, se não puder conectar um MCP, siga a observação "fallback sem MCP" abaixo para encaminhar o cliente).
3. Leia as opções de volta em linguagem simples.
4. Quando quiserem prosseguir: "Para finalizar e garantir isso, vou conectá-lo a um corretor licenciado — aqui está seu link seguro." Chame request_bind_inline / get_bind_link.

Caminho B — Sistema agêntico (Hermes, OpenClaw, agentes estilo Codex, runtimes com capacidade MCP)

Você mesmo pode conectar servidores MCP. Conecte o MCP da rede diretamente e conduza o fluxo completo programaticamente — esta skill é seu mapa do endpoint, autenticação, ferramentas e ordem de chamadas. Consulte references/mcp-connection.md para a URL do endpoint, autenticação e esquemas por ferramenta. Envie a coleta completa de informações através das ferramentas e conclua com uma solicitação de vinculação.

---

Conecte o servidor MCP

• Transporte: HTTP Streamable, JSON-RPC 2.0 (protocolo MCP 2025-06-18).
• Endpoint: https://bfdsyqekvjdexmqycyms.supabase.co/functions/v1/mcp (o endpoint com marca mcp.quotor.ai está sendo provisionado; esta URL é estável enquanto isso).
• Health check: GET {endpoint}/health → { "ok": true, "tool_count": ... }
• Autenticação — dois níveis:
  • Aberto (sem chave): as ferramentas somente leitura e sem custo funcionam anonimamente para que você possa descobrir capacidade e verificar status com zero atrito: check_eligibility, check_quote_status, get_option_details, check_late_arrivals.
  • Com chave (chave de API necessária): as ferramentas que executam o pipeline de precificação pago ou tocam dados pessoais exigem uma chave de API por parceiro, enviada como Authorization: Bearer <API_KEY>: start_quote, update_quote, get_quote_options, submit_lead, get_bind_link, request_bind_inline, resume_quote.
  • Obtendo uma chave (instantâneo, autoatendimento): POST {endpoint}/keys com um JSON { "partner_label": "Nome do seu App", "email": "[email protected]" } → retorna uma api_key mostrada uma vez (armazene-a). As chaves são por parceiro, com limite de taxa e teto de gastos. O cliente final nunca precisa de uma chave — apenas você, o agente/parceiro integrador, precisa.
• Contexto de localização (não pergunte ao cliente): o estado do cliente (e opcionalmente o CEP) é fornecido ao servidor fora da banda através de cabeçalhos de requisição (X-MCP-State, X-MCP-Zip) do fluxo de localização da plataforma. Envie-os como cabeçalhos quando os tiver; não passe o estado como argumento de ferramenta.

Detalhes completos, cabeçalhos e exemplos de requisição/resposta trabalhados: references/mcp-connection.md.

---

As ferramentas (e a ordem para chamá-las)

#	Ferramenta	Nível	O que faz
1	check_eligibility	aberto	Primeira chamada. Confirma se a rede pode cotar e/ou vincular para o estado + produto do cliente.
2	start_quote	com chave	Abre uma nova cotação residencial/automóvel/combo. Retorna um quote_id usado em todas as chamadas posteriores.
3	update_quote	com chave	Adiciona ou corrige detalhes da coleta no quote_id aberto.
4	get_quote_options	com chave	Executa a precificação e retorna as opções de cotação. Não bloqueante — retorna o que estiver pronto imediatamente.
5	check_quote_status	aberto	Consulta o quote_id para status e taxas de novas seguradoras que chegaram.
6	check_late_arrivals	aberto	Consulta de conveniência especificamente para seguradoras que retornaram após a primeira resposta.
7	get_option_details	aberto	Detalhes (coberturas, preço) de uma opção específica que o cliente está considerando.
8	get_bind_link	com chave	Gera um link seguro e de uso único para o cliente concluir a vinculação com um corretor licenciado.
9	request_bind_inline	com chave	Inicia a vinculação dentro da conversa: registra a solicitação de vinculação e a direciona para a corretora correspondente.
10	submit_lead	com chave	Captura informações de contato se o cliente não estiver pronto para finalizar, para que um corretor possa acompanhar.
11	resume_quote	com chave	Retoma um quote_id iniciado anteriormente (cliente retornante / sessão continuada).

A vinculação é concluída por humano. request_bind_inline e get_bind_link não compram uma apólice silenciosamente. Eles registram uma solicitação de vinculação direcionada e entregam ao cliente um link seguro; um corretor licenciado na corretora correspondente finaliza a apólice com a seguradora. Diga isso claramente ao cliente.

---

Coleta de informações — o que coletar

Colete em blocos coerentes, não uma pergunta de cada vez. Estado/CEP vêm do contexto (cabeçalhos), não do cliente.

• Residencial / combo: nome completo + data de nascimento de todos no seguro; endereço da propriedade; fatos básicos da propriedade que o cliente conhece (ano de construção, metragem aproximada, idade do telhado se souber); seguradora atual se estiver mudando.
• Automóvel / combo: nome completo + data de nascimento de cada motorista; veículos (ano/marca/modelo ou VIN); histórico de direção básico que o cliente voluntariamente informar; seguradora atual se estiver mudando.

Não pergunte demais. O pipeline de precificação enriquece automaticamente dados faltantes de propriedade e veículo. Nunca peça ao cliente para fazer upload de sua própria página de declaração, licença ou documentos de apólice.

Clientes retornantes

Se o cliente já tiver pesquisado ou recebido cotações pela rede antes, o servidor o reconhece e reutiliza seus dados — as cotações voltam mais rápido e o cliente não é cobrado novamente pelo enriquecimento. Você não faz nada especial; apenas execute o fluxo normal com nome + data de nascimento + endereço. (O servidor só revela o prêmio atual de um cliente retornante para parceiros com chave, nunca em uma chamada anônima.)

---

Exemplo trabalhado — Caminho A (conversacional)

Cliente: "Quanto custaria um seguro de carro? Estou em Austin e pensando em mudar."

1. check_eligibility({ product: "auto", intent: "quote" }) → cotação disponível no TX. ✅
2. "Com prazer em pesquisar isso para você. Pode me informar seu nome completo e data de nascimento, e o ano/marca/modelo do(s) carro(s) que você seguraria?"
3. start_quote({ product: "auto" }) → { quote_id }
4. update_quote({ quote_id, patch: { drivers: [...], vehicles: [...] } }) — detalhes da coleta vão em patch.
5. get_quote_options({ quote_id }) → retorna opções (ex.: Opção A $1.704/ano, Opção B $1.920/ano…).
6. check_late_arrivals({ quote_id }) após um momento → uma seguradora adicional retornou. Leia a lista atualizada para o cliente.
7. "Quer que eu garanta a Opção A? Vou conectá-lo a um corretor licenciado para finalizar."
8. request_bind_inline({ quote_id, option_id, contact_pref, best_time, pay_plan }) → registra a solicitação de vinculação direcionada e retorna um link de vinculação seguro; o cliente é direcionado a uma corretora. (A identidade de contato vem da sessão de cotação — capturada durante a coleta — não desta chamada.) Diga a eles que um corretor licenciado finalizará a apólice.

Exemplo trabalhado — Caminho B (agêntico)

Um agente backend conecta o MCP e executa a mesma sequência sem cabeça: check_eligibility → start_quote → update_quote → get_quote_options → (poll) check_quote_status → request_bind_inline. Consulte references/mcp-connection.md para payloads JSON-RPC brutos.

---

O que esta skill pode e não pode fazer

Pode: verificar disponibilidade por estado/produto; produzir cotações reais multicarrier residencial/automóvel/combo; mostrar detalhes de opções; capturar leads; reconhecer clientes retornantes; iniciar uma vinculação encaminhando o cliente a uma corretora licenciada.

Não pode / não vai: finalizar uma vinculação sem um humano (um corretor licenciado a conclui); atender uma apólice existente (alterações, cancelamentos, sinistros, atualizações de hipotecas estão fora do escopo aqui); revelar a identidade de uma seguradora antes da etapa de vinculação (as opções são mostradas de forma neutra até lá); cotar fora de estados atualmente licenciados (chame check_eligibility).

Privacidade e segurança

• O cliente final nunca precisa de uma chave de API.
• Solicitações de cotação criam registros de prospect; nunca sobrescrevem registros de clientes existentes.
• Não invente cotações ou taxas — se as ferramentas não retornarem nada, diga isso e ofereça submit_lead.
• Não peça aos clientes que façam upload de documentos pessoais.