{"contract":"Agent Reception Layer","contractVersion":"1.0.0","canonicalSite":"https://www.groundupbjj.com","discovery":{"manifest":"https://www.groundupbjj.com/.well-known/agent.json","actionMap":"https://www.groundupbjj.com/api/agent/discovery","llms":"https://www.groundupbjj.com/llms.txt","crawlerGuidance":"https://www.groundupbjj.com/crawlers.json"},"business":{"name":"Ground Up Jiu-Jitsu & Fitness","description":"A women-only training center in Oxnard for Brazilian Jiu-Jitsu, practical self-defense, strength, and movement, with beginner-friendly coaching.","languages":["en","es"],"scheduleSource":"Ground Up's class schedule synchronized from Google Calendar.","timezone":"America/Los_Angeles","locations":[{"name":"Ground Up Jiu-Jitsu & Fitness","streetAddress":"2364 Sturgis Rd, Unit A, Oxnard, CA 93030","addressLocality":"Oxnard","addressRegion":"CA","postalCode":"93030","addressCountry":"US"}],"serviceArea":[{"type":"City","name":"Oxnard","region":"California","country":"US"}],"services":["Brazilian Jiu-Jitsu","Practical self-defense","Strength and movement classes"]},"supportedClients":{"access":"Public HTTPS and JSON; no MCP server or provider API key is required.","compatibleWith":["ChatGPT","Muse","Claude","Gemini","generic browser agents"]},"actions":[{"id":"schedule.read","method":"GET","path":"/api/agent/schedule","requiresAuth":false,"requiresReceptionSession":false,"confirmationRequired":false,"requiredFields":[],"optionalFields":["from","to","locale"],"idempotency":{"required":false,"behavior":"Read-only; repeated requests return current public schedule data."},"successStates":["schedule_returned"],"errorStates":[{"code":"validation_failed","httpStatus":400},{"code":"rate_limited","httpStatus":429},{"code":"temporarily_unavailable","httpStatus":503}]},{"id":"reception.session.create","method":"POST","path":"/api/agent/reception/sessions","requiresAuth":false,"requiresReceptionSession":false,"confirmationRequired":false,"requiredFields":["intent","requestedAction"],"optionalFields":["locale","agentPlatform"],"idempotency":{"required":false,"behavior":"Each successful request creates a new opaque session with a 15-minute expiry."},"successStates":["session_created"],"errorStates":[{"code":"validation_failed","httpStatus":400},{"code":"rate_limited","httpStatus":429},{"code":"temporarily_unavailable","httpStatus":503}]},{"id":"reservation.create","method":"POST","path":"/api/agent/reservations","requiresAuth":false,"requiresReceptionSession":true,"sessionHeader":"X-Agent-Reception-Session","confirmationRequired":true,"requiredFields":["occurrenceId","firstName","lastName","email","phone","confirmation.confirmed","confirmation.occurrenceId","Idempotency-Key header"],"optionalFields":["experience","locale"],"idempotency":{"required":true,"header":"Idempotency-Key","behavior":"Same-key, matching requests replay the original result; a reused key with different visitor or class details is rejected. A second active reservation for the same person and class is prevented by Ground Up's booking transaction."},"successStates":["confirmed","waitlisted"],"errorStates":[{"code":"confirmation_required","httpStatus":428},{"code":"validation_failed","httpStatus":400},{"code":"session_required","httpStatus":428},{"code":"session_expired","httpStatus":410},{"code":"slot_unavailable","httpStatus":409},{"code":"duplicate_prevented","httpStatus":409},{"code":"idempotency_conflict","httpStatus":409},{"code":"human_review_required","httpStatus":409},{"code":"rate_limited","httpStatus":429},{"code":"temporarily_unavailable","httpStatus":503}]}],"reservationScope":{"description":"Creates one first-visit-eligible class reservation using Ground Up's existing server-side eligibility, capacity, duplicate, waitlist, and idempotency checks.","doesNotCreate":["A member account","A Discovery Pass","A membership or payment","A waiver acceptance","A youth/girls class reservation; staff must review those requests."],"confirmationInstruction":"Before a write, show the selected class date, local time, location, and the submitted participant details; obtain an explicit affirmative response for that exact class and require confirmation. Do not infer confirmation from an earlier general request.","successStates":["confirmed","waitlisted"],"waitlistNote":"A waitlisted result is not a confirmed seat."},"privacy":{"sessionTtlSeconds":900,"capturedSessionMetadata":["intent","requestedAction","locale","consent state; explicit confirmation is recorded only for reservation writes","declared agent platform, if supplied","request User-Agent, if supplied","opaque session and correlation identifiers"],"identityVerification":"Declared agent identity is unverified unless trusted infrastructure validates it.","boundaries":["Reception sessions do not store names, email addresses, phone numbers, IP addresses, member records, or reservation records.","Booking confirmation state is not marketing consent, waiver acceptance, or account authorization.","Reservation input is sent to Ground Up's existing reservation system and is not returned in the response.","The public contract does not grant access to member, payment, administrative, or internal booking records."]},"humanFallback":{"scheduleAndBooking":"https://www.groundupbjj.com/schedule","freeClassInquiry":"https://www.groundupbjj.com/free-class","contact":"https://www.groundupbjj.com/contact","spanishContact":"https://www.groundupbjj.com/es/contacto","instruction":"Use the human schedule or contact form when eligibility is unclear, a class needs staff review, or the agent cannot obtain explicit confirmation."}}