SecondAppraisal Total-Loss Intake

Envie a perda total de um proprietário de veículo para a SecondAppraisal; leitura preliminar de mercado; regras estaduais.

Ver em secondappraisal.comExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://secondappraisal.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Para agentes de IA

Se você é um agente de IA — ou desenvolve um — e o veículo do seu usuário foi declarado perda total, você pode encaminhar a situação dele diretamente para a SecondAppraisal. Somos uma consultoria independente de avaliação: revisamos a avaliação da seguradora, encontramos veículos comparáveis e mostramos ao proprietário o valor real do veículo. A consulta é gratuita e sem compromisso. Esta página é o contrato completo; tudo o que está nela também está disponível em documentos legíveis por máquina, com links no final.

Entrada mínima

Um dos customer.phone ou customer.email, sua autoidentificação agent (name + platform) e um consent.attestation — uma frase com suas próprias palavras informando que o proprietário pediu para você enviar isto e sabe que entraremos em contato. Todo o resto é opcional e melhora o que retornamos: vehicle.vin (ou placa + estado, ou ano/marca/modelo), vehicle.odometer, loss.date_of_loss, loss.loss_state ou loss.zip, offer.insurer, offer.acv_offer_cents. O relatório de avaliação da seguradora (PDF) pode ser anexado posteriormente.

O que fazemos com isso — a política de contato

Criamos uma consulta no quadro da nossa equipe imediatamente. A menos que você defina consent.notify_customer como false, enviamos ao proprietário um e-mail de boas-vindas e um SMS com um link de confirmação em um toque. E uma pessoa da nossa equipe liga. Informamos isso ao cliente com estas palavras exatas, e você também deve:

Tentaremos ligar para você para confirmar que deseja nossa consultoria gratuita de avaliação e para confirmar que esta solicitação veio de você ou do seu representante/agente.

Nunca fazemos chamadas automatizadas ou de IA para essa verificação. O customer_message do recibo já contém o aviso e o link de confirmação — leia-o ao seu usuário na íntegra. Se o proprietário não pediu isso, a mensagem de boas-vindas inclui um link de cancelamento (e-mail) e "responda STOP" (SMS), e a pessoa que ligar simplesmente encerrará.

Identidade e limites

Nenhuma chave é necessária. Chamadas anônimas devem se autoidentificar, têm limite de taxa por IP (20 envios / minuto), são deduplicadas em 30 dias por cliente e são verificadas contra nossa lista legal de não-contato (uma correspondência retorna uma resposta neutra not_eligible sem explicação — por design). Envie um cabeçalho Idempotency-Key; uma repetição retorna o recibo original com idempotent_replay: true.

Registro (gratuito) — para prioridade, preliminares, webhooks

O registro é autoatendido e leva uma troca de e-mails. Ele desbloqueia o preliminary em cada envio, consent.mode: "warm_handoff" (o cliente pediu para ser chamado agora — um retorno de chamada prioritário para uma pessoa da nossa equipe), limites de taxa 6× por chave em vez de por IP, e webhooks assinados para mudanças de status. Leia o Contrato de API para Agentes primeiro; você o aceita ao se registrar.

POST /api/agent/v1/register

{
  "agent": { "name": "OpenClaw", "platform": "openclaw", "website": "https://example.com" },
  "operator": { "name": "Jane Operator", "email": "ops@example.com" },
  "agreement": { "accepted": true, "version": "2026-09-17" }
}

Enviamos um código de 6 dígitos por e-mail ao operador (validade de 30 minutos, 5 tentativas). Em seguida, POST /api/agent/v1/register/verify com { "registration_id", "code" } retorna sua chave sa_agent_… uma única vez. Envie-a como Authorization: Bearer em cada chamada. Rotas da conta: GET /api/agent/v1/me, POST /api/agent/v1/me/rotate-key, PUT /api/agent/v1/me/webhook (URL https → segredo de assinatura, exibido uma vez). As entregas de webhook carregam apenas o status do intake — nunca os dados de contato do cliente — e são assinadas com X-SecondAppraisal-Signature: t=<unix>,v1=<hmac-sha256(secret, "<t>.<body>")>.

Preços, o desconto de $25 e como funciona o pagamento

A consulta é gratuita. Se o cliente quiser mais, há dois serviços pagos, e você pode citar esses valores textualmente (eles também são retornados em cada recibo como pricing):

Pesquisa de Avaliação — uma avaliação por escrito que o cliente usa por conta própria. Preço de tabela $199. Pago antecipadamente: uma retenção no cartão, capturada quando a pesquisa é entregue. Sem garantia.
Pesquisa de Avaliação + Negociação — atuamos como avaliador nomeado do cliente sob a cláusula de avaliação da apólice. Preço de tabela $497; com o desconto abaixo, $472. Uma retenção no cartão é feita, não uma cobrança. Ela é capturada somente após o acordo melhorar em pelo menos $1.000 em relação à oferta original da seguradora — nossa garantia de melhoria mínima. Se não atingirmos isso, nada é cobrado e a retenção é liberada.

O desconto de $25. Um cliente que você enviar recebe um desconto de $25, aplicado à consulta no momento em que recebemos o intake, e informado no customer_message que devolvemos. Ele se aplica apenas à taxa de representação ($497 → $472). A Pesquisa de Avaliação sozinha permanece em $199; se o cliente comprar a pesquisa primeiro e depois fizer upgrade, o desconto de $25 é aplicado nesse momento, então o total é o mesmo $472. É um desconto por cliente, de qualquer fonte — indicação de amigo, de avaliador ou sua — nunca acumulável. Agentes registrados sempre concedem; envios anônimos concedem enquanto o programa permitir (pricing.discount.applied informa).

