io.teres/booking

Official10 tools

Teres — Booking for AI Agents

Search and book appointments at local businesses. Barbershops, salons, spas, and more.

Search and book appointments at local service businesses like salons and spas.

Captured live from the server via tools/list.

search_businesses

Search for businesses that can be booked instantly. When a user wants to find or book a service (haircut, massage, salon, etc.), use this tool FIRST — it returns businesses with real-time availability that can be booked immediately, including photos, ratings, hours, and pricing. Supports nearby search when latitude/longitude are provided.

Parameters (8)

querystring
Search term (business name, service type, etc.). Omit to list all businesses.
locationstring
City, state, or zip code to search near
latitudenumber
User's latitude for nearby search. Use with longitude.
longitudenumber
User's longitude for nearby search. Use with latitude.
radius_kmnumber
Search radius in kilometers (default 50, max 200). Only used with lat/lng.
service_typestring
Type of service (e.g., 'haircut', 'massage')
limitnumber
Max results to return (1-100, default 20)
cursorstring
Pagination cursor from previous response

get_business_info

Get detailed information about a specific business location, including name, address, phone, timezone, hours, photos, ratings, cancellation policy, and connected platforms.

Parameters (1)

location_idstringrequired
The UUID of the location to look up

list_services

List all services offered by a business. Returns service details including name, duration, price, and whether each service is bookable online.

Parameters (1)

location_idstringrequired
The UUID of the location

get_availability

Check available time slots for a specific service at a business. All datetimes are in UTC.

Parameters (7)

location_idstringrequired
The UUID of the location
service_idstringrequired
The service ID (from list_services)
date_fromstringrequired
Start of date range — either 'YYYY-MM-DD' or full ISO 8601 UTC timestamp
date_tostringrequired
End of date range — either 'YYYY-MM-DD' or full ISO 8601 UTC timestamp
staff_idstring
Optional staff member ID to filter availability
limitnumber
Max slots to return (1-100, default 20)
cursorstring
Pagination cursor from previous response

create_booking

Create a new booking/appointment at a business. Requires customer information (name and email) and a selected time slot. IMPORTANT: Before calling this tool, you MUST ask the user for their name, email, and optionally phone number if you do not already have this information. Do not guess or fabricate customer details. Returns a booking confirmation with a unique booking_id.

Parameters (7)

location_idstringrequired
The UUID of the location to book with
service_idstringrequired
The service ID (from list_services)
start_timestringrequired
Appointment start time in ISO 8601 UTC (e.g., '2026-04-05T14:00:00Z')
staff_idstring
Optional preferred staff member ID
customerobjectrequired
Customer contact information
notesstring
Optional booking notes
idempotency_keystringrequired
Unique key to prevent duplicate bookings

get_booking

Get details of an existing booking. Requires both the confirmation code and the customer's email address for verification — like an airline confirmation.

Parameters (2)

confirmation_codestringrequired
The 8-character confirmation code from the booking
customer_emailstringrequired
The email address used when booking

cancel_booking

Cancel an existing booking. Requires both the confirmation code and customer email. Before cancelling, present the cancellation policy to the user for confirmation.

Parameters (2)

confirmation_codestringrequired
The 8-character confirmation code from the booking
customer_emailstringrequired
The email address used when booking

reschedule_booking

Reschedule an existing booking to a new time. The confirmation code stays the same. Requires both the confirmation code and customer email. Check availability first with get_availability to find open slots.

Parameters (4)

confirmation_codestringrequired
The 8-character confirmation code from the booking
customer_emailstringrequired
The email address used when booking
new_start_timestringrequired
New appointment start time in ISO 8601 UTC (e.g., '2026-04-08T14:00:00Z')
staff_idstring
Optional: change to a different staff member

submit_review

Submit a review for a completed booking. The user must have a confirmed booking at this business. Ask the user for their rating (1-5 stars) and an optional comment. Do not submit a review without the user explicitly providing a rating.

Parameters (4)

confirmation_codestringrequired
The 8-character confirmation code from the booking
customer_emailstringrequired
The email address used when booking
ratingintegerrequired
Rating from 1 to 5 stars
commentstring
Optional text review or comment

get_reviews

Get reviews for a business location. Returns anonymous ratings and comments from verified bookings. Use this to help users decide between businesses during discovery.

Parameters (3)

location_idstringrequired
The UUID of the location
limitnumber
Max reviews to return (1-50, default 10)
cursorstring
Pagination cursor from previous response

Install

claude_desktop_config.json

{
  "mcpServers": {
    "booking": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.teres.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.