SecondAppraisal Total-Loss Intake

Envía la pérdida total de un propietario de vehículo a SecondAppraisal; lectura preliminar del mercado; reglas estatales.

Ver en secondappraisal.comPrueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Para agentes de IA

Si usted es un agente de IA — o construye uno — y el vehículo de su usuario fue declarado pérdida total, puede entregar su situación directamente a SecondAppraisal. Somos una consultoría de avalúos independiente: revisamos la valoración de la aseguradora, encontramos vehículos comparables y le mostramos al propietario cuánto vale realmente el vehículo. La consulta es gratuita y sin compromiso. Esta página es el contrato completo; todo lo que contiene también está disponible como documentos legibles por máquina enlazados al final.

Entrada mínima

Uno de customer.phone o customer.email, su autoidentificación agent (name + platform), y un consent.attestation — una frase con sus propias palabras indicando que el propietario le pidió enviar esto y sabe que nos pondremos en contacto. Todo lo demás es opcional y mejora lo que devolvemos: vehicle.vin (o placa + estado, o año/marca/modelo), vehicle.odometer, loss.date_of_loss, loss.loss_state o loss.zip, offer.insurer, offer.acv_offer_cents. El informe de valoración de la aseguradora (PDF) se puede adjuntar después.

Qué hacemos con ello — la política de contacto

Creamos una consulta en el tablero de nuestro equipo inmediatamente. A menos que establezca consent.notify_customer en false, enviamos al propietario un correo de bienvenida y un mensaje de texto con un enlace de confirmación de un toque. Y una persona de nuestro equipo llama. Se lo comunicamos al cliente con estas palabras exactas, y usted también debería hacerlo:

Intentaremos llamarle para confirmar que desea nuestra consulta de avalúo gratuita y para confirmar que esta solicitud provino de usted o de su representante/agente.

Nunca realizamos llamadas automatizadas o de IA para esa verificación. El customer_message del recibo ya contiene el aviso y el enlace de confirmación — léaselo a su usuario textualmente. Si el propietario no lo solicitó, el mensaje de bienvenida incluye un enlace de detención (correo) y "responda STOP" (mensaje de texto), y la persona que llama simplemente se detendrá.

Identidad y límites

No se requiere clave. Los llamantes anónimos deben autoidentificarse, están limitados por IP (20 envíos / minuto), se deduplican durante 30 días por cliente y se verifican contra nuestra lista legal de no contacto (una coincidencia devuelve una respuesta neutral not_eligible sin explicación — por diseño). Envíe un encabezado Idempotency-Key; una repetición devuelve el recibo original con idempotent_replay: true.

Registro (gratuito) — para prioridad, trámites preliminares, webhooks

El registro es autoservicio y requiere un intercambio de correo. Desbloquea el preliminary en cada envío, consent.mode: "warm_handoff" (el cliente pidió que le llamen ahora — una devolución de llamada prioritaria para una persona de nuestro equipo), límites de velocidad 6× por clave en lugar de por IP, y webhooks firmados para cambios de estado. Lea el Acuerdo de API para Agentes primero; lo acepta al registrarse.

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 un código de 6 dígitos por correo al operador (vigencia de 30 minutos, 5 intentos). Luego POST /api/agent/v1/register/verify con { "registration_id", "code" } devuelve su clave sa_agent_… una sola vez. Envíela como Authorization: Bearer en cada llamada. Rutas de cuenta: GET /api/agent/v1/me, POST /api/agent/v1/me/rotate-key, PUT /api/agent/v1/me/webhook (URL https → secreto de firma, mostrado una vez). Las entregas de webhook llevan solo el estado de la admisión — nunca los datos de contacto del cliente — y están firmadas con X-SecondAppraisal-Signature: t=<unix>,v1=<hmac-sha256(secret, "<t>.<body>")>.

Precios, el descuento de $25 y cómo funciona el pago

La consulta es gratuita. Si el cliente quiere más, hay dos servicios de pago, y puede citar estas cifras textualmente (también se devuelven en cada recibo como pricing):

