Threshold

npx add-mcp 'https://threshold.rentals/api/mcp'

MCP

Adicione este servidor MCP remoto ao Claude, ChatGPT ou qualquer cliente MCP (passo a passo para viajantes):

https://threshold.rentals/api/mcp

Ferramentas: search_stays, get_property, check_availability, get_quote, request_booking, get_booking, get_messages, send_message, cancel_booking, ask_host. Envie Authorization: Bearer <any stable token> para manter suas reservas vinculadas ao seu agente.

Cartão do servidor: /api/mcp/server-card (também em /.well-known/mcp/server-card.json, e listado em /.well-known/ai-catalog.json).

API REST

Descrição completa para frameworks de agentes, ações personalizadas do GPT e geradores de código: https://threshold.rentals/openapi.json (OpenAPI 3.1). O JSON Schema do registro da propriedade está em /schemas/property.schema.json.

GET  https://threshold.rentals/api/v1/search?place=Asheville,NC&check_in=2026-10-09&check_out=2026-10-12&adults=2&pets=1&amenities=hot_tub
GET  https://threshold.rentals/api/v1/properties/{id}
GET  https://threshold.rentals/api/v1/properties/{id}/availability?from=…&to=…
POST https://threshold.rentals/api/v1/properties/{id}/quotes      {check_in, check_out, party}
POST https://threshold.rentals/api/v1/booking_requests            {quote_id, buyer, house_rules_accepted, special_requests}
GET  https://threshold.rentals/api/v1/bookings/{id}
GET  https://threshold.rentals/api/v1/bookings/{id}/messages     (POST {body} to message the host)
GET  https://threshold.rentals/api/v1/bookings/{id}/cancellation_preview
POST https://threshold.rentals/api/v1/bookings/{id}/cancel        {expected_refund}
POST https://threshold.rentals/api/v1/properties/{id}/questions  {question}
GET  https://threshold.rentals/api/v1/events
GET  https://threshold.rentals/.well-known/jwks.json

Valores monetários estão em centavos. A busca é armazenada em cache; uma cotação relê os calendários do anfitrião e é o único preço vinculante. Erros são application/problem+json com um code estável. As solicitações são limitadas por IP e por token de agente (por exemplo, 60 buscas e 30 cotações por minuto, 10 solicitações de reserva por hora); acima do limite, você recebe 429 com um cabeçalho Retry-After. Um hóspede pode ter no máximo 3 solicitações de reserva não confirmadas abertas ao mesmo tempo.

Como funciona a reserva

Verifique o booking_mode de cada cotação. Com instant, a reserva é confirmada assim que o hóspede paga. Com host_confirms, é uma solicitação que o anfitrião aceita ou recusa dentro da janela de resposta do anúncio (1–24 horas). Verifique o objeto payment de cada cotação. Quando collected_by é threshold, request_booking retorna um payment_url: o hóspede o abre e adiciona um cartão em uma página segura do Stripe, e somente então a solicitação chega ao anfitrião. O cartão é autorizado e cobrado apenas se o anfitrião aceitar, ou, com plan: pay_later, cobrado em charge_date. Agentes nunca lidam com dados de cartão. Na API REST (não via MCP), agentes com uma carteira que emite tokens de pagamento compartilhados do Stripe (como a carteira de agente Link do Stripe) podem pular a página: quando a resposta incluir agent_payment, faça POST no seu url, responda ao desafio 402 (Machine Payments Protocol, método stripe) com um token para seu network_id, e a retenção é feita assim que o hóspede aprovar em sua carteira. Quando collected_by é host, o anfitrião organiza o pagamento após aceitar. Informe claramente aos hóspedes qual caso se aplica e mostre a eles as regras da casa da cotação antes de definir house_rules_accepted.