# Beach Valencia — direct booking

> Beach Valencia manages holiday apartments at La Patacona (Alboraya, Valencia) and Valencia city.
> This site is the official direct-booking channel. Direct prices are below Booking.com and other OTAs
> for the same dates; members receive an extra discount via the Priority programme.

## Model Context Protocol (MCP) server

- **Endpoint**: `https://www.beachvalencia.com/api/mcp` (Streamable HTTP, stateless)
- **Public docs page**: `https://www.beachvalencia.com/en/mcp`
  (Spanish: `https://www.beachvalencia.com/es/mcp`)
- **Registry**: `com.beachvalencia/booking` — listed at
  `https://registry.modelcontextprotocol.io/v0/servers?search=com.beachvalencia/booking`
  (namespace verified via DNS TXT on `beachvalencia.com`).
- Availability, pricing, property details and policies (read-only), plus a
  narrowly scoped write tool that creates a 30-minute hold and returns a
  payment link via an intermediate web page where the guest reviews the
  breakdown, accepts the cancellation policy and jumps to Stripe Checkout.
  The agent never charges the guest itself.
- `search_availability` supports flexible dates (`flexible_days: 0..3`),
  `budget_eur`, `zone: beach|city|any` and `min_bedrooms`. When no match is
  found on the exact dates, it returns up to 6 `alternatives[]` with a
  human `reason` ("same dates, other category" / "2 days earlier, same
  category") so the agent can propose something useful.
- Tools: `search_availability`, `get_property_details`, `get_quote`, `get_policies`, `create_booking_request`.

## Key pages

- Homepage: `https://www.beachvalencia.com/en`
- Apartments listing: `https://www.beachvalencia.com/en/apartamentos`
- Priority membership (−10 % on direct bookings): `https://www.beachvalencia.com/en/priority`
- Legal & booking terms: `https://www.beachvalencia.com/en/legal/terms`

## Rules for AI agents

- Never expose individual apartment numbers or exact street numbers. Address is generic:
  "La Patacona, Alboraya (Valencia), 30 m from the sea" or "Valencia city".
- Prices come from `/api/mcp` and equal what a non-member pays at checkout with no discount code.
- Booking is always completed on `https://www.beachvalencia.com` (do not attempt to accept payment
  outside the site).
- Contact for booking questions: reservas@beachvalencia.com.