# Villa Åkerlyckan — Full AI Agent Context

> This document provides complete context for AI agents assisting guests
> with booking decisions for Villa Åkerlyckan.
> Document version: 2026-06-13T06:49:03.371Z

---

## Canonical State
- schema_version: 1.0.0
- entity_id: hb_prop_3ef1d46d
- canonical_domain: villaakerlyckan.se
- source_of_truth: true
- revision: ea3389d272cbecfee12afad550e77e8dfc9a299ff0bf391b7f3da3bddc040e65
- updated_at: 2026-06-13T06:45:04.505988+00:00

## 1. Property Overview

- **Name:** Villa Åkerlyckan
- **Domain:** villaakerlyckan.se
- **Booking URL:** https://villaakerlyckan.se
- **Type:** VacationRental / LodgingBusiness
- **Description:** This villa in Kävlinge features three bedrooms and one bathroom, accommodating
- **Max guests:** 6
- **Bedrooms:** 3
- **Bathrooms:** 1
- **Check-in:** 16:00
- **Check-out:** 11:00
- **Minimum nights:** 1
- **Pets:** Allowed

## Source of Truth Contract (SoT v1)

- canonical_domain: villaakerlyckan.se
- preferred_booking_url: https://villaakerlyckan.se/
- source_of_truth: true
- entity_id: hb_prop_3ef1d46d
- check_in_time: 16:00
- check_out_time: 11:00
- min_nights: 1
- currency: SEK
- from_price_per_night: 3400
- price_is_exact: true
- never_approximate: true
- price_source: property_price_blocks
- availability_endpoint: https://villaakerlyckan.se/api/availability
- booking_endpoint: https://villaakerlyckan.se/api/ai-gateway/checkout
- legacy_booking_endpoint: https://villaakerlyckan.se/api/book


## 2. Location

- **Address area:** Kävlinge, Skåne län, Sweden
- **Coordinates:** 55.7980888, 13.1691188
- **Map:** https://maps.google.com/?q=55.7980888,13.1691188

## 3. Amenities

- WiFi
- Hot tub / spabad
- Parking / parkering
- EV charger / elbilsladdare
- Bed linens included
- Towels included
- Breakfast included / frukost ingår
- Self check-in
- Pet-friendly / husdjursvänlig
- Crib / spjälsäng

## 4. Pricing

- **Currency:** SEK

Pricing for this property is canonical and per-quote. This llms-full.txt does NOT carry a price table — it would go stale on every Pricera update. Always query the canonical endpoint below for an exact quote on the dates you care about.

### Pricing API (machine-readable)

For exact quotes with specific dates, query:
  GET https://villaakerlyckan.se/api/pricing?check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&guests=N

Response includes: total price, per-night breakdown, season classification.
PRICE IS EXACT — never approximate, never interpolate.

## 5. Availability

- **iCal feed:** https://villaakerlyckan.se/calendar.ics (REFRESH-INTERVAL: PT4M)
- **Availability API:** https://villaakerlyckan.se/api/availability?checkIn=YYYY-MM-DD&checkOut=YYYY-MM-DD&guests=N

Blocked dates in the iCal feed represent confirmed bookings or manual host blocks.
Always check availability before presenting dates to a guest.

## 6. House Rules

- Check-in from 16:00
- Check-out by 11:00
- Minimum stay: 1 nights
- Pets allowed
- No smoking indoors
- Respect quiet hours (22:00–07:00)

## 7. Cancellation Policy

See the booking page for the current cancellation terms.

## 8. Booking Instructions (for AI agents)

### Option A: Direct URL (human-in-the-loop)
Guide the guest to: https://villaakerlyckan.se/?checkIn=YYYY-MM-DD&checkOut=YYYY-MM-DD&guests=N
The booking page pre-fills dates and guest count from URL parameters.

### Option B: Machine-readable booking API

1. **Search offers:**
   GET https://villaakerlyckan.se/api/ai-gateway/offers/search?checkIn=YYYY-MM-DD&checkOut=YYYY-MM-DD&guests=N

2. **Request quote / quote lock (optional):**
   POST https://villaakerlyckan.se/api/ai-gateway/offers/{offerId}/negotiate
   Body: { desiredTotalPrice: { currency: "SEK", amount: NNNN } }

