For agents & researchers
AI agents & MCP
Goldenhour is built for the post-search-engine internet. Every public surface is discoverable, structured, and agent-friendly : so when a customer asks ChatGPT or Claude “where can I book a spray tan in Miami Beach,” the artist’s page is ready to be found and booked.
Site map for LLMs
llms.txt
A hand-curated, prose map of the platform: what goldenhour is, what an artist's booking page looks like, where to find the AI-friendly endpoints. Agentic browsers pull this first to orient before crawling.
Per-tenant booking sitemap
booking-sitemap.xml
A flat list of every public booking page. Each entry uses the artist's most-branded URL: custom domain when active, slug subdomain otherwise. Lets crawlers enumerate every tenant without trying to scrape paginated lists.
Structured data per page
schema.org BeautySalon JSON-LD
Every public booking page emits a BeautySalon graph with nested Service + Offer + ReserveAction. Agents construct a working booking URL straight from the structured data: no DOM scraping required.
Public discovery manifest
MCP manifest
Describes the platform's MCP capability in one JSON document. Lists the per-tenant endpoint, the availability endpoint, contact + legal + privacy URLs, and the logo. CORS-permissive so agents on any host can read it.
Per-tenant summary
MCP tenant endpoint
Replace {tenant} with the booking slug (e.g. sobetan) or the account UUID. Returns the business profile, every public service with deep-link URLs, and a pointer to the availability endpoint. Cached 5 minutes.
- /api/mcp/{tenant}example: /api/mcp/sobetan
Availability for the next 14 days
MCP availability endpoint
GET /api/mcp/{tenant}/availability?service={serviceId}. Mirrors the booking page's slot computation exactly: business hours, time blocks, existing appointments, per-service available-days, drive-time buffers. Slots returned as UTC ISO strings plus the artist's IANA timezone so the agent can re-zone.
- /api/mcp/{tenant}/availabilityexample: /api/mcp/sobetan/availability?service=...
Quick share
QR code generator
Hot-link a PNG QR code pointing at any tenant's canonical booking URL. Drop in business cards, flyers, window stickers, or post-treatment thank-you cards. Optional size + fg + bg query params for brand-matched output.
- /api/qr/{tenant}example: /api/qr/sobetan?size=1024
Notes for agents
What’s out of scope
- The artist dashboard at
/app/*and the rest of/api/*are gated by Clerk auth. Don’t crawl them. - Booking writes happen through the booking page’s server action, not the MCP. The MCP returns deep-link URLs the agent can open for the customer to confirm.
- We respect every standard crawler control —
robots.txt,sitemap.xml,noindex. Customer PII is never on a public surface.