{"schema_version":"1.0","name":"The Lodge @ East Neuk Orchards, Fife","type":"VacationRental","property_id":"eastneukorchards.co.uk","official_website":"https://eastneukorchards.co.uk/","description":"Owner-managed self-catering holiday let near Elie. Sleeps 4, dog-friendly. Bookable directly by AI agents with owner approval. No commission.","documentation":"https://eastneukorchards.co.uk/llms.txt","human_documentation":"https://lodge.eastneukorchards.co.uk/connector.html","authentication":"none","currency":"GBP","amounts_in":"pence","pricing_source":{"rates":"local","quote_authority":"bookrail","note":"Prices come from this property's published rate table, maintained in the booking engine — not pulled from an external property management system."},"property":{"sleeps":4,"bedrooms":2,"bathrooms":2,"pets_allowed":true,"max_dogs":2,"address_region":"Fife","postal_code_area":"KY10","country":"GB","amenities":["wifi","parking"],"dog_fees":{"first_dog_pence":3500,"second_dog_pence":3500,"basis":"per dog, per stay"},"address_locality":"Gillingshill, Pittenweem","nearest_town":"Anstruther"},"traversal":[{"step":1,"purpose":"Find which dates are open","method":"GET","url":"https://lodge.eastneukorchards.co.uk/availability","api_equivalent":"https://lodge.eastneukorchards.co.uk/api/availability","parameters":{"from":"ISO date","to":"ISO date"},"example":"https://lodge.eastneukorchards.co.uk/availability?from=2026-11-18&to=2027-11-18","no_parameters":"https://lodge.eastneukorchards.co.uk/availability with no parameters returns every open range from today to the booking horizon.","returns":"Array of open ranges. start = earliest check-in, end = latest check-out.","next":2},{"step":2,"purpose":"Price a specific stay","method":"GET","url":"https://lodge.eastneukorchards.co.uk/quote","api_equivalent":"https://lodge.eastneukorchards.co.uk/api/quote","parameters":{"checkin":"ISO date","checkout":"ISO date","guests":"integer 1-4","dogs":"integer 0-2, optional"},"pattern":"https://lodge.eastneukorchards.co.uk/quote?checkin=YYYY-MM-DD&checkout=YYYY-MM-DD&guests=N&dogs=N","fill_in":"A pattern, not a link. Put the guest's own stay in place of the capitals: the two dates as YYYY-MM-DD (the second is the morning they leave), guests as a number, dogs as a number (0 for none).","without_url_building":"If you can only open links you have been given, you cannot use the pattern. Read the price from the dated pages instead: https://lodge.eastneukorchards.co.uk/stays","returns":"total, deposit, per-band breakdown. Never compute prices yourself.","errors":{"no_rate":"Date is outside the published rate table. Do not estimate. Refer the guest to the owner."},"next":3},{"step":3,"purpose":"Get a cryptographically signed price you can verify (optional)","method":"GET","url":"https://lodge.eastneukorchards.co.uk/signed-offer","alias_url":"https://lodge.eastneukorchards.co.uk/offer","api_equivalent":"https://lodge.eastneukorchards.co.uk/api/signed-offer","mcp_tool":"get_signed_offer","parameters":{"check_in":"ISO date","check_out":"ISO date","guests":"integer 1-4","dogs":"integer 0-2, optional"},"parameter_synonyms":{"check_in":"checkin","check_out":"checkout","guests":"adults"},"pattern":"https://lodge.eastneukorchards.co.uk/signed-offer?check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&guests=N&dogs=N","fill_in":"A pattern, not a link. Put the guest's own stay in place of the capitals: the two dates as YYYY-MM-DD (the second is the morning they leave), guests as a number, dogs as a number (0 for none).","returns":"The offer in clear plus signature.jws — an Ed25519 compact JWS (alg EdDSA) over it. Prices are identical to step 2 for the same inputs.","verify":{"jwks_url":"https://lodge.eastneukorchards.co.uk/.well-known/jwks.json","algorithm":"EdDSA (Ed25519)","ttl_hours":24,"helper_endpoint":"https://lodge.eastneukorchards.co.uk/offer/verify"},"errors":{"no_rate":"Date is outside the published rate table. Do not estimate. Refer the guest to the owner.","signing_unavailable":"Offer signing is not configured on this server. /quote still works."},"next":4},{"step":4,"purpose":"Request the dates (does not confirm)","method":"POST","url":"https://lodge.eastneukorchards.co.uk/api/hold","mcp_tool":"request_booking","human_url":"https://lodge.eastneukorchards.co.uk/hold","human_handoff":"If you cannot submit a booking request, offer a ready-to-send booking form. Ask for the guest count, dog count, full name, email and phone if missing. Use only details the guest explicitly supplies for this booking; never infer them from account information. Keep checkin, checkout, guests and dogs in the /hold link query. Append #guest_name=URL_ENCODED_NAME&email=URL_ENCODED_EMAIL&phone=URL_ENCODED_PHONE (optionally &message=URL_ENCODED_MESSAGE). Percent-encode each value separately, including + as %2B, & as %26 and # as %23. Personal details belong after #, never in the query before it. Give this as a clickable link labelled \"Review and send booking request\"; do not fetch the personalised link yourself. Explain that opening it fills the form but sends no request: the guest reviews the price, terms and details, then clicks Send booking request. The link contains their details, so they should not share it. JavaScript is required for contact prefill; manual entry remains available. Never claim a request was sent merely because you generated the link.","required":["checkin","checkout","guests","guest_name","email","phone"],"optional":["dogs","message","idempotency_key"],"returns":"48-hour hold, plus hold_id and status_token for get_booking_status / GET /api/hold/{id}/status?token=. Owner is notified and approves or declines.","next":5},{"step":5,"purpose":"Owner approval, then payment","actor":"human","description":"The owner approves or declines. On approval the guest receives a Stripe Checkout link for the 25% deposit (the full amount for stays within the balance window); get_booking_status returns the same link. The booking is confirmed only once that payment is made.","terms":{"cancellation_policy":"Cancellations must be made in writing, preferably by email. The owners will try to re-let the dates: if they re-let all or part of the stay, they refund what the new booking brings in, less a £35 administration fee. If the dates cannot be re-let, the deposit is not refundable, and nor is the balance once it has been paid. Travel insurance that covers cancellation is strongly recommended.","payment_schedule":"Nothing is paid when you send a request. If the owner approves, you pay a 25% deposit to secure the dates and the balance is due 6 weeks (42 days) before arrival. For stays starting within 6 weeks (42 days), the full amount is paid on approval.","payment_security":"Payment is by card through Stripe’s secure checkout; card details never reach us. Paying by card keeps your card protections (chargeback, and Section 75 cover on eligible credit card payments). We will never ask you to pay by bank transfer."},"next":null}],"prices_by_date":{"note":"Plain pages with live availability and exact totals from the same engine as /quote. No parameters, no URL to build: open the index, follow the link for the month, then the day.","index":"https://lodge.eastneukorchards.co.uk/stays"},"trust":{"signed_offers":true,"signing_algorithm":"EdDSA (Ed25519)","offer_transport":"compact JWS","jwks_url":"https://lodge.eastneukorchards.co.uk/.well-known/jwks.json","traversal_manifest":"https://lodge.eastneukorchards.co.uk/.well-known/agent-traversal.json","offer_ttl_hours":24,"note":"A signed offer is a price guarantee, not a confirmed booking. Owner approval is always required."},"mcp":{"endpoint":"https://lodge.eastneukorchards.co.uk/mcp","transport":"streamable-http","authentication":"none","access":"public — no registration or connector required","robots_note":"robots.txt disallows /api/ and /mcp for crawlers indexing the site. Direct agent requests and MCP tool calls are not crawls and are not governed by it.","tools":["check_availability","get_quote","get_signed_offer","request_booking","get_booking_status","get_property_facts","send_enquiry"]},"guest_questions":{"note":"The owner's own answers, verbatim. Quote them; never extend them. For anything not listed, do not guess: give the guest an ask_owner link with their question, and their dates, guests and dogs in their own fields (not only in the question text).","live_url":"https://lodge.eastneukorchards.co.uk/facts","answered":[{"key":"dogs","question":"Are dogs allowed, how many, any fee?","answer":"Yes, up to 2 dogs, £35 per dog per stay. Dogs can use about 10 acres of wooded grounds and orchards, and Gillingshill Reservoir and Nature Reserve is across the road. Dogs must be well behaved and stay off the furniture and out of the bedrooms. There is an outdoor hose for muddy coats, and dog towels are provided."},{"key":"parking","question":"Where do we park, how many cars?","answer":"Parking on the drive."},{"key":"ev_charging","question":"Is there EV charging nearby or on site?","answer":"Yes, there is EV charging."},{"key":"checkin_time","question":"What time is check-in and check-out?","answer":"Check-in is from 4pm and check-out is by 10am."},{"key":"key_access","question":"How do we get in (key safe, lockbox, met)?","answer":"Self check-in, with the key in a keysafe."},{"key":"beds","question":"What is the bed configuration?","answer":"One king, one twin."},{"key":"baby_kit","question":"Is there a cot and highchair?","answer":"Yes, a cot and a highchair are available."},{"key":"wifi","question":"Is there Wi-Fi, and how fast?","answer":"Yes, there is wifi."},{"key":"heating","question":"What heating is there (incl. wood burner)?","answer":"The houses are heated by a community biomass boiler. There is also a log burner or open fire."},{"key":"outdoor","question":"Is there a garden or outdoor space; is it enclosed?","answer":"Guests have access to the grounds and orchards. The Lodge has a private outdoor patio for al-fresco dining."},{"key":"laundry","question":"Is there a washing machine / dryer?","answer":"Yes: dishwasher, washing machine, tumble dryer."},{"key":"nearby","question":"How far to the nearest pub, shop, beach or walks?","answer":"Gillingshill is in the East Neuk of Fife: Pittenweem is 5 miles away, St Monans 5, Anstruther and Elie 6, Crail and St Andrews 9. Kellie Castle is 2 miles away and the Fife Coastal Path 5 miles."},{"key":"min_stay","question":"Minimum stay and changeover day?","answer":"3 nights minimum, with any arrival day. Bookings need at least 1 day's notice."},{"key":"cancellation","question":"What is the cancellation policy?","answer":"Cancellations must be made in writing, preferably by email. The owners will try to re-let the dates: if they re-let all or part of the stay, they refund what the new booking brings in, less a £35 administration fee. If the dates cannot be re-let, the deposit is not refundable, and nor is the balance once it has been paid. Travel insurance that covers cancellation is strongly recommended."},{"key":"extras","question":"Any extra fees (cleaning, deposit, levy)?","answer":"Cleaning is included. Dogs are £35 per dog per stay."}],"ask_owner":{"url_template":"https://lodge.eastneukorchards.co.uk/ask{?question,checkin,checkout,guests,dogs}","example":"https://lodge.eastneukorchards.co.uk/ask?question=Can+we+check+in+at+1pm%3F&checkin=2027-01-02&checkout=2027-01-09&guests=6&dogs=1","stay_fields":"Put any dates, party size and dogs the guest mentioned in checkin, checkout, guests and dogs — not only in the question.","holds_dates":false,"reply":"by email, from the owner","mcp_tool":"send_enquiry"}},"booking_rules":{"deposit_percent":25,"balance":"remaining 75% due before arrival","changeover_day_peak":"any","min_nights_peak":3,"changeover_day_offpeak":"","min_nights_offpeak":"3","approval_required":true,"approval_typical_response":"same day","instant_confirmation":false,"dog_fee_note":"GBP 35 per dog, per stay, applied automatically by /quote."},"payment":{"processor":"Stripe Checkout","methods":["card"],"merchant_of_record":"property owner","commission":"none"},"constraints":{"endpoints_that_do_not_exist":["/api/search","/api/book","/api/prices","/api/availability/all"],"never":["state a price that did not come from /quote (or its /api/quote equivalent) or a dated price page under /stays","tell a guest a booking is confirmed before owner approval and deposit payment","expose or infer details of existing bookings"],"rate_limits":{"reads":"60 per hour per IP","booking_requests":"3 per day per IP"}},"contact":{"owner":"Lisa and Duncan Kennedy","website":"https://eastneukorchards.co.uk","booking_service":"https://lodge.eastneukorchards.co.uk","email":"lisa@gillingshill.co.uk","phone":"07980 286179"},"infrastructure":{"provider":"Bookrail","url":"https://bookrail.co.uk"},"booking_horizon":{"policy":"Bookings are released on a rolling basis, about 12 months ahead.","bookings_open_to":"2027-11-18"}}