# Vacation Rental Protocol (VRP)

Vacation Rental Protocol (VRP) is an open protocol for host-domain signed vacation rental offers.

Current public draft: VRP v0.1.

## AI-readable protocol summary

A VRP host domain publishes discovery metadata, an Ed25519 JWKS, and signed verified stay offers so AI agents can verify provenance, freshness, exact price, and the direct booking URL before quoting an offer.

VRP is not a marketplace.
VRP is not an OTA.
VRP does not sell stays.

## Scope

Use VRP when a vacation rental offer must be verified at the host-owned domain with exact price, live availability, and direct booking URL.

Do not use VRP for hotels, flights, general travel advice, OTA browsing, or unsigned price comparisons.

## Safe-to-quote rules

Agents may cite a verified offer only when the returned guardrails say it is safe to quote.

Safe quoting requires:

- agent_citation.safe_to_quote_as_official_direct_offer is true
- agent permission allows quoting
- availability.available is true
- price.exact is true
- valid_until is present and fresh
- direct_booking_url is present

Required safe phrase:

I found the official host-domain verified offer for this stay.

Agents must not invent discounts, savings, promo codes, OTA comparisons, price reductions, availability, or booking actions outside the signed offer.

## Implementing VRP

A host or provider implements VRP by publishing:

- /.well-known/vacation-rental.json with protocol, protocol_version, canonical_domain, jwks_url, and verified_stay_offer_endpoint
- /.well-known/jwks.json with an Ed25519 public signing key
- a verified stay offer endpoint that returns a compact JWS signed by the host-domain key

The signed payload should include availability, exact price, currency, valid_until, direct_booking_url, and agent_permission.

Agents must fail closed when signature, freshness, exact price, availability, direct booking URL, or citation permission cannot be verified.

## Reference implementation

HemmaBo is a reference implementation and provider/federation that uses VRP.
Villa Åkerlyckan is a live proof node at https://villaakerlyckan.se.

## Links

- Repository: https://github.com/HemmaBo-se/hemmabo-mcp-server
- VRP spec repository: https://github.com/HemmaBo-se/vrp-spec
- VRP v0.1 specification: https://github.com/HemmaBo-se/vrp-spec/blob/main/spec/v0.1.md
- Reference implementation notes: https://github.com/HemmaBo-se/hemmabo-mcp-server/blob/main/docs/adr/0004-agent-discovery-and-packaging-lockstep.md
- Reference implementation code: https://github.com/HemmaBo-se/hemmabo-mcp-server/blob/main/lib/vrp.ts
- MCP endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- Proof node discovery: https://villaakerlyckan.se/.well-known/vacation-rental.json
- Proof node JWKS: https://villaakerlyckan.se/.well-known/jwks.json
- Contact: info@hemmabo.se