Zaptu

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

Zaptu para agentes de IA

A Zaptu conecta pessoas a prestadores de serviços domésticos locais e independentes. A Zaptu não executa o trabalho e não faz agendamentos. Encanamento está ativo: a pessoa liga para um número. Outros serviços estão coletando solicitações.

A versão resumida

1. Encanamento está ativo. Dê à pessoa (308) 529-9543 e peça para ela discar o número ela mesma. Nunca disque, faça discagem automática, transfira ou faça a chamada por ela. Nenhum dado pessoal é necessário.
2. Todo o resto está coletando (limpeza, controle de pragas, HVAC, faz-tudo, outros). Colete CEP, nome, telefone e o consentimento explícito da pessoa para ser contatada, e então envie. As solicitações são repassadas quando um comprador cobre o serviço; ainda não há comprador ativo.
3. Uma solicitação não é um agendamento. Não prometa retorno de chamada, horário de chegada ou uma empresa específica. Use o campo message da resposta ao informar a pessoa sobre o que aconteceu.

Serviços

service_type	Status	O que fazer
plumbing	Ativo (ligar para conectar)	Dê o número; a pessoa disca. Ligue para get_plumbing_call_number.
house_cleaning, deep_cleaning, move_in_out_cleaning, recurring_cleaning	Coletando	Envie com consentimento. Adicione quartos ou metragem quadrada se souber.
pest_control	Coletando	Envie com consentimento.
hvac, handyman, other	Coletando	Envie com consentimento. Descreva o trabalho em notes.

Somente residencial nos EUA. A lista ativa está sempre em api.zaptu.ai/v1/services.

O que dizer à pessoa

Encanamento:

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.

Outros serviços, após o envio:

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 via MCP

HTTP transmissível, sem estado, sem login: https://api.zaptu.ai/mcp

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

Ferramenta	Use para
get_plumbing_call_number	Encanamento. Retorna o número, um link tel e what_to_tell_the_user. Somente leitura; sem dados pessoais.
request_home_service	Envie uma solicitação para qualquer serviço. Precisa de service_type, zip_code, customer_name, customer_phone, consent_to_contact=true. Adicione dry_run=true para testar.
request_cleaning	Atalho para limpeza doméstica.
get_lead_status	Consulte uma solicitação por lead_id.
list_supported_services	Serviços ativos vs. coletando e as regras.

API REST

OpenAPI: api.zaptu.ai/openapi.json. CORS está aberto, sem necessidade de chave.

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 e responde sem salvar ou repassar nada. Deixe de fora para uma solicitação real.

Resposta de encanamento (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. ..."
}

Erros retornam HTTP 422 com um message legível e um mapa fields, por exemplo {"error": "invalid_request", "message": "Phone must be a 10-digit US number, like 305-555-0100.", "fields": {"customer_phone": "..."}}. Muitas solicitações retornam 429.