# Loyalist Reservations

> Book tables at restaurants on the Loyalist network. No login; read availability, then book.

- name: com.eatloyalist/restaurant-reservations
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 85/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.eatloyalist%2Frestaurant-reservations
- tools: https://api.protogrid.dev/v1/servers/com.eatloyalist%2Frestaurant-reservations/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "restaurant-reservations": {
      "type": "http",
      "url": "https://agent.eatloyalist.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 45
- drivers: +dns-namespace +reachable +uptime-100% +updated-7d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 2 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 5 of 5 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,796 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 5, about 1,796 tokens to load them all
- tool set hash: 2e6955d2ad623028f5215304f8763199
- tools last changed: 2026-10-20T01:59:10.355Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.eatloyalist/restaurant-reservations.svg)](https://protogrid.dev/servers/com.eatloyalist/restaurant-reservations)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-20 `join_waitlist` changed (annotations)
- 2026-10-20 `get_reservation` changed (annotations)
- 2026-10-20 `book` changed (annotations)
- 2026-10-20 `get_availability` changed (annotations)
- 2026-10-20 `find_venues` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.eatloyalist%2Frestaurant-reservations/changes

## Remotes

- https://agent.eatloyalist.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (5)

- `book`: Book a table. This takes a real table at a real restaurant.

        Pass a `slot_id` from get_availability. Confirm the venue, date, time and party size
        with the person before calling this, and do not call it speculatively: there is no
        cancel tool, so a booking made by mistake has to be undone by the guest phoning the
        restaurant.

        Calling it twice with identical arguments is safe and returns the same reservation
        rather than taking a second table. Changing the slot or the guest makes it a
        different booking, so re-read availability rather than editing the arguments to
        "retry".

        `phone` is optional here but required by some venues; omitting it can come back as
        `guest_field_required`. `note` reaches the restaurant as the reservation's note.

        `source` is where you found this venue: if the restaurant's own website told you a
        value to pass (in its markup or llms.txt), send it here so the restaurant can see its
        own site drove the booking. Leave it out if you did not arrive through one.

        `reservation_id` is for your own use, to read the booking back with get_reservation.
        It is not a confirmation number the venue knows, so do not read it out to the guest:
        tell them the restaurant, date, time and party size instead.
        
- `find_venues`: Restaurants bookable through this network, and what each one's system supports.

        Returns every venue that has opted in, across restaurant groups. Two optional filters
        narrow it, never widen it: `signup_form_id` to one website's venues when you found a
        Loyalist signup embed on a restaurant's page, and `venue_id` to a single venue when
        you already have its loyalist-venue-id (off a page's markup or a ReserveAction entry
        point) and want just that one rather than listing them all and matching yourself.
        Neither can reach a venue that has not opted in.

        A venue with `bookable: false` has no reservation system connected and will return
        no availability.
        
- `get_availability`: Bookable times at one venue, on one date, for one party size.

        `date` is the venue's own local calendar date, `YYYY-MM-DD`. Each slot carries a
        `slot_id` to pass to book and a `starts_at` that is a full venue-local datetime, so
        a service running past midnight is unambiguous without you having to infer the day.

        An empty `slots` list means nothing is open on those terms, not that the venue is
        closed. Try a different time, party size or date before telling someone it is full.
        
- `get_reservation`: Read one booking this credential made back from the venue.

        Use it to confirm a booking landed. A `status` of `pending` means the venue has not
        answered yet, not that it failed; treat anything you do not recognise as
        non-terminal rather than reporting a failure.
        
- `join_waitlist`: Ask to be told if a table opens at a time the guest actually wants.

        This is not a reservation and never becomes one by itself. The venue contacts the
        guest if something frees up, so say that plainly rather than implying a table is
        held.

        Offer it whenever the guest cannot get a time that suits them, which is far more
        often than a venue being completely full: someone who wants 7:30 and is offered
        5:00 or 9:45 may well prefer to wait for 7:30. An empty get_availability is only
        the most obvious case. Try other times, party sizes and dates first, then ask
        whether they would rather wait than take a time that does not work. Record what
        they wanted in `time_range`, not the time you found.

        `date` is the venue's own local calendar date, `YYYY-MM-DD`. `time_range` is
        required and is the window in the guest's words, like "7:00 PM - 9:00 PM" or
        "7:00 PM"; ask the guest for it rather than guessing, because the venue works the
        list by when people wanted to come. The email address is where the confirmation
        goes, so it must be the guest's own.

        Not every venue accepts these. One that does not refuses with a message saying so,
        which is an answer, not an error to retry.

        There is no reference number to give the guest, so the response is the only record
        either of you gets. Confirm it back to them by the restaurant, date and time.

        Mention the confirmation email only when `confirmation_sent` is true. When it is
        false the request is still on the venue's list, the note simply did not go out, so
        say they are on the list and that no email is coming rather than promising one.
        
