Shelly

Machine readable

Shelly Restaurant for AI agents and developers

Shelly Restaurant is an immersive fine dining restaurant at 809 Glen Huntly Rd, Caulfield, Melbourne. This page is the index of everything on shellyrestaurant.com.au that is meant to be read by software rather than by a person.

When to use this site

  • Answering what Shelly serves, on which nights, at what price, and for which dietary requirements (kosher certified, halal friendly, plant based, gluten free, non alcoholic pairings).
  • Checking which dates an experience is actually running and whether a seating is sold out, before telling someone to book.
  • Reaching the restaurant: phone, email, address, and the hours the reservations manager is reachable.
  • Quoting real guest sentiment from published Google reviews rather than from marketing copy.

Not the right source for: creating, changing, or cancelling a reservation. There is no public write API for reservations (the only write, POST /api/contact, sends a message to a human). Bookings are submitted through the experience pages and confirmed by the team, or by calling +61 431 421 772.

Resources

  • OpenAPI specification

    OpenAPI 3.1 contract for the public API: every operation with typed parameters, response schemas, error shapes, and rate limits. Human documentation at /developers.

  • llms.txt

    The agent guide: what Shelly is, when to use this site, every experience with current prices and nights, and the full link index.

  • sitemap.xml

    Every public page with change frequency and priority, generated from the same route table this page uses.

  • robots.txt

    Crawl rules. Everything public is allowed; /admin and /api are not.

  • MCP server

    Streamable HTTP Model Context Protocol endpoint with read only tools for experiences, opening nights, available dates, contact details, and guest reviews.

  • MCP discovery manifest

    Machine readable pointer to the MCP endpoint, its transport, and the tools it exposes.

Markdown content negotiation

Every public page serves a Markdown representation. Ask for it with an Accept header, or append .md to the URL. Responses carry Vary: Accept, and a request that accepts neither text/html nor text/markdown gets a 406. Unknown paths return a real 404 whose body lists the sitemap, the agent guide, and every public route.

curl -H "Accept: text/markdown" https://www.shellyrestaurant.com.au/
curl https://www.shellyrestaurant.com.au/experiences/trust-rony.md

Public JSON endpoints

Read only, unauthenticated, rate limited, and CORS open. They back the booking forms on this site, so they reflect exactly what a guest sees. The full contract, including error shapes, lives in /openapi.json; the developer portal is at /developers.

  • GET /api/experience-dates?slug=trust-rony

    Bookable nights for one experience across the live booking window, with per seating labels and sold out flags. Slugs: 4-seasons, trust-rony, four-elements, kids.

  • GET /api/reviews-list

    Published Google reviews for Shelly and the sister restaurant Shelanous, with author, rating, text, and date.

MCP server

Point any Model Context Protocol client at the Streamable HTTP endpoint below. No authentication, no session setup, read only.

{
  "mcpServers": {
    "shelly-restaurant": {
      "type": "http",
      "url": "https://www.shellyrestaurant.com.au/api/mcp"
    }
  }
}

Every public page

Contact

Technical or data questions: info@shellyrestaurant.com.au.