Russian beauty salons and services by place, rating, price; free time; a booking link
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Free start times for a service, in the salon's time zone, for up to 7 days starting at dateFrom (default today), optionally for one master. The salon's own rules apply (minimum notice, how far ahead one may book). Returns at most 60 times grouped by date, with masters free at each time, and the bookingUrl where the person picks the time and books.
Service id from search_services or get_salon.
How many days, 1–7 (default 3).
First day, YYYY-MM-DD, in the salon's time zone. Default: today.
Only this master (id from the service's masters).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http uplanny https://uplanny.ru/api/mcp
Free start times for a service, in the salon's time zone, for up to 7 days starting at dateFrom (default today), optionally for one master. The salon's own rules apply (minimum notice, how far ahead one may book). Returns at most 60 times grouped by date, with masters free at each time, and the bookingUrl where the person picks the time and books.
| Argument | Type | Description |
|---|---|---|
| days | integer | How many days, 1–7 (default 3). |
| dateFrom | string | First day, YYYY-MM-DD, in the salon's time zone. Default: today. |
| masterId | integer | Only this master (id from the service's masters). |
| serviceId* | integer | Service id from search_services or get_salon. |
{
"type": "object",
"required": [
"serviceId"
],
"properties": {
"days": {
"type": "integer",
"description": "How many days, 1–7 (default 3)."
},
"dateFrom": {
"type": "string",
"description": "First day, YYYY-MM-DD, in the salon's time zone. Default: today."
},
"masterId": {
"type": "integer",
"description": "Only this master (id from the service's masters)."
},
"serviceId": {
"type": "integer",
"description": "Service id from search_services or get_salon."
}
},
"additionalProperties": false
}A salon's public card by slug: address, coordinates, time zone, rating, categories, description, masters with ratings and every service with price, duration, rating and masters.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Salon slug from search results. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Salon slug from search results."
}
},
"additionalProperties": false
}List business categories (id and Russian name) for the `category` filter of search_salons and search_services.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Prepare a booking link for ONE service at ONE time (a «cart» of one item). Nothing is booked here and the time is not held: the person opens bookingUrl, checks the details, enters or corrects name, phone and e-mail, gives the consents themselves and books. The time must be one of those get_available_slots returns; it is checked now and again when the person confirms. If you already know the person's name, phone and e-mail, pass them: they pre-fill the form (they travel in the link's #fragment and are not stored by uPlanny). Cancelling and moving bookings are not available through this server.
| Argument | Type | Description |
|---|---|---|
| start* | string | Start time from get_available_slots (`start`, e.g. 2026-11-18T10:00+03:00). Without an offset it is read in the salon's time zone. |
| masterId | integer | A particular master (from the slot's masters). Leave out for any free master. |
| serviceId* | integer | Service id. |
| customerName | string | Optional pre-fill: the person's name. |
| customerEmail | string | Optional pre-fill: the person's e-mail. |
| customerPhone | string | Optional pre-fill: the person's phone, e.g. +7 999 123-45-67. |
{
"type": "object",
"required": [
"serviceId",
"start"
],
"properties": {
"start": {
"type": "string",
"description": "Start time from get_available_slots (`start`, e.g. 2026-11-18T10:00+03:00). Without an offset it is read in the salon's time zone."
},
"masterId": {
"type": "integer",
"description": "A particular master (from the slot's masters). Leave out for any free master."
},
"serviceId": {
"type": "integer",
"description": "Service id."
},
"customerName": {
"type": "string",
"description": "Optional pre-fill: the person's name."
},
"customerEmail": {
"type": "string",
"description": "Optional pre-fill: the person's e-mail."
},
"customerPhone": {
"type": "string",
"description": "Optional pre-fill: the person's phone, e.g. +7 999 123-45-67."
}
},
"additionalProperties": false
}Search businesses (beauty salons, barbershops, nail and brow studios, massage, spa, clinics and other appointment-based places) in the uPlanny catalogue. Filter by text, category, place («рядом», «около», «недалеко», «возле метро» → `near` or lat/lng with radiusKm), city, salon rating and price; paginated. Each item has the salon `slug` (for get_salon), rating {average, reviews} or null when there are no reviews yet, priceFrom (cheapest service, RUB), distanceKm when a place was given, and bookingUrl.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude of the place to search around (instead of `near`). |
| lng | number | Longitude of the place to search around (instead of `near`). |
| city | string | Only businesses whose address contains this text, e.g. a city «Казань». Ignored when a place is given. |
| near | string | A place to search around: address, metro station or landmark, with the city — «Москва, метро Сокол», «Казань, Баумана 10». Used for «рядом», «около», «недалеко», «поблизости». |
| page | integer | Page number, from 0. |
| sort | string | Order. Default: distance when a place is given, otherwise rating. |
| query | string | Free text: salon name, service, master's name. Russian works best, e.g. «маникюр», «стрижка мужская». |
Search services across all businesses: «маникюр с покрытием до 2000 ₽ рядом с метро Сокол с рейтингом от 4.5». Separate rating bounds for the salon, for the service itself and for its masters (a master bound matches when at least one master performing the service is rated within it). Price bounds apply to the service price (RUB). Each item: serviceId (for get_available_slots), name, durationMinutes, price, rating, masters with their ratings, the salon (slug, name, address, rating, distanceKm) and bookingUrl.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude of the place to search around (instead of `near`). |
| lng | number | Longitude of the place to search around (instead of `near`). |
| city | string | Only businesses whose address contains this text, e.g. a city «Казань». Ignored when a place is given. |
| near | string | A place to search around: address, metro station or landmark, with the city — «Москва, метро Сокол», «Казань, Баумана 10». Used for «рядом», «около», «недалеко», «поблизости». |
| page | integer | Page number, from 0. |
| sort | string | Order. Default: distance when a place is given, otherwise the service's rating. |
| query | string |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| category | string | Category id from list_categories. |
| maxPrice | number | Has a service costing at most this, RUB. |
| minPrice | number | Has a service costing at least this, RUB. |
| pageSize | integer | Items per page, 1–20 (default 10). |
| radiusKm | number | Search radius around the place, km (default 3, max 50; ~1 for «в шаговой доступности»). |
| maxRating | number | Salon rating at most this (1–5). |
| minRating | number | Salon rating at least this (1–5). Salons without reviews are excluded when any rating bound is set. |
| minReviews | integer | With a rating bound: at least this many reviews (default 1). |
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the place to search around (instead of `near`)."
},
"lng": {
"type": "number",
"description": "Longitude of the place to search around (instead of `near`)."
},
"city": {
"type": "string",
"description": "Only businesses whose address contains this text, e.g. a city «Казань». Ignored when a place is given."
},
"near": {
"type": "string",
"description": "A place to search around: address, metro station or landmark, with the city — «Москва, метро Сокол», «Казань, Баумана 10». Used for «рядом», «около», «недалеко», «поблизости»."
},
"page": {
"type": "integer",
"description": "Page number, from 0."
},
"sort": {
"enum": [
"rating",
"distance",
"price_asc",
"price_desc",
"name"
],
"type": "string",
"description": "Order. Default: distance when a place is given, otherwise rating."
},
"query": {
"type": "string",
"description": "Free text: salon name, service, master's name. Russian works best, e.g. «маникюр», «стрижка мужская»."
},
"category": {
"type": "string",
"description": "Category id from list_categories."
},
"maxPrice": {
"type": "number",
"description": "Has a service costing at most this, RUB."
},
"minPrice": {
"type": "number",
"description": "Has a service costing at least this, RUB."
},
"pageSize": {
"type": "integer",
"description": "Items per page, 1–20 (default 10)."
},
"radiusKm": {
"type": "number",
"description": "Search radius around the place, km (default 3, max 50; ~1 for «в шаговой доступности»)."
},
"maxRating": {
"type": "number",
"description": "Salon rating at most this (1–5)."
},
"minRating": {
"type": "number",
"description": "Salon rating at least this (1–5). Salons without reviews are excluded when any rating bound is set."
},
"minReviews": {
"type": "integer",
"description": "With a rating bound: at least this many reviews (default 1)."
}
},
"additionalProperties": false
}| What the service is, in Russian: «маникюр», «стрижка», «массаж спины», «окрашивание». |
| category | string | Category id from list_categories. |
| maxPrice | number | Service price at most this, RUB. |
| minPrice | number | Service price at least this, RUB. |
| pageSize | integer | Items per page, 1–20 (default 10). |
| radiusKm | number | Search radius around the place, km (default 3, max 50; ~1 for «в шаговой доступности»). |
| minReviews | integer | With a rating bound: at least this many reviews behind each bounded rating (default 1). |
| maxSalonRating | number | Salon rating at most (1–5). |
| minSalonRating | number | Salon rating at least (1–5). |
| maxMasterRating | number | Some master of the service rated at most (1–5). |
| minMasterRating | number | Some master of the service rated at least (1–5). |
| maxServiceRating | number | Rating of this service at most (1–5). |
| minServiceRating | number | Rating of this service at least (1–5). |
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude of the place to search around (instead of `near`)."
},
"lng": {
"type": "number",
"description": "Longitude of the place to search around (instead of `near`)."
},
"city": {
"type": "string",
"description": "Only businesses whose address contains this text, e.g. a city «Казань». Ignored when a place is given."
},
"near": {
"type": "string",
"description": "A place to search around: address, metro station or landmark, with the city — «Москва, метро Сокол», «Казань, Баумана 10». Used for «рядом», «около», «недалеко», «поблизости»."
},
"page": {
"type": "integer",
"description": "Page number, from 0."
},
"sort": {
"enum": [
"rating",
"salon_rating",
"distance",
"price_asc",
"price_desc"
],
"type": "string",
"description": "Order. Default: distance when a place is given, otherwise the service's rating."
},
"query": {
"type": "string",
"description": "What the service is, in Russian: «маникюр», «стрижка», «массаж спины», «окрашивание»."
},
"category": {
"type": "string",
"description": "Category id from list_categories."
},
"maxPrice": {
"type": "number",
"description": "Service price at most this, RUB."
},
"minPrice": {
"type": "number",
"description": "Service price at least this, RUB."
},
"pageSize": {
"type": "integer",
"description": "Items per page, 1–20 (default 10)."
},
"radiusKm": {
"type": "number",
"description": "Search radius around the place, km (default 3, max 50; ~1 for «в шаговой доступности»)."
},
"minReviews": {
"type": "integer",
"description": "With a rating bound: at least this many reviews behind each bounded rating (default 1)."
},
"maxSalonRating": {
"type": "number",
"description": "Salon rating at most (1–5)."
},
"minSalonRating": {
"type": "number",
"description": "Salon rating at least (1–5)."
},
"maxMasterRating": {
"type": "number",
"description": "Some master of the service rated at most (1–5)."
},
"minMasterRating": {
"type": "number",
"description": "Some master of the service rated at least (1–5)."
},
"maxServiceRating": {
"type": "number",
"description": "Rating of this service at most (1–5)."
},
"minServiceRating": {
"type": "number",
"description": "Rating of this service at least (1–5)."
}
},
"additionalProperties": false
}