Developers
Build with the house
Everything the site does, a program can do too: read the menu, check a night, book, change or cancel a table.
REST API
The public API
The website itself runs on this API: JSON over HTTPS under /api/v1, described by an OpenAPI 3.1 document generated from the code. The documentation page lets you read every endpoint and try it.
For AI assistants
The MCP server
Assistants such as Claude can check availability and book, view, change or cancel a table for a guest through the Model Context Protocol. The server is a client of the same public API, so every rule that applies on this site applies to an assistant too.
- Endpoint
/mcp- Transport
- Streamable HTTP
- Authentication
- A bearer token issued by the restaurant
Tools
get_restaurant_info- Address, opening hours, contact details, reservation rules and awards.
get_menu- The menu in English, Italian, Spanish or French, with prices, calories, allergens and advisories.
check_availability- The free times on a date, with the number of open tables.
book_table- Books a table and returns the confirmation code; safe to retry.
lookup_reservation- Shows a booking from its code and the email it was made with.
modify_reservation- Changes the time or the party size.
cancel_reservation- Cancels a booking (the assistant asks the guest to confirm first).
subscribe_newsletter- Signs a guest up for the seasonal letter.
Both work against the same fictional restaurant as this site: bookings are demonstrations only.
Versions
What is running
- Website
6.0.2 · 00237aa- API
checking…- MCP server
checking…- Database schema
checking…