Investigación de Avalúo — una valoración por escrito que el cliente usa por sí mismo. Precio de lista $199. Pagado por adelantado: una retención en la tarjeta, cobrada cuando se entrega la investigación. Sin garantía.
Investigación de Avalúo + Negociación — actuamos como el tasador designado del cliente bajo la cláusula de avalúo de su póliza. Precio de lista $497; con el descuento a continuación, $472. Se coloca una retención temporal en la tarjeta, no un cargo. Se cobra solo después de que el acuerdo mejore en al menos $1,000 sobre la oferta original de la aseguradora — nuestra garantía de mejora mínima. Si no lo logramos, no se cobra nada y se libera la retención.

El descuento de $25. Un cliente que usted envíe recibe un descuento de $25, guardado en su consulta en el momento en que recibimos la admisión, y se indica en el customer_message que devolvemos. Se aplica solo a la tarifa de representación ($497 → $472). La Investigación de Avalúo sola sigue en $199; si el cliente compra primero la investigación y luego mejora, el $25 se aplica entonces, por lo que el total es el mismo $472. Es un descuento por cliente de cualquier fuente — una referencia de un amigo, de un tasador o la suya — nunca acumulable. Los agentes registrados siempre lo otorgan; los envíos anónimos lo hacen mientras el programa lo permita (pricing.discount.applied se lo indica).

Cómo ocurre realmente el pago. Nunca a través de esta API, y nunca a través de usted. El cliente inicia sesión en su propia consulta en nuestro sitio, lee y acepta nuestros términos por sí mismo y preautoriza su propia tarjeta. El bloque checkout del recibo le da las dos páginas para señalarles — research_url y representation_url — que estarán disponibles después de que el cliente confirme y se entregue nuestra consulta gratuita. No recopile datos de tarjeta, no prometa un resultado específico y no describa la retención como un cargo. Los reembolsos siguen nuestros términos publicados; la garantía es una política de exención de tarifas, no una promesa de que una aseguradora pagará una cantidad específica.

REST — una solicitud

POST /api/agent/v1/intakes — cuerpo

{
  "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 — el 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 la admisión con GET /api/agent/v1/intakes/{intake_id} y Authorization: Bearer <poll_token>. Adjunte el informe de valoración de la aseguradora con POST /api/agent/v1/intakes/{intake_id}/documents (multipart file, PDF, ≤ 15 MB, permita dos minutos). El contrato completo es el documento OpenAPI a continuación; se genera a partir del mismo esquema con el que el servidor valida.

MCP — lo mismo como herramientas

Un servidor remoto de Protocolo de Contexto de Modelo (HTTP Streamable, sin estado) en https://secondappraisal.com/mcp, nombre del servidor com.secondappraisal/total-loss-intake. Herramientas:

submit_total_loss_intake — Envíe la situación de pérdida total del propietario de un vehículo a SecondAppraisal en su nombre.
get_intake_status — Obtenga el recibo actual de una admisión enviada (estado, enlace de confirmación mientras sea confirmable, preliminar)..
upload_valuation_report — Adjunte el Informe de Valoración de Mercado de la aseguradora (PDF de CCC / Mitchell) a una admisión enviada.
get_preliminary_estimate — Una lectura de mercado temprana sin compromiso para un vehículo: precios de listados comparables cerca del cliente (percentil 10 / mediana / percentil 90), un punto medio ajustado por odómetro y la brecha frente a la oferta de la aseguradora.
get_state_total_loss_rules — Datos de pérdida total específicos por estado: umbral y método, si un tasador independiente debe tener licencia allí, si se permiten avalúos de terceros, citas de estatutos, derechos imprescindibles, errores comunes y la línea de atención al consumidor..

Configuración del cliente (estilo Claude Desktop / Cursor / Codex)

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

La tarjeta del servidor está en /.well-known/mcp.json. Llamantes de agente a agente: la tarjeta A2A está en /.well-known/agent-card.json y message/send a /a2a con el cuerpo de la admisión como DataPart devuelve una Tarea completada cuyo artefacto es el recibo.

Documentos legibles por máquina

OpenAPI 3.0 — el contrato REST.
Tarjeta del servidor MCP — conéctese en /mcp.
Tarjeta de agente A2A — JSON-RPC en /a2a.
agents.json — flujos de trabajo basados en OpenAPI.
ai-catalog.json — todos los artefactos anteriores en un índice; llms.txt para todo lo demás que publicamos.

Preguntas, un listado de directorio o una alianza: contáctenos. Nuestras propias credenciales están en /credentials.