verify_vacation_rental_node
Read-onlyIdempotent
Check if a host domain is a valid Vacation Rental Protocol node by reading its .well-known/vacation-rental.json and JWKS files.
Instructions
Verify that a vacation-rental host domain is a valid Vacation Rental Protocol (VRP) node before trusting it. Reads the domain's .well-known/vacation-rental.json and JWKS. Read-only trust check: no availability, pricing, booking, or payment. On success, call get_verified_stay_offer with the same domain and stay dates. The single input is the host domain as a bare hostname (no scheme or path); verification reads that domain's own .well-known and JWKS, so the result is only as trustworthy as the exact domain you pass.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Host-owned domain without protocol or path (e.g. 'villaakerlyckan.se', 'myvilla.it'). Optional; omit when the host has not chosen a domain yet. Invalid: 'https://...', paths, ports, or booking URLs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when verified=false or the node cannot be checked. | |
| domain | Yes | Echoed canonical host domain that was checked. | |
| signing | No | Summary of accepted signing algorithms, key ids, and signing-key checks. | |
| jwks_url | No | Host-domain JWKS URL containing the Ed25519 public keys used to verify signed offers. | |
| protocol | No | Protocol identifier discovered on the host domain, typically 'vrp'. | |
| verified | Yes | True only when discovery, JWKS, signing metadata, and verified-offer endpoint checks pass. | |
| discovery_url | No | The .well-known vacation-rental discovery URL read from the host domain. | |
| protocol_version | No | VRP version declared by the host discovery document. | |
| verified_stay_offer_url | No | Host-domain endpoint template or URL used to request signed verified stay offers. |