Molzait MCP by usefulapi

Get the restaurant this API key belongs to: name, address, timezone, contact details and branding. Good first call to confirm which restaurant is connected. Molzait API: GET /external/restaurant.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the labels the restaurant uses to tag reservations and guests (VIP, allergy, and so on). Use the label ids when you filter guests or set labels on a reservation. Molzait API: GET /external/restaurant/labels.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the floor plans of the restaurant with their tables, table combinations and elements. Use table ids from here when you pin tables to a reservation. Molzait API: GET /external/floorplans.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search the guest directory by name, email, phone or company, with visit counts and labels. Use it to find a guest id before you list their reservations. Molzait API: GET /external/guests.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Free-text search over the guest name.",
      "type": "string"
    },
    "email": {
      "description": "Filter by email address.",
      "type": "string"
    },
    "phone": {
      "description": "Filter by phone number.",
      "type": "string"
    },
    "company": {
      "description": "Filter by company name.",
      "type": "string"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "de",
        "it"
      ],
      "description": "Guest language."
    },
    "hasEmail": {
      "description": "Only guests with (true) or without (false) an email address.",
      "type": "boolean"
    },
    "hasPhone": {
      "description": "Only guests with (true) or without (false) a phone number.",
      "type": "boolean"
    },
    "sortBy": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "lastName:asc",
        "lastName:desc",
        "firstName:asc",
        "firstName:desc",
        "totalVisits:asc",
        "totalVisits:desc",
        "totalCovers:asc",
        "totalCovers:desc",
        "lastVisit.seconds:asc",
        "lastVisit.seconds:desc"
      ]
    },
    "limit": {
      "description": "Number of guests per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page": {
      "description": "Page number (1-based).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List reservations in a date range, optionally for one guest or one status. Each reservation has its experience, times, tables, guest and labels. Molzait API: GET /external/reservations.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start of the date range (yyyy-mm-dd).",
      "type": "string"
    },
    "to": {
      "description": "End of the date range (yyyy-mm-dd).",
      "type": "string"
    },
    "guestId": {
      "description": "Only reservations of this guest id (from molzait_search_guests).",
      "type": "string"
    },
    "status": {
      "description": "Only reservations in this status.",
      "type": "string",
      "enum": [
        "requested",
        "unconfirmed",
        "payment_pending",
        "booked",
        "left_message",
        "wrong_number",
        "no_answer",
        "reconfirmed",
        "arrived",
        "partially_arrived",
        "seated",
        "ordered",
        "paid",
        "declined",
        "finished",
        "cancelled",
        "no_show",
        "voided"
      ]
    },
    "includeWalkIns": {
      "description": "Include walk-in guests (default as the API decides).",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one reservation by id: status, times, attendees, experience, guest, pinned tables, notes and labels. Molzait API: GET /external/reservations/{reservationId}.

{
  "type": "object",
  "properties": {
    "reservation_id": {
      "type": "string",
      "description": "The reservation id (from molzait_list_reservations)."
    }
  },
  "required": [
    "reservation_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the point-of-sale receipts of one reservation: products, waiters and table. Molzait API: GET /external/reservations/{reservationId}/receipts.

{
  "type": "object",
  "properties": {
    "reservation_id": {
      "type": "string",
      "description": "The reservation id (from molzait_list_reservations)."
    }
  },
  "required": [
    "reservation_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the bookable experiences of the restaurant (for example lunch or dinner menus) with their party-size limits. Use the experience id when you check slots or book. Molzait API: GET /external/availability/experiences.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the bookable time slots for one experience, day and party size, with open spots per slot. Molzait API: GET /external/availability/slots.

{
  "type": "object",
  "properties": {
    "experience_id": {
      "type": "string",
      "description": "The experience id (from molzait_list_experiences)."
    },
    "day": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The day to check (yyyy-mm-dd)."
    },
    "attendees": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Party size."
    },
    "reservation_id": {
      "description": "Existing reservation id, when you check a change to it.",
      "type": "string"
    }
  },
  "required": [
    "experience_id",
    "day",
    "attendees"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the gift card templates the restaurant sells, with amounts, variations and expiry rules. Molzait API: GET /external/gift-cards/templates.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one gift card by id: amount, remaining amount, template, expiry day and locale. Molzait API: GET /external/gift-cards/{giftCardId}.

{
  "type": "object",
  "properties": {
    "gift_card_id": {
      "type": "string",
      "description": "The gift card id."
    }
  },
  "required": [
    "gift_card_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Book a reservation for one experience, day, time and party size. The guest is found or created from the name, email and phone. Creates a real booking that the restaurant sees. Molzait API: POST /external/reservations.

{
  "type": "object",
  "properties": {
    "experience_id": {
      "type": "string",
      "description": "The experience id (from molzait_list_experiences)."
    },
    "day": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The reservation day (yyyy-mm-dd)."
    },
    "minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1439,
      "description": "Start time in minutes since midnight in the restaurant timezone (600 = 10:00)."
    },
    "attendees": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Party size."
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "description": "Guest last name."
    },
    "first_name": {
      "description": "Guest first name.",
      "type": "string"
    },
    "email": {
      "description": "Guest email address.",
      "type": "string"
    },
    "phone": {
      "description": "Guest phone number.",
      "type": "string"
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "de",
        "it"
      ],
      "description": "Guest language."
    },
    "notes": {
      "description": "Special request notes for the restaurant.",
      "type": "string"
    },
    "pinned_table_ids": {
      "description": "Table ids to pin. Omit to let the restaurant choose.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "label_ids": {
      "description": "Label ids to set on the reservation.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "experience_id",
    "day",
    "minutes",
    "attendees",
    "last_name",
    "locale"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Change one reservation: its status (for example cancelled or no_show), day, start time, party size or tables. Only the fields you pass are sent. Changes the live booking. Molzait API: PATCH /external/reservations/{reservationId}.

{
  "type": "object",
  "properties": {
    "reservation_id": {
      "type": "string",
      "description": "The reservation id (from molzait_list_reservations)."
    },
    "status": {
      "description": "New status.",
      "type": "string",
      "enum": [
        "requested",
        "unconfirmed",
        "payment_pending",
        "booked",
        "left_message",
        "wrong_number",
        "no_answer",
        "reconfirmed",
        "arrived",
        "partially_arrived",
        "seated",
        "ordered",
        "paid",
        "declined",
        "finished",
        "cancelled",
        "no_show",
        "voided"
      ]
    },
    "day": {
      "description": "New day (yyyy-mm-dd).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "minutes": {
      "description": "New start time in minutes since midnight (600 = 10:00).",
      "type": "integer",
      "minimum": 0,
      "maximum": 1439
    },
    "attendees": {
      "description": "New party size.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "table_ids": {
      "description": "New table ids.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "reservation_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}