# Reuben

> Reuben is a remote MCP (Model Context Protocol) server that lets AI agents discover real dining venues, check availability, book tables, and place takeout pickup orders on a guest's behalf. Connect once, then search venues, read a venue's booking rules, reserve a table, read a live menu, and order takeout. The venue owns every confirmation.

Reuben holds no booking logic of its own: it reads a live venue registry and either forwards a booking to each venue's own endpoint (adapter venues) or holds the book itself for venues Reuben hosts. Takeout orders are built from the venue's own live menu and land on the venue's own rails; payment is settled at the venue on pickup. There is no API key and no signup to connect. Bookings and takeout ordering are live today with real Melbourne venues; venue-side agents (negotiation on the venue's behalf, with a human signing the final yes) are in beta.

## Connect

- [MCP endpoint (Streamable HTTP)](https://www.heyreuben.ai/mcp): Add this URL to any MCP-compatible client (Claude, ChatGPT, Cursor, and others). Also reachable at https://www.heyreuben.ai/api/mcp.

## Tools

- find_venues: Search live Reuben venues by locality (`near`), feature tags (`features`), and booking rules (`large_group_behaviour`, `cancellation`). Returns {venue_id, name, suburb, features}. Call this first to discover venues.
- get_venue_details: Full profile for one venue by `venue_id`: name, address, phone, hours, booking rules, and features.
- get_booking_policies: A venue's booking rules before you commit: max instant party size, large-group handling, cancellation terms, and who to contact. Call before create_booking for parties over 8.
- get_availability: Open booking slots for a Reuben-hosted venue on a date — remaining capacity, service, and whether each slot confirms instantly. Venues that run their own diary say so honestly rather than inventing slots.
- create_booking: Request a table. Requires venue_id, date (YYYY-MM-DD), time (HH:MM, 24h), party_size, guest_name, guest_email, guest_phone. Returns confirmed, pending, unavailable (with re-checked alternatives), requires_human (routed to the venue's team), or a validation error.
- get_booking_status: Check a booking made earlier, using the client_reference plus the original booking details.
- get_menu: The orderable menu for a venue whose features include takeout — categories, items, variations, and prices from the venue's own point of sale.
- create_order: Place a takeout (pickup) order built from the venue's live menu. The guest gets a confirmation email; payment is settled at the venue on pickup. Returns an order_reference — save it to check the order later.
- get_order_status: Check a takeout order by its order_reference — received, preparing, ready, completed, or cancelled.
- cancel_order: Cancel a takeout order before the venue completes it. Payment is settled at pickup, so a cancelled order means nothing is owed.

## Live venues

- [Live venue list (JSON)](https://www.heyreuben.ai/api/venues): The authoritative, always-current list of venues bookable via Reuben (venue_id, name, suburb, city, features). Query this endpoint for the live set rather than relying on a snapshot.

## For venues

- [Reuben for venues](https://www.heyreuben.ai/for-venues): What Reuben does for a venue — agent bookings, takeout ordering via a connected Square account, separate services with their own rules, pause/resume ordering, and self-managed details and billing.
- [List your venue](https://www.heyreuben.ai/onboard): Self-serve onboarding — a venue goes live immediately, no account required.

## More

- [Tools & example prompts](https://www.heyreuben.ai/tools): The MCP tools with example prompts you can hand to your agent.
- [Home](https://www.heyreuben.ai/): Overview and connection instructions.