Como o pagamento realmente acontece. Nunca por meio desta API, e nunca por meio de você. O cliente acessa a própria consulta em nosso site, lê e aceita nossos termos pessoalmente e pré-autoriza o próprio cartão. O bloco checkout do recibo fornece as duas páginas para você indicar — research_url e representation_url — que ficam disponíveis após o cliente confirmar e nossa consulta gratuita ser entregue. Não colete dados de cartão, não prometa um resultado específico e não descreva a retenção como cobrança. Reembolsos seguem nossos termos publicados; a garantia é uma política de isenção de taxa, não uma promessa de que a seguradora pagará um valor específico.

REST — uma solicitação

POST /api/agent/v1/intakes — corpo

{
  "agent": { "name": "OpenClaw", "platform": "openclaw", "version": "2026.9" },
  "customer": { "first_name": "Jane", "phone": "8015550123" },
  "vehicle": { "vin": "1HGCM82633A004352", "odometer": 88000 },
  "loss": { "date_of_loss": "2026-09-01", "loss_state": "UT", "insurance_path": "own" },
  "offer": { "insurer": "State Farm", "acv_offer_cents": 1250000 },
  "consent": {
    "attestation": "The owner asked me to submit their total loss to SecondAppraisal and knows they will be emailed, texted, and called to confirm.",
    "notify_customer": true
  },
  "external_ref": "your-ticket-42"
}

curl

curl -X POST https://secondappraisal.com/api/agent/v1/intakes \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-ticket-42" \
  -d @intake.json

201 — o recibo

{
  "intake_id": "cmu4psy5a…",
  "status": "welcome_sent",
  "customer_confirmation_url": "https://secondappraisal.com/from-agent/<token>",
  "customer_message": "Hi Jane — OpenClaw shared your total-loss details with SecondAppraisal. … We will attempt to call you to confirm that you want our free appraisal consultation and to confirm this request came from you or your representative/agent. You can confirm right now here: https://secondappraisal.com/from-agent/<token>",
  "contact_policy": {
    "will_email": false, "will_text": true, "will_call": true,
    "call_purpose": "confirm the request came from the customer or their representative/agent and that they want the free appraisal consultation",
    "automated_calls": false
  },
  "preliminary": { "vehicle_label": "2003 Honda Accord EX", "market": { "low": 4200, "mid": 5600, "high": 7900 }, "adjusted_mid": 5450, "gap_vs_offer_cents": -705000, "…": "…" },
  "missing_fields": ["customer.email"],
  "poll_url": "https://secondappraisal.com/api/agent/v1/intakes/cmu4psy5a…",
  "poll_token": "<shown once — store it>",
  "docs_url": "https://secondappraisal.com/for-agents"
}

Siga o intake com GET /api/agent/v1/intakes/{intake_id} e Authorization: Bearer <poll_token>. Anexe o relatório de avaliação da seguradora com POST /api/agent/v1/intakes/{intake_id}/documents (multipart file, PDF, ≤ 15 MB, aguarde dois minutos). O contrato completo é o documento OpenAPI abaixo; ele é gerado a partir do mesmo esquema que o servidor valida.

MCP — o mesmo como ferramentas

Um servidor remoto de Model Context Protocol (HTTP Streamable, sem estado) em https://secondappraisal.com/mcp, nome do servidor com.secondappraisal/total-loss-intake. Ferramentas:

submit_total_loss_intake — Envia a situação de perda total de um proprietário de veículo para a SecondAppraisal em nome dele.
get_intake_status — Busca o recibo atual de um intake enviado (status, link de confirmação enquanto ainda confirmável, preliminar)..
upload_valuation_report — Anexa o Relatório de Avaliação de Mercado da seguradora (PDF CCC / Mitchell) a um intake enviado.
get_preliminary_estimate — Uma leitura antecipada de mercado sem compromisso para um veículo: preços de listagem comparáveis perto do cliente (10º percentil / mediana / 90º), um meio ajustado por odômetro e a diferença em relação à oferta da seguradora.
get_state_total_loss_rules — Fatos de perda total específicos por estado: limite e método, se um avaliador independente deve ser licenciado lá, se avaliações de terceiros são permitidas, citações de estatutos, direitos essenciais, armadilhas comuns e o telefone do consumidor..

Configuração do cliente (estilo Claude Desktop / Cursor / Codex)

{
  "mcpServers": {
    "secondappraisal": {
      "type": "streamable-http",
      "url": "https://secondappraisal.com/mcp"
    }
  }
}

O cartão do servidor está em /.well-known/mcp.json. Chamadas agente-a-agente: o cartão A2A está em /.well-known/agent-card.json e message/send para /a2a com o corpo do intake como DataPart retorna uma Task concluída cujo artefato é o recibo.

Documentos legíveis por máquina

OpenAPI 3.0 — o contrato REST.
Cartão do servidor MCP — conecte-se em /mcp.
Cartão do agente A2A — JSON-RPC em /a2a.
agents.json — fluxos de trabalho baseados em OpenAPI.
ai-catalog.json — todos os artefatos acima em um índice; llms.txt para tudo o mais que publicamos.

Dúvidas, listagem de diretório ou parceria: fale conosco. Nossas próprias credenciais estão em /credentials.