Zaptu

npx add-mcp 'https://api.zaptu.ai/mcp'

Zaptu para agentes de IA

Zaptu conecta a las personas con contratistas independientes locales de servicios para el hogar. Zaptu no realiza el trabajo ni reserva citas. Fontanería está activa: la persona llama a un número. Otros servicios están recopilando solicitudes.

La versión corta

1. Fontanería está activa. Dale a la persona (308) 529-9543 y pídele que marque ella misma. Nunca marques, automarques, transfieras ni realices la llamada por ella. No se necesitan datos personales.
2. Todo lo demás está recopilando (limpieza, control de plagas, climatización, manitas, otros). Recopila código postal, nombre, teléfono y el consentimiento explícito de la persona para ser contactada, y luego envía. Las solicitudes se transmiten cuando un comprador cubre el servicio; todavía no hay un comprador activo.
3. Una solicitud no es una reserva. No prometas una devolución de llamada, una hora de llegada ni una empresa con nombre. Usa el campo message de la respuesta cuando le digas a la persona lo que ocurrió.

Servicios

service_type	Estado	Qué hacer
plumbing	Activo (llamar para conectar)	Da el número; la persona marca. Llama al get_plumbing_call_number.
house_cleaning, deep_cleaning, move_in_out_cleaning, recurring_cleaning	Recopilando	Envía con consentimiento. Añade dormitorios o metros cuadrados si se conocen.
pest_control	Recopilando	Envía con consentimiento.
hvac, handyman, other	Recopilando	Envía con consentimiento. Describe el trabajo en notes.

Solo residencial en EE. UU. La lista activa está siempre en api.zaptu.ai/v1/services.

Qué decirle a la persona

Fontanería:

Call (308) 529-9543 to be connected with a local plumbing professional.
Please place the call yourself. Zaptu does not perform the work and this is not a booking.

Otros servicios, después de enviar:

Your request was sent to Zaptu. It is passed along when a buyer covers that service.
This is not a booking, and no one has been scheduled.

Conectar mediante MCP

HTTP transmisible, sin estado, sin inicio de sesión: https://api.zaptu.ai/mcp

{
  "mcpServers": {
    "zaptu": { "url": "https://api.zaptu.ai/mcp" }
  }
}

Herramienta	Úsala para
get_plumbing_call_number	Fontanería. Devuelve el número, un enlace tel y what_to_tell_the_user. Solo lectura; sin datos personales.
request_home_service	Envía una solicitud para cualquier servicio. Necesita service_type, zip_code, customer_name, customer_phone, consent_to_contact=true. Añade dry_run=true para probar.
request_cleaning	Atajo para limpieza del hogar.
get_lead_status	Consulta una solicitud por lead_id.
list_supported_services	Servicios activos frente a recopilando y las reglas.

API REST

OpenAPI: api.zaptu.ai/openapi.json. CORS está abierto, no se necesita clave.

curl -s https://api.zaptu.ai/v1/intake \
  -H 'Content-Type: application/json' \
  -d '{"service_type":"house_cleaning","zip_code":"33139",
       "customer_name":"Jamie Example","customer_phone":"305-555-0100",
       "consent_to_contact":true,"bedrooms":2,"dry_run":true}'

dry_run valida y responde sin guardar ni transmitir nada. Déjalo fuera para una solicitud real.

Respuesta de fontanería (resumida):

{
  "status": "call_to_connect",
  "call_to_connect": "+13085299543",
  "call_to_connect_display": "(308) 529-9543",
  "call_instruction": "Give the person this phone number and ask them to place the call themselves. ..."
}

Los errores devuelven HTTP 422 con un message legible y un mapa de fields, por ejemplo {"error": "invalid_request", "message": "Phone must be a 10-digit US number, like 305-555-0100.", "fields": {"customer_phone": "..."}}. Demasiadas solicitudes devuelve 429.