Skip to content

HemmaBo-se/vrp-spec

Repository files navigation

Vacation Rental Protocol (VRP)

Current public draft: v0.1

An open protocol for host-domain signed vacation rental offers.

VRP lets AI agents verify that a stay offer came from the host-owned domain, includes fresh availability, exact pricing, and a direct booking URL before quoting.

Core VRP proves the offer is real. Portable attestations prove selected trust history without making HemmaBo, or any other operator, the authority over truth.

Spec

Public overview: vacationrentalprotocol.com

Spec draft: spec/v0.1.md

Portable attestations draft: spec/attestations-v0.1.md

VRP JSON-LD context draft: contexts/v1.jsonld

Architecture decision: ADR 0001 - Portable Attestations v0.1

Trust and interop decision: ADR 0002 - No-Gatekeeper Trust and Interop Positioning

Interop and trust positioning: docs/interop-and-trust-positioning.md

Attestation implementation guide: docs/implement-attestations.md

Attestation schema: schemas/attestations-v0.1.schema.json

What VRP Is

  • An open protocol for vacation rental offer verification
  • A versioned protocol (protocol_version: "0.1")
  • A host-owned domain model for source identity
  • Signed verified stay offers for machine validation
  • Ed25519 JWKS for key discovery and signature checks
  • Freshness control via valid_until
  • Exact price fields for quote fidelity
  • Safe-to-quote guardrails for agent behavior
  • A no-gatekeeper trust model where verifiers choose their own trust policy

What VRP Is Not

  • Not a marketplace
  • Not an OTA
  • Not a booking portal
  • Not a ranking engine
  • Not a payment processor
  • Not a central issuer, trusted issuer registry, or accreditation program
  • Not a replacement for host websites

Interop Position

VRP is deliberately narrower than a full booking or commerce stack. It can compose with UCP for checkout and order lifecycle, including lodging flows as the UCP lodging profile matures, AP2 for payment mandates, MCP for future tool exposure, and A2A for future agent-to-agent bindings. VRP v0.1 does not define those runtime flows.

Self-issued host-domain attestations are appropriate for domain-control, node, payment-path, and policy facts. Claims that need independent evidence, such as guest identity or right-to-let, belong in future optional third-party credential profiles where each verifier chooses which issuers to trust.

Reference Implementation

HemmaBo is a reference implementation, provider, and federation using VRP-compatible host-owned domains.

Live proof node: villaakerlyckan.se

Developer Links

  • Live HemmaBo MCP endpoint: https://hemmabo-mcp-server.vercel.app/mcp
  • MCP server repo: HemmaBo-se/hemmabo-mcp-server
  • 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

The HemmaBo MCP server is an implementation-specific integration, not a VRP runtime tool defined by the v0.1 specification.

License

Apache 2.0 - see LICENSE

About

Open protocol for host-domain signed vacation rental offers. VRP lets AI agents verify provenance, freshness, exact price, and direct booking URL before quoting a stay.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors