Server definition

Hash: sha256:151980067ec33ad370a4d92b0462f872ca969a1de3655ac28501bb51ca4d6b1e
What it is: What a remote MCP server returned when asked what it offers: 27 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "Validate a promo code (eligibility preview only — does NOT reserve a slot). Returns valid=true with discount info when the code is currently redeemable; pass the same code as place_order.promo_code to actually apply + redeem it (the slot is consumed only when the order lands).",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "code": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "code"
        ],
        "type": "object"
      },
      "name": "apply_promo",
      "outputSchema": null
    },
    {
      "description": "Cancel an order placed via the same agent_session_id. Atomic — only succeeds while the order is still in \"pending\" or \"confirmed\" (the early KDS-accept state). Once the kitchen starts preparing, you must escalate to waiter_call. Idempotent: replays return the original outcome. Idempotency-Key header REQUIRED.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "order_id"
        ],
        "type": "object"
      },
      "name": "cancel_order",
      "outputSchema": null
    },
    {
      "description": "Cancel a reservation using the 6-character confirmation code the GUEST received by email/SMS (the code is the authorisation; ask the guest for it — this tool never issues or reveals codes). Thin wrapper over the venue's own cancellation endpoint, which answers uniformly: `status` is \"cancelled\" or \"noop\" (unknown code · already cancelled · seated/completed · less than 30 minutes away — it does not say which). Only report a cancellation to the guest when `cancelled` is true. PUBLIC tool, no auth.",
      "inputSchema": {
        "properties": {
          "confirmation_code": {
            "maxLength": 12,
            "minLength": 6,
            "type": "string"
          }
        },
        "required": [
          "confirmation_code"
        ],
        "type": "object"
      },
      "name": "cancel_reservation",
      "outputSchema": null
    },
    {
      "description": "Look up a loyalty member by member_id. Returns balance, tier, lifetime_points, and the most recent 10 transactions so the agent can ground its recommendation (\"you have 320 points, enough for a free coffee\").",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "member_id": {
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "member_id"
        ],
        "type": "object"
      },
      "name": "check_loyalty",
      "outputSchema": null
    },
    {
      "description": "Build an anonymous takeaway or delivery cart for a listed restaurant and get a one-time confirmation link for the guest. PUBLIC tool, no auth. Table orders are not supported here (they stay on the QR menu). Send the guest to confirm_url. Prices are re-read there from the live menu; name, phone, delivery address and payment are entered by the guest on that page — never through this tool. Nothing is ordered until the guest confirms. The link expires 30 minutes after creation and can be used once.",
      "inputSchema": {
        "properties": {
          "items": {
            "items": {
              "properties": {
                "note": {
                  "maxLength": 200,
                  "type": "string"
                },
                "product_id": {
                  "type": "string"
                },
                "quantity": {
                  "maximum": 99,
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "product_id",
                "quantity"
              ],
              "type": "object"
            },
            "maxItems": 50,
            "minItems": 1,
            "type": "array"
          },
          "note": {
            "description": "Order-level note for the kitchen. Do not put the guest's name, phone or address here.",
            "maxLength": 500,
            "type": "string"
          },
          "order_type": {
            "enum": [
              "takeaway",
              "delivery"
            ],
            "type": "string"
          },
          "restaurant": {
            "description": "Restaurant slug (from search_restaurants / list_public_menus) or id.",
            "type": "string"
          },
          "scheduled_for": {
            "description": "ISO date-time for a scheduled pickup/delivery (optional; the venue may refuse on the confirmation page).",
            "type": "string"
          }
        },
        "required": [
          "restaurant",
          "order_type",
          "items"
        ],
        "type": "object"
      },
      "name": "create_cart",
      "outputSchema": null
    },
    {
      "description": "Propose a new description for one of your products. Nothing goes live: the text is saved as a DRAFT change set the owner reviews, previews and publishes (or discards) in the admin panel.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "Proposed description in the menu language. Plain text, no links, no claims you cannot verify.",
            "maxLength": 2000,
            "type": "string"
          },
          "product_id": {
            "description": "Product id from menu_audit or get_restaurant_menu.",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "description"
        ],
        "type": "object"
      },
      "name": "draft_product_description",
      "outputSchema": null
    },
    {
      "description": "Propose the public website text of your restaurant — tagline, about paragraph, SEO title and SEO description — as a DRAFT change set. Only declared facts are allowed: no numbers, awards, links or markup; validation rejects anything else. The owner publishes from the admin panel.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "about": {
            "maxLength": 700,
            "type": "string"
          },
          "seo_description": {
            "maxLength": 160,
            "type": "string"
          },
          "seo_title": {
            "maxLength": 60,
            "type": "string"
          },
          "tagline": {
            "maxLength": 80,
            "type": "string"
          }
        },
        "required": [
          "tagline",
          "about",
          "seo_title",
          "seo_description"
        ],
        "type": "object"
      },
      "name": "draft_site_text",
      "outputSchema": null
    },
    {
      "description": "Propose a translation (name and/or description) of one product or category into one menu language. Nothing goes live: it is saved as a DRAFT change set the owner reviews and publishes in the admin panel; manual translations override machine translation once published.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "Translated description (optional). Plain text, no links, same meaning as the source — never add ingredients or claims.",
            "maxLength": 2000,
            "type": "string"
          },
          "entity": {
            "enum": [
              "product",
              "category"
            ],
            "type": "string"
          },
          "entity_id": {
            "description": "Product or category id from get_restaurant_menu / menu_audit.",
            "type": "string"
          },
          "locale": {
            "description": "Target menu language (two letters), different from the menu source language.",
            "enum": [
              "tr",
              "en",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "pt",
              "ru",
              "ar",
              "zh",
              "ja",
              "ko",
              "pl",
              "sv",
              "da",
              "fi",
              "no",
              "cs",
              "hu",
              "ro",
              "bg",
              "el",
              "hr",
              "sk",
              "sl",
              "lt",
              "lv",
              "he",
              "fa",
              "sw"
            ],
            "type": "string"
          },
          "name": {
            "description": "Translated name (optional). Keep brand names as they are.",
            "maxLength": 2000,
            "type": "string"
          }
        },
        "required": [
          "entity",
          "entity_id",
          "locale"
        ],
        "type": "object"
      },
      "name": "draft_translation",
      "outputSchema": null
    },
    {
      "description": "Read an anonymous cart by cart_id: state (open · consumed · expired), the one-time confirmation link while open, lines re-priced from the live menu, and the order id once the guest has confirmed. PUBLIC tool, no auth.",
      "inputSchema": {
        "properties": {
          "cart_id": {
            "pattern": "^[a-f0-9]{32}$",
            "type": "string"
          }
        },
        "required": [
          "cart_id"
        ],
        "type": "object"
      },
      "name": "get_cart",
      "outputSchema": null
    },
    {
      "description": "Return the FAQ entries from the public /faq page in the requested locale (31 locales; unknown locale falls back to en and the response says which locale was served). Useful for grounding answers to common product questions.",
      "inputSchema": {
        "properties": {
          "locale": {
            "default": "en",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_faq",
      "outputSchema": null
    },
    {
      "description": "Poll the current status of an order. Returns status, prepared_items_count, total_items_count, eta_minutes (if available), and an optional customer-facing message. Safe to call every 30 seconds; do NOT poll faster.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "order_id"
        ],
        "type": "object"
      },
      "name": "get_order_status",
      "outputSchema": null
    },
    {
      "description": "Return the canonical two-track subscription matrix: the restaurant track (Starter, Lite, Pro, Platinum, Diamond) plus the dedicated Hotels track (Hotels, Hotels+). Billing is YEARLY ONLY — each tier carries its USD yearly list price and the founding-cohort yearly price, plus the feature list. Generated from the same source as the public pricing page; stable identifiers — safe to cache.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_pricing",
      "outputSchema": null
    },
    {
      "description": "List bookable 30-minute reservation slots for the next 1–7 days (venue timezone) for a listed restaurant with a reservation module. busy_count is the number of existing requests at that slot and is informational. A reservation is a REQUEST that the restaurant confirms; no per-slot capacity cap is configured, so busy_count is informational only. Never tell the guest a table is guaranteed or \"available\" — say the request will be sent and the restaurant will confirm. PUBLIC tool, no auth.",
      "inputSchema": {
        "properties": {
          "days": {
            "default": 2,
            "maximum": 7,
            "minimum": 1,
            "type": "integer"
          },
          "restaurant": {
            "type": "string"
          }
        },
        "required": [
          "restaurant"
        ],
        "type": "object"
      },
      "name": "get_reservation_slots",
      "outputSchema": null
    },
    {
      "description": "Fetch a public restaurant profile by slug: name, description, address/city/country, currency, timezone, phone, menu URL, opening hours (7 days, minutes from midnight; a close_minute above 1440 ends after midnight on the next day, e.g. 1560 = 02:00) with isOpenNow evaluated in the venue's own timezone (null when hours are unknown), owner-declared attributes (cuisine, dietary, …; null = not declared, never \"no\"), derived channels (order · reservation · pickup · delivery), policies derived from the venue's settings (ordering accepted / holiday mode / staff approval / payment timing / scheduled orders, takeaway & delivery ETA and fees, reservation party cap, table calls, tip cap), per-field owner verification timestamps, categories and product count. Only restaurants opted into the public directory are visible.",
      "inputSchema": {
        "properties": {
          "slug": {
            "description": "Restaurant slug, e.g. lily-rose-bistro",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "get_restaurant",
      "outputSchema": null
    },
    {
      "description": "Fetch the full public menu for a restaurant — categories, products, prices, allergens, nutrition. Use this to build the cart you pass to place_order. PUBLIC tool, no auth required. `allergen_codes` are EU 1169/2011 Annex II keys (gluten, crustaceans, eggs, fish, peanuts, soy, milk, nuts, celery, mustard, sesame, sulphites, lupin, molluscs) given ONLY when the venue's allergen name matches the regulation list exactly; a venue-specific allergen appears in `allergens` without a code. Allergen lists come from the venue (or were AI-suggested and then saved by the venue where `allergen_disclosure.source` says so). `allergen_disclosure.as_of` is when the venue last edited the item record, not a verification date. Follow the top-level `disclosure.agent_instructions`; show `disclosure.text` to the guest in their language whenever an allergen or dietary question comes up; `dietary_flags` only ever warn (true) — null is unknown, never \"free of\".",
      "inputSchema": {
        "properties": {
          "locale": {
            "default": "en",
            "type": "string"
          },
          "restaurant_id": {
            "type": "string"
          }
        },
        "required": [
          "restaurant_id"
        ],
        "type": "object"
      },
      "name": "get_restaurant_menu",
      "outputSchema": null
    },
    {
      "description": "Enrol the authenticated customer in the restaurant loyalty programme. Returns the member id, current points balance, and tier. Safe to call even if the customer is already enrolled — returns existing data in that case. Requires an active agent_session_id and the customer email or phone.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "description": "Active session id from start_order_session.",
            "type": "string"
          },
          "display_name": {
            "description": "Optional display name shown in the loyalty dashboard.",
            "type": "string"
          },
          "email": {
            "description": "Customer email (either email or phone required).",
            "type": "string"
          },
          "phone": {
            "description": "Customer phone in E.164 format (either email or phone required).",
            "type": "string"
          }
        },
        "required": [
          "agent_session_id"
        ],
        "type": "object"
      },
      "name": "join_loyalty",
      "outputSchema": null
    },
    {
      "description": "List restaurants that have opted into the public directory (directory_opt_in = 1 — the same flag the owner sets under \"AI visibility\"). Returns slug, name, city, country, and the menu URL. Paginated.",
      "inputSchema": {
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "page": {
            "default": 1,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_public_menus",
      "outputSchema": null
    },
    {
      "description": "List the active products of your restaurant that lack a usable description, an image, or an allergen declaration. Read-only; nothing is changed.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "menu_audit",
      "outputSchema": null
    },
    {
      "description": "Place an order against the agent_session_id from start_order_session. Atomically inserts the order + items, applies server-side canonical pricing + tax (do NOT trust the unit_price you compute — we re-read it from D1), decrements inventory, optionally redeems a promo code, and creates a Stripe hosted Checkout Session so the customer can pay + authenticate on their own device. Returns order_id, total_cents (tax-inclusive), currency, promo_discount, and a hosted_confirm_url (a Stripe checkout link) to share with the human. Idempotency-Key header REQUIRED.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "customer_name": {
            "description": "Required for takeaway — who picks the order up.",
            "maxLength": 80,
            "type": "string"
          },
          "customer_phone": {
            "description": "Required for takeaway — reachable phone (digits, +, spaces/dashes tolerated).",
            "maxLength": 24,
            "type": "string"
          },
          "guest_name": {
            "description": "Required when room_id is set.",
            "type": "string"
          },
          "items": {
            "items": {
              "properties": {
                "product_id": {
                  "type": "string"
                },
                "quantity": {
                  "maximum": 999,
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "product_id",
                "quantity"
              ],
              "type": "object"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          },
          "note": {
            "description": "Optional order-level note (max 500 chars).",
            "type": "string"
          },
          "order_type": {
            "description": "Channel: 'dine_in' (default — table or room) or 'takeaway' (pickup; requires customer_name + customer_phone, ignores table_id/room_id, only when the restaurant has takeaway enabled — else channel_not_available). Delivery is not offered to agents.",
            "enum": [
              "dine_in",
              "takeaway"
            ],
            "type": "string"
          },
          "promo_code": {
            "description": "Optional promo code to redeem at order time (validate first with apply_promo). The redemption slot is consumed only when this order lands.",
            "maxLength": 64,
            "type": "string"
          },
          "room_id": {
            "description": "Diamond tier only — hotel room id.",
            "type": "string"
          },
          "table_id": {
            "description": "Optional table id when ordering at a table.",
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "items"
        ],
        "type": "object"
      },
      "name": "place_order",
      "outputSchema": null
    },
    {
      "description": "Ask the venue to bring the bill for a table. INSERTs a bill_requests row + fires the admin push notification. The split_type defaults to \"full\"; pass \"personal\" for German-style per-device splits.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "note": {
            "maxLength": 500,
            "type": "string"
          },
          "split_type": {
            "default": "full",
            "enum": [
              "full",
              "personal"
            ],
            "type": "string"
          },
          "table_id": {
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "table_id"
        ],
        "type": "object"
      },
      "name": "request_bill",
      "outputSchema": null
    },
    {
      "description": "Create an anonymous reservation REQUEST (date-time, party size, note) for a listed restaurant and get a one-time confirmation link. PUBLIC tool, no auth. Send the guest to confirm_url: they enter their name and email or phone there and submit the request themselves — never through this tool. The restaurant then confirms or declines; the guest receives the confirmation code by email/SMS. A reservation is a REQUEST that the restaurant confirms; no per-slot capacity cap is configured, so busy_count is informational only. Never tell the guest a table is guaranteed or \"available\" — say the request will be sent and the restaurant will confirm.",
      "inputSchema": {
        "properties": {
          "note": {
            "description": "Occasion, seating preference, accessibility needs. Do not put the guest's name, phone or email here.",
            "maxLength": 300,
            "type": "string"
          },
          "party_size": {
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "reserved_at": {
            "description": "ISO date-time; at least 30 minutes ahead, at most 90 days.",
            "type": "string"
          },
          "restaurant": {
            "type": "string"
          }
        },
        "required": [
          "restaurant",
          "reserved_at",
          "party_size"
        ],
        "type": "object"
      },
      "name": "request_reservation",
      "outputSchema": null
    },
    {
      "description": "Reservation requests of your restaurant for the next 14 days grouped by day and status, with pending requests that still need an answer. Read-only; no guest contact details.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "reservation_summary",
      "outputSchema": null
    },
    {
      "description": "Order counts by status, order total sums, top products by quantity and busiest hours for the last 7 and 30 days of your restaurant. Read-only.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "sales_summary",
      "outputSchema": null
    },
    {
      "description": "Search products inside a single restaurant by keyword. Returns up to 20 matching products with name, description, price, allergen tags, and the deep-link URL. Restaurant must be in the public directory.",
      "inputSchema": {
        "properties": {
          "limit": {
            "default": 10,
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          },
          "locale": {
            "default": "en",
            "type": "string"
          },
          "query": {
            "description": "Free-text search across name + description.",
            "type": "string"
          },
          "slug": {
            "description": "Restaurant slug.",
            "type": "string"
          }
        },
        "required": [
          "slug",
          "query"
        ],
        "type": "object"
      },
      "name": "search_products",
      "outputSchema": null
    },
    {
      "description": "Search the public directory (opt-in venues only) by location, opening status, cuisine, dietary options, declared attributes and ordering channel. Neutral ranking (AI-K6): distance in 0.5 km bands when `near` is given → availability (open now first; unknown hours before closed) → profile freshness (owner-verified within 90 days first) → name. Subscription tier never affects order. Cuisine, dietary and other attributes are owner declarations, not verified facts; venues without a declaration are excluded only when an attribute filter is used, and venues without coordinates only when `near` is used. Returns slug, name, city, country, distance_km, is_open_now (serve-time, in the venue's own timezone; null when hours are unknown), channels (order · reservation · pickup · delivery), declared attributes, freshness and the menu URL. Paginated.",
      "inputSchema": {
        "properties": {
          "attributes": {
            "description": "Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary).",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "channel": {
            "description": "order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery.",
            "enum": [
              "order",
              "reservation",
              "pickup",
              "delivery"
            ],
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "description": "ISO 3166-1 alpha-2",
            "type": "string"
          },
          "cuisine": {
            "description": "All listed cuisines must be declared by the venue.",
            "items": {
              "enum": [
                "turkish",
                "kebab",
                "ottoman",
                "anatolian",
                "aegean",
                "black_sea",
                "mediterranean",
                "middle_eastern",
                "lebanese",
                "persian",
                "georgian",
                "greek",
                "balkan",
                "romanian",
                "polish",
                "eastern_european",
                "russian",
                "italian",
                "pizza",
                "pasta",
                "french",
                "spanish",
                "tapas",
                "portuguese",
                "german",
                "austrian",
                "british",
                "irish",
                "scandinavian",
                "dutch",
                "american",
                "burger",
                "steakhouse",
                "bbq",
                "tex_mex",
                "mexican",
                "latin_american",
                "brazilian",
                "peruvian",
                "caribbean",
                "japanese",
                "sushi",
                "ramen",
                "chinese",
                "korean",
                "thai",
                "vietnamese",
                "indian",
                "pakistani",
                "indonesian",
                "malaysian",
                "filipino",
                "african",
                "ethiopian",
                "moroccan",
                "seafood",
                "grill",
                "vegetarian",
                "vegan",
                "healthy",
                "cafe",
                "coffee",
                "tea_house",
                "bakery",
                "patisserie",
                "dessert",
                "ice_cream",
                "breakfast_brunch",
                "fast_food",
                "street_food",
                "fusion",
                "international",
                "fine_dining",
                "bistro",
                "pub",
                "bar",
                "wine_bar",
                "cocktail_bar",
                "juice_bar",
                "hotel_restaurant",
                "food_court"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "dietary": {
            "description": "Owner declaration, not a certification.",
            "items": {
              "enum": [
                "vegetarian_options",
                "vegan_options",
                "gluten_free_options",
                "lactose_free_options",
                "halal",
                "kosher"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "limit": {
            "default": 20,
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "near": {
            "description": "Search centre. Venues without coordinates are excluded when set.",
            "properties": {
              "lat": {
                "type": "number"
              },
              "lng": {
                "type": "number"
              }
            },
            "required": [
              "lat",
              "lng"
            ],
            "type": "object"
          },
          "open_now": {
            "default": false,
            "description": "Only venues open right now in their own timezone; venues with unknown hours are excluded when true.",
            "type": "boolean"
          },
          "page": {
            "default": 1,
            "minimum": 1,
            "type": "integer"
          },
          "q": {
            "description": "Free text over name and description (min 2 chars).",
            "type": "string"
          },
          "radius_km": {
            "default": 10,
            "maximum": 100,
            "minimum": 0.5,
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "search_restaurants",
      "outputSchema": null
    },
    {
      "description": "Open a 30-minute transactional window for an AI agent against a specific restaurant. Returns an agent_session_id you MUST pass to every downstream order tool (place_order, cancel_order, request_bill, waiter_call, apply_promo). Also returns the customer-facing confirmation URL — share it with the human so they can review the cart before checkout.",
      "inputSchema": {
        "properties": {
          "restaurant_id": {
            "description": "Canonical restaurant id from get_restaurant or search_products.",
            "type": "string"
          }
        },
        "required": [
          "restaurant_id"
        ],
        "type": "object"
      },
      "name": "start_order_session",
      "outputSchema": null
    },
    {
      "description": "Flag a waiter to the table. INSERTs a waiter_calls row + fires the admin push notification. Pass an optional human-readable message (max 500 chars) the staff sees in the dashboard.",
      "inputSchema": {
        "properties": {
          "agent_session_id": {
            "type": "string"
          },
          "message": {
            "maxLength": 500,
            "type": "string"
          },
          "table_id": {
            "type": "string"
          }
        },
        "required": [
          "agent_session_id",
          "table_id"
        ],
        "type": "object"
      },
      "name": "waiter_call",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:151980067ec33ad370a4d92b0462f872ca969a1de3655ac28501bb51ca4d6b1e | sha256sum