Skip to content
goldenhour
Back to help

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.

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.

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.

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.

More help articles