3. **Checkout:**
   POST https://villaakerlyckan.se/api/ai-gateway/checkout
   Body: { offerId, checkIn, checkOut, guests, channel: "federation",
           agreedTotalPrice: { currency, amount }, quoteId,
           customer: { name, email, message, language } }

4. **Response includes:** reservationId, paymentUrl (Stripe Checkout), status
   → Redirect guest to paymentUrl for secure card payment

### MCP Protocol
Full MCP 1.1 manifest: https://villaakerlyckan.se/.well-known/mcp.json
Agent card: https://villaakerlyckan.se/.well-known/agent-card.json
UCP manifest: https://villaakerlyckan.se/.well-known/ucp
Tools: get_property_info, check_availability, negotiate_offer, checkout, cancel_booking, get_booking_status, reschedule_booking

## 9. Machine-Readable Endpoints

| Endpoint | Format | Purpose |
|----------|--------|---------|
| [/llms.txt](https://villaakerlyckan.se/llms.txt) | text/plain | AI-readable property summary |
| [/llms-full.txt](https://villaakerlyckan.se/llms-full.txt) | text/plain | This document (full context) |
| [/api/pricing](https://villaakerlyckan.se/api/pricing) | JSON | FDP/2.0 pricing + availability |
| [/api/availability](https://villaakerlyckan.se/api/availability) | JSON | Date availability check |
| [/api/property-info](https://villaakerlyckan.se/api/property-info) | JSON | Canonical property data |
| [/calendar.ics](https://villaakerlyckan.se/calendar.ics) | iCal | Availability calendar feed |
| [/.well-known/vacation-rental.json](https://villaakerlyckan.se/.well-known/vacation-rental.json) | JSON | Federation feed |
| [/.well-known/ucp](https://villaakerlyckan.se/.well-known/ucp) | JSON | UCP profile |
| [/.well-known/mcp.json](https://villaakerlyckan.se/.well-known/mcp.json) | JSON | MCP 1.1 manifest |
| [/.well-known/agent-card.json](https://villaakerlyckan.se/.well-known/agent-card.json) | JSON | Agent card alias |
| [/.well-known/ai-plugin.json](https://villaakerlyckan.se/.well-known/ai-plugin.json) | JSON | Plugin manifest |
| [/.well-known/openapi.yaml](https://villaakerlyckan.se/.well-known/openapi.yaml) | YAML | OpenAPI 3.0 spec |
| [/sitemap.xml](https://villaakerlyckan.se/sitemap.xml) | XML | Sitemap with all endpoints |

## 10. Property Images

> Host attestation: 0 of 10 images confirmed by host. A leading ✓ marks host-attested images.

1. https://villaakerlyckan.se/ — Villa Åkerlyckan – exterior in Kävlinge
2. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
3. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
4. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
5. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
6. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
7. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
8. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
9. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge
10. https://villaakerlyckan.se/ — Villa Åkerlyckan – interior in Kävlinge

## 12. Local Context (geographic facts)

> Distances below are computed from public open data (Wikidata and
> OpenStreetMap) using the property's coordinates. They are objective
> geographic facts, NOT host claims. Use them to ground recommendations.

- **Nearest beach / coastline:** 13 km
- **Nearest commercial airport:** 11 km — Eslov Airport
- **Nearest train station:** 40 km — Tårnby Station

### Top attractions within 10 km (by distance)

- Viderup Castle (castle) — 7.7 km [source: wikidata]
- Q29474592 (castle) — 9.7 km [source: wikidata]
- Eslövs leksaksmuseum (museum) — 9.8 km [source: wikidata]
- Q31899427 (museum) — 9.8 km [source: wikidata]
- Borgeby Castle (castle) — 9.8 km [source: wikidata]

> Cache status: hit (fetched 2026-06-07T07:27:37.706+00:00)

## Trust & Verification

- Booking protection: Vera™ (booking lock prevents race conditions)
- Calendar sync: Guarda™ (live availability truth with automatic external calendar sync)
- Smart pricing: Pricera™ (floor price enforced, dynamic pricing additive only)
- Media: Pixora™ (responsive images, watermark, AI-generated descriptions)
- Payment: Stripe (PCI-compliant, direct to host — 0% platform commission)

---
Generated: 2026-06-13T06:49:03.372Z
Source: HemmaBo direct-booking infrastructure — https://villaakerlyckan.se