Search Restaurants
Browse restaurants by region, cuisine, or area. Returns a directory-style list with name, location, Michelin stars, and starting price. Does not include real-time availability — for date-based searches use search_available_restaurants, and for one restaurant's openings use check_availability.
For a specific named restaurant, use this tool to obtain its restaurant_id, then call get_restaurant_details for the full profile and get_restaurant_menu for courses and pricing. The description field retu
Get Restaurant Details
Get the full profile of one specific restaurant: untrimmed description, booking_rules, booking_tips, address, operating_hours, seating, and starting price.
Use when the user names a specific restaurant and wants its details, or when you have a restaurant_id and need fields that search_restaurants does not return.
Does not return menu or courses (use get_restaurant_menu), cancellation policy (use get_cancellation_policies), or real-time availability (use check_availability).
starting_price_dis
Get Restaurant Menu
Get the menu for a specific restaurant: an array of course names and their prices.
Use when the user asks about a specific restaurant's menu, courses, or course pricing.
This tool returns course names and prices only — not dish lists, course composition, number of pieces, or ingredients. For full course details, direct the user to the restaurant page (details_url in the response). The response itself returns this course content only; do not supplement it with assumptions.
Check Availability
Check real-time availability for one specific restaurant within a date range. Returns all openings for that restaurant; it does not filter by time of day.
Use when you already know which restaurant the user wants. If the user is browsing across multiple restaurants in a region or cuisine, use search_available_restaurants instead.
Use the exact parameter names start_date, end_date, restaurant_id, num_people, daily_or_minutes, and by_menu_item. Including restaurant_id is recommended; omitting it
Search Available Restaurants
Search across multiple restaurants for availability within a date range. Returns restaurants that have openings, filterable by prefecture, area, genre, and party size.
Use when the user does not yet have a specific restaurant in mind and is browsing or filtering by region or cuisine. If the user already has a specific restaurant, use check_availability instead.
Date handling: if the user gives only month/day, use the current year, or next year if that date is already past. For a single date, s
Get Cancellation Policies
Read-only: retrieve a restaurant's cancellation policy. This tool only reads policy data; it does not cancel or modify any reservation. Safe to call repeatedly.
Use when the user asks about the cancellation policy, refund terms, or no-show fee, or before calling create_reservation or create_reservation_request.
get_restaurant_details returns booking_rules and booking_tips, which describe when bookings open and how to book — not cancellation terms.
Returns: cancel_policies (array of { days_bef
Create Reservation
Create a direct reservation for a specific available opening (opening_id required).
Use after check_availability has returned an opening and the user has chosen which opening_id to book. If check_availability returned no openings, use create_reservation_request instead.
Flow (summary — see resource tableall://flow/direct-reservation for full details):
1. Call get_cancellation_policies and explain cancellation terms (include: the booking fee is non-refundable regardless of cancellation timing).
Get Reservation Status
Check the status of a reservation by session ID.
Requires the access_token that was returned in the create_reservation response.
You MUST have stored the access_token from the create response to use this tool.
Without a valid access_token, the API will return 403 Forbidden.
IMPORTANT - PRICE DISPLAY:
The "price" field already INCLUDES the "booking_fee". Do NOT add them together.
When displaying to the user, show: price (total) and booking_fee (included in price, non-refundable).
Example: "Tota
Create Reservation Request
Submit a reservation request for a selected restaurant, dates, time range, and party size. Use after check_availability or search_available_restaurants has been run and the user confirms they want to submit a request.
Use this when the user prefers dates or times other than the available openings, or when no openings were found and the user wants to request one. The user's use of the word "request" signals intent to try, not consent to skip the availability check — check availability and show t
Get Reservation Request Status
Check the status of a reservation request by session ID.
Requires the access_token that was returned in the create_reservation_request response.
You MUST have stored the access_token from the create response to use this tool.
Without a valid access_token, the API will return 403 Forbidden.
IMPORTANT - PRICE DISPLAY:
The "price" field already INCLUDES the "booking_fee". Do NOT add them together.
When displaying to the user, show: price (total) and booking_fee (included in price, non-refundable)
