Сервер предоставляет клиентам Model Context Protocol доступ к каталогу действующих предложений локальных организаций Республики Казахстан: салоны красоты, стоматологические и медицинские клиники, косметология, массаж, SPA. По каждой услуге передаются цена, размер скидки, срок действия предложения и число свободных мест.
Без персонального доступа сервер работает только на чтение: состав сведений совпадает с опубликованным на сайте thetap.live, запись оформляется на сайте. Запись из чата доступна только владельцу персонального доступа, см. раздел 5.5. Оплата средствами сервера не производится.
https://thetap.live/mcp
| Транспорт | Streamable HTTP, без канала Server-Sent Events |
| Формат обмена | JSON-RPC 2.0, кодировка UTF-8 |
| Версия протокола | 2025-06-18; принимаются также 2025-03-26 и 2024-11-05 |
| Авторизация | не применяется, доступ анонимный |
| Управление сессией | не применяется, состояние между запросами не сохраняется |
| Заголовок запроса | Content-Type: application/json |
Метод GET возвращает код 405: канал «сервер — клиент» не открывается. Метод OPTIONS возвращает код 204. Кросс-доменные запросы разрешены для всех источников; передача учётных данных не предусмотрена.
TAP.Поддерживается любой клиент MCP, реализующий транспорт Streamable HTTP. Параметры авторизации не заполняются.
curl -s -X POST https://thetap.live/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
| Метод | Возвращаемый результат |
|---|---|
initialize | Версия протокола, перечень возможностей, сведения о сервере, инструкции для клиентской модели |
tools/list | Перечень инструментов со схемами входных параметров |
tools/call | Результат вызова инструмента, см. раздел 5 |
ping | Пустой результат, подтверждение доступности |
resources/list, prompts/list | Пустые перечни; соответствующие возможности сервером не объявляются |
Уведомления, то есть сообщения без поля id, обрабатываются без формирования ответа; возвращается код 202. Передача нескольких сообщений в одном запросе поддерживается для совместимости с клиентами предшествующих версий протокола.
Все инструменты, кроме prepare_booking и create_booking, имеют признак readOnlyHint. Результат вызова передаётся в поле content[0].text в виде строки, содержащей объект JSON.
Поиск действующих предложений в каталоге.
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
query | string | нет | Наименование услуги. Принимаются формулировки на русском, английском и частично на казахском языке |
category | string | нет | Категория каталога, см. list_categories |
city | string | нет | Населённый пункт |
region | string | нет | Страна: kz — Казахстан, us — США (Калифорния), all — обе. Если не указана, определяется по city или месту в запросе, иначе kz |
max_price | integer | нет | Верхняя граница цены в валюте страны: тенге для kz, доллары для us |
limit | integer | нет | Количество записей, от 1 до 20. Значение по умолчанию — 10 |
{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_offers",
"arguments":{"query":"маникюр","city":"Алматы","max_price":8000}}}
{
"found": 2,
"offers": [
{
"id": "o113",
"title": "Маникюр + укрепление",
"business": "Pilochka Nail Bar",
"price": 6999,
"old_price": 10000,
"discount": 30,
"currency": "KZT",
"category": "Маникюр",
"city": "Алматы",
"url": "https://thetap.live/offer/113?src=mcp"
}
]
}
Получение полного описания предложения.
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
id | string | да | Идентификатор предложения из результатов поиска, например o113 |
При отсутствии предложения либо истечении срока его действия возвращается результат с признаком isError.
Перечень категорий каталога с указанием числа действующих предложений.
| Параметр | Тип | Обязательность | Описание |
|---|---|---|---|
category | string | нет | При указании возвращается перечень подкатегорий внутри заданной категории |
Инструменты передают те же сведения, что search_offers и get_offer, в структуре, применяемой режимом исследования ChatGPT. Инструмент search принимает обязательный параметр query и возвращает объект {"results":[{"id","title","url"}]}. Инструмент fetch принимает обязательный параметр id и возвращает объект {"id","title","text","url","metadata"}.
Доступна по карточкам с полем chat_booking: true (календарь салона в zapis.kz). Услугу, мастера, дату и время выбирает пользователь; сервер не подбирает их сам.
| Инструмент | Параметры | Результат |
|---|---|---|
get_booking_options | offer_id | Салон, услуга с ценой из прайса салона, мастера этой услуги |
get_available_dates | offer_id, service_id, master_id | Свободные даты на две недели |
get_available_times | те же и date | Свободное время на дату, пояс UTC+5 |
prepare_booking | те же и time | Живая проверка времени, удержание на 5 минут, данные для показа и confirmation_token. Брони не создаёт |
create_booking | confirmation_token, user_confirmed | Повторная живая проверка и бронь. При status: confirmed: услуга, салон, мастер, дата, время, идентификаторы, manage_url |
Первые три инструмента доступны без авторизации. prepare_booking и create_booking требуют персонального доступа, который выдаёт TAP: ключ передаётся заголовком Authorization: Bearer или параметром grant в адресе сервера. Доступ привязан к имени и телефону его владельца, клиент их не передаёт. Без ключа эти инструменты не показываются в tools/list.
Повтор create_booking с тем же токеном возвращает ту же бронь. Об успехе можно сообщать только при status: confirmed. При status: unknown исход неизвестен, повторять попытку нельзя.
| Поле | Тип | Описание |
|---|---|---|
id | string | Идентификатор предложения |
title | string | Наименование услуги |
business | string | Наименование организации |
price | integer | Цена по предложению, в валюте currency |
old_price | integer | Цена без скидки, в валюте currency |
discount | integer | Размер скидки, процентов |
currency | string | Код валюты: KZT или USD |
country | string | Страна: KZ или US |
category | string | Путь по каталогу, уровни разделены символом «/» |
city | string | Населённый пункт |
address | string | Адрес места оказания услуги |
description | string | Описание услуги, не более 600 символов |
rating | string | Рейтинг организации |
reviews | integer | Количество отзывов |
verified | boolean | Признак проверенной организации |
spots_left | integer | Число свободных мест |
expires_at | string | Дата и время окончания действия предложения |
booking | string | tap — запись через сайт TAP; external — запись непосредственно в организации |
url | string | Адрес страницы предложения |
Поля, не имеющие значения, в составе ответа отсутствуют. В выдачу включаются исключительно действующие предложения: не отключённые организацией и не истёкшие по сроку.
| Показатель | Значение |
|---|---|
| Запросов в минуту с одного клиента | 30 |
| Запросов в сутки с одного клиента | 300 |
| Записей в результате одного вызова | не более 20 |
| Размер тела запроса | не более 256 КБ |
| Стоимость доступа | не взимается |
При превышении лимита возвращается код 429 и заголовок Retry-After.
| Код | Условие возникновения |
|---|---|
| -32700 | Тело запроса не является корректным документом JSON |
| -32600 | Сообщение не соответствует спецификации JSON-RPC 2.0 |
| -32601 | Запрошенный метод не поддерживается |
| -32602 | Инструмент не существует либо его наименование не указано |
| -32000 | Превышен лимит обращений |
Ошибки выполнения инструмента передаются в составе результата с признаком isError и текстовым описанием, без формирования ошибки уровня JSON-RPC. Сведения о внутренних сбоях сервера наружу не передаются.
Условия обработки данных установлены документами: политика конфиденциальности, публичная оферта.
Средствами сервера не выполняются:
Адрес для обращений по вопросам работы сервера: hello@thetap.live
The server grants Model Context Protocol clients access to a catalog of live offers from local organisations of the Republic of Kazakhstan: beauty salons, dental and medical clinics, cosmetology, massage, spa. Each service is supplied with its price, discount rate, offer expiry date and the number of remaining spots.
Without personal access the server is read-only: the data supplied is identical to the data published on thetap.live, and booking is completed on the website. Booking from chat is available only to a holder of personal access, see section 5.5. The server does not process payments.
https://thetap.live/mcp
| Transport | Streamable HTTP, no Server-Sent Events channel |
| Exchange format | JSON-RPC 2.0, UTF-8 encoding |
| Protocol version | 2025-06-18; 2025-03-26 and 2024-11-05 are also accepted |
| Authentication | not applied, access is anonymous |
| Session handling | not applied, no state is retained between requests |
| Request header | Content-Type: application/json |
The GET method returns code 405: no server-to-client channel is opened. The OPTIONS method returns code 204. Cross-origin requests are permitted from any origin; credential transfer is not provided for.
TAP.Any MCP client implementing the Streamable HTTP transport is supported. Authentication parameters are left blank.
curl -s -X POST https://thetap.live/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
| Method | Result returned |
|---|---|
initialize | Protocol version, capability list, server information, instructions for the client model |
tools/list | List of tools with input parameter schemas |
tools/call | Result of a tool invocation, see section 5 |
ping | Empty result, availability confirmation |
resources/list, prompts/list | Empty lists; the corresponding capabilities are not declared by the server |
Notifications, that is messages without an id field, are processed without forming a response; code 202 is returned. Transmission of several messages in a single request is supported for compatibility with clients of preceding protocol versions.
All tools except prepare_booking and create_booking carry the readOnlyHint attribute. The invocation result is supplied in the content[0].text field as a string containing a JSON object.
Search of live offers in the catalog.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | no | Service name. Wordings in Russian, English and partly Kazakh are accepted |
category | string | no | Catalog category, see list_categories |
city | string | no | Locality |
region | string | no | Country: kz — Kazakhstan, us — USA (California), all — both. If omitted, inferred from city or a place in the query, otherwise kz |
max_price | integer | no | Upper price bound in the country currency: tenge for kz, dollars for us |
limit | integer | no | Number of records, 1 to 20. Default value — 10 |
{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_offers",
"arguments":{"query":"manicure","city":"Almaty","max_price":8000}}}
{
"found": 2,
"offers": [
{
"id": "o113",
"title": "Маникюр + укрепление",
"business": "Pilochka Nail Bar",
"price": 6999,
"old_price": 10000,
"discount": 30,
"currency": "KZT",
"category": "Маникюр",
"city": "Алматы",
"url": "https://thetap.live/offer/113?src=mcp"
}
]
}
Catalog content is held in Russian; queries in other languages are matched against it.
Retrieval of the full offer description.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Offer identifier from search results, for example o113 |
Where the offer does not exist or its validity period has elapsed, a result carrying the isError attribute is returned.
List of catalog categories stating the number of live offers.
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | no | Where supplied, the list of subcategories within the given category is returned |
These tools supply the same data as search_offers and get_offer in the structure used by ChatGPT deep research. The search tool takes a mandatory query parameter and returns the object {"results":[{"id","title","url"}]}. The fetch tool takes a mandatory id parameter and returns the object {"id","title","text","url","metadata"}.
Available for offers with chat_booking: true (the salon's calendar is on zapis.kz). The user chooses the service, master, date and time; the server does not pick them.
| Tool | Parameters | Result |
|---|---|---|
get_booking_options | offer_id | Salon, service with the price from the salon's price list, masters for that service |
get_available_dates | offer_id, service_id, master_id | Available dates for two weeks |
get_available_times | the same plus date | Available times for the date, UTC+5 |
prepare_booking | the same plus time | Live availability check, a 5-minute hold, details to show the user and a confirmation_token. Creates no booking |
create_booking | confirmation_token, user_confirmed | A second live check and the booking. With status: confirmed: service, salon, master, date, time, identifiers, manage_url |
The first three tools need no authorization. prepare_booking and create_booking require personal access issued by TAP: the key is sent in an Authorization: Bearer header or as the grant parameter of the server address. Access is bound to its holder's name and phone, which the client does not send. Without a key these tools are absent from tools/list.
Repeating create_booking with the same token returns the same booking. Report success only on status: confirmed. On status: unknown the outcome is unknown and the attempt must not be repeated.
| Field | Type | Description |
|---|---|---|
id | string | Offer identifier |
title | string | Service name |
business | string | Organisation name |
price | integer | Offer price, in currency |
old_price | integer | Price before discount, in currency |
discount | integer | Discount rate, per cent |
currency | string | Currency code: KZT or USD |
country | string | Country: KZ or US |
category | string | Catalog path, levels separated by “/” |
city | string | Locality |
address | string | Address where the service is provided |
description | string | Service description, 600 characters maximum |
rating | string | Organisation rating |
reviews | integer | Number of reviews |
verified | boolean | Verified organisation attribute |
spots_left | integer | Number of remaining spots |
expires_at | string | Date and time the offer ceases to be valid |
booking | string | tap — booking through the TAP website; external — booking directly with the organisation |
url | string | Offer page address |
Fields holding no value are omitted from the response. Only live offers are included: those not disabled by the organisation and not elapsed by date.
| Parameter | Value |
|---|---|
| Requests per minute per client | 30 |
| Requests per day per client | 300 |
| Records per single invocation | 20 maximum |
| Request body size | 256 KB maximum |
| Access charge | none |
Where a limit is exceeded, code 429 and the Retry-After header are returned.
| Code | Condition |
|---|---|
| -32700 | The request body is not a valid JSON document |
| -32600 | The message does not conform to the JSON-RPC 2.0 specification |
| -32601 | The requested method is not supported |
| -32602 | The tool does not exist or its name is not supplied |
| -32000 | The request limit has been exceeded |
Tool execution errors are supplied within the result carrying the isError attribute and a textual description, without forming a JSON-RPC level error. Details of internal server failures are not disclosed.
Data processing terms are established by the following documents: privacy policy, public offer.
The server does not perform:
Address for enquiries concerning operation of the server: hello@thetap.live