Teres — Booking for AI Agents

teres-io/teres

Connects Claude to Teres's appointment booking platform for scheduling services at local barbershops, salons, spas, and similar businesses. You'd reach for this when building assistants that need to search availability and book appointments on behalf of users without leaving the conversation. The streamable HTTP transport means it works through their hosted API at api.teres.io, so no local installation needed. Useful for personal assistant workflows, booking automation, or any application where you want to handle service appointments through natural language rather than sending users to multiple booking websites.

tools: 10
transport: HTTP
last updated: Apr 5, 2026

View on GitHub

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

search_businessesSearch 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 pricin...8 params

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 pricin...

Parameters* required

cursorstring

Pagination cursor from previous response

latitudenumber

User's latitude for nearby search. Use with longitude.

limitnumber

Max results to return (1-100, default 20)default: 20

locationstring

City, state, or zip code to search near

longitudenumber

User's longitude for nearby search. Use with latitude.

querystring

Search term (business name, service type, etc.). Omit to list all businesses.

radius_kmnumber

Search radius in kilometers (default 50, max 200). Only used with lat/lng.default: 50

service_typestring

Type of service (e.g., 'haircut', 'massage')

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

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

Parameters* required

business_idstring

The UUID of the business to look up

list_servicesList all bookable services offered by a business. Returns service details including name, duration, price, and available staff.1 params

List all bookable services offered by a business. Returns service details including name, duration, price, and available staff.

Parameters* required

business_idstring

The UUID of the business

get_availabilityCheck available time slots for a specific service at a business. All datetimes are in UTC.7 params

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

Parameters* required

business_idstring

The UUID of the business

cursorstring

Pagination cursor from previous response

date_fromstring

Start of date range — either 'YYYY-MM-DD' or full ISO 8601 UTC timestamp

date_tostring

End of date range — either 'YYYY-MM-DD' or full ISO 8601 UTC timestamp

limitnumber

Max slots to return (1-100, default 20)default: 20

service_idstring

The service ID (from list_services)

staff_idstring

Optional staff member ID to filter availability

create_bookingCreate 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. D...7 params

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. D...

Parameters* required

business_idstring

The UUID of the business to book with

customerobject

Customer contact information

idempotency_keystring

Unique key to prevent duplicate bookings

notesstring

Optional booking notes

service_idstring

The service ID (from list_services)

staff_idstring

Optional preferred staff member ID

start_timestring

Appointment start time in ISO 8601 UTC (e.g., '2026-04-05T14:00:00Z')

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

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

Parameters* required

confirmation_codestring

The 8-character confirmation code from the booking

customer_emailstring

The email address used when booking

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

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

Parameters* required

confirmation_codestring

The 8-character confirmation code from the booking

customer_emailstring

The email address used when booking

reschedule_bookingReschedule 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.4 params

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* required

confirmation_codestring

The 8-character confirmation code from the booking

customer_emailstring

The email address used when booking

new_start_timestring

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_reviewSubmit 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.4 params

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* required

commentstring

Optional text review or comment

confirmation_codestring

The 8-character confirmation code from the booking

customer_emailstring

The email address used when booking

ratinginteger

Rating from 1 to 5 stars

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

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

Parameters* required

business_idstring

The UUID of the business

cursorstring

Pagination cursor from previous response

limitnumber

Max reviews to return (1-50, default 10)default: 10

Readme

Details

Repository: github.com/teres-io/teres
Category: Search & Web Crawling
Transport: HTTP
Registry: MCP registry, active

Related Search & Web Crawling MCP servers

View all

TaxCompass — Italian tax toolsit.taxcompass/taxcompassSourced Italian tax tools for AI agents: cited primary-source search + a deterministic tax engine.0stars

Push Realmjames-robson/push-realmCross-domain knowledge network where AI agents search, share, and refine solutions via MCP.0stars

UK Food Hygiene Ratingsjamesmarshall543210-sudo/uk-food-hygiene-mcpSearch official UK Food Standards Agency hygiene ratings by name, postcode or council.0stars

Filoo Mcpjrlprost/filoo-mcpCreate short links, fetch click analytics, and generate QR codes via the filoo.app API.0stars

Cairnjuw12/cairnSecond brain as plain Markdown in your repo: search, notes, capture, journal, task queue.0stars

GitDealFlow Signalkindrat86/mcp-deal-flow-signalGitHub-derived engineering acceleration signals for VC deal flow — surface stealth startups before TechCrunch covers them. Weekly-refreshed dataset of 109 start0stars