Servidor MCP
SzuruSzuru – rezerwacja czyszczenia tapicerki
pl.szuruszuru/booking
Qué hace este MCP
Quotes, checks availability, and manages bookings, rescheduling, and cancellations for on-site upholstery, carpet, rug, and mattress cleaning in Pomorskie.
Capacidades
Herramientas
13
herramientas
calculate_quote
Wycena
Calculates a binding quote for one or more services at a postal code: unit prices, quantity discounts, add-ons, travel fee and minimum order are computed by the SzuruSzuru backend. Returns quote_id (valid ~30 minutes) required by check_availability. Do not estimate or adjust prices yourself; if the quote is below the minimum order, ask the customer to add a service.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['postal_code', 'items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'quantity'], 'properties': {'addons': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 2}, 'maxItems': 10, 'description': 'Add-on names exactly as listed for the service'}, 'service': {'type': 'string', 'pattern': '^[a-z0-9_\\-]+$', 'maxLength': 64, 'minLength': 2, 'description': 'Service id from list_upholstery_services'}, 'quantity': {'type': 'number', 'maximum': 500, 'minimum': 0.5, 'description': 'Pieces, mattress sides (1-2) or square metres for carpets'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28, 'description': 'Session id from a previous response (keeps quote, slots and confirmation together)'}, 'postal_code': {'type': 'string', 'pattern': '^\\d{2}-?\\d{3}$', 'maxLength': 6, 'minLength': 5}}, 'additionalProperties': False}
cancel_booking
Anuluj rezerwację
Cancels the verified customer's booking. Irreversible - ask the customer to confirm explicitly before calling. Requires customer_grant or a signed-in customer and an idempotency_key.
Destructivo
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['booking_reference', 'idempotency_key'], 'properties': {'reason': {'type': 'string', 'maxLength': 120, 'description': 'Optional short reason given by the customer'}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'customer_grant': {'type': 'string', 'maxLength': 80, 'minLength': 20}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9._:\\-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'booking_reference': {'type': 'string', 'pattern': '^[A-Za-z0-9\\-]{8,20}$', 'maxLength': 20, 'minLength': 8}}, 'additionalProperties': False}
check_availability
Sprawdź terminy
Returns real, currently bookable appointment slots for a quote_id (new booking) or for an existing booking_reference (rescheduling; requires customer_grant). Filter by preference: type asap | date | range | preferred plus optional part_of_day. Slots expire after ~15 minutes and are the only valid source of slot_id. Never assume availability without calling this tool.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {'wanted': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10}, 'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'maxLength': 10}, 'type': {'enum': ['asap', 'date', 'range', 'preferred'], 'type': 'string', 'default': 'asap'}, 'part_of_day': {'enum': ['morning', 'afternoon', 'evening'], 'type': 'string'}, 'preferred_time': {'type': 'string', 'pattern': '^([01]\\d|2[0-3]):[0-5]\\d$', 'maxLength': 5}}, 'additionalProperties': False}, 'quote_id': {'type': 'string', 'pattern': '^q_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'customer_grant': {'type': 'string', 'maxLength': 80, 'minLength': 20, 'description': 'From verify_phone_code (only for booking_reference)'}, 'booking_reference': {'type': 'string', 'pattern': '^[A-Za-z0-9\\-]{8,20}$', 'maxLength': 20, 'minLength': 8}}, 'additionalProperties': False}
check_service_area
Sprawdź obszar
Checks whether SzuruSzuru serves a Polish postal code (format NN-NNN, e.g. 83-300). Returns availability and the town name only. Does not reserve anything and does not reveal staff or schedules.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['postal_code'], 'properties': {'postal_code': {'type': 'string', 'pattern': '^\\d{2}-?\\d{3}$', 'maxLength': 6, 'minLength': 5}}, 'additionalProperties': False}
create_booking
Potwierdź rezerwację
Creates the confirmed SzuruSzuru booking for a prepared confirmation_id after the customer provides the 6-digit SMS code. Use the same idempotency_key when retrying after a timeout - it will never create a second booking. Price, slot, schedule and identity are re-validated by the backend; the call fails with a clear code if anything changed. Returns booking_reference, time and total.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['confirmation_id', 'sms_code', 'idempotency_key'], 'properties': {'sms_code': {'type': 'string', 'pattern': '^\\s*\\d{3}\\s?\\d{3}\\s*$', 'maxLength': 8, 'minLength': 6}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'confirmation_id': {'type': 'string', 'pattern': '^c_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9._:\\-]{8,128}$', 'maxLength': 128, 'minLength': 8}}, 'additionalProperties': False}
get_my_bookings
Moje rezerwacje
Lists the verified customer's bookings from the last 90 days (reference, services, time, price, status, whether they can be rescheduled or cancelled). Requires customer_grant or a signed-in customer. Never shows other customers' data.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'customer_grant': {'type': 'string', 'maxLength': 80, 'minLength': 20}, 'booking_reference': {'type': 'string', 'pattern': '^[A-Za-z0-9\\-]{8,20}$', 'maxLength': 20, 'minLength': 8, 'description': 'Optional: one booking instead of the list'}}, 'additionalProperties': False}
get_service_requirements
Wymagania usługi
Returns everything needed to quote one service: unit, quantity limits, variants, optional add-ons and a short factual description. Use it when the customer's request is ambiguous (e.g. corner sofa size, carpet area in m2). Read-only.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['service'], 'properties': {'service': {'type': 'string', 'pattern': '^[a-z0-9_\\-]+$', 'maxLength': 64, 'minLength': 2, 'description': 'Service id from list_upholstery_services'}}, 'additionalProperties': False}
list_upholstery_services
Lista usług SzuruSzuru
Lists SzuruSzuru's upholstery, carpet, rug and mattress cleaning services (Pomeranian region, Poland) with unit prices in PLN, units (piece / m2 / mattress side), add-ons and required parameters. Read-only. Does not check coverage or availability - use check_service_area and check_availability for that. Prices come from the live catalog; never estimate a price yourself.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'category': {'enum': ['chairs', 'furniture', 'leather', 'mattress', 'carpet'], 'type': 'string', 'description': 'Optional filter (leather = leather furniture)'}}, 'additionalProperties': False}
prepare_booking
Przygotuj rezerwację
Prepares a booking for a chosen slot: validates the quote and slot, holds the slot for 10 minutes, records the customer's details and terms acceptance, and sends an SMS confirmation code to the customer's Polish mobile number. Returns confirmation_id and a `summary` that must be shown to the customer verbatim. Does NOT create the booking - the customer must read the code from the SMS and you must call create_booking. Requires the customer's explicit agreement to book and to the terms (terms_accepted=true).
Esquema de entrada
{'type': 'object', 'required': ['quote_id', 'slot_id', 'customer', 'terms_accepted'], 'properties': {'notes': {'type': 'string', 'maxLength': 200, 'description': 'Optional note for the cleaner (fabric type, stains, parking)'}, 'slot_id': {'type': 'string', 'pattern': '^s_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'customer': {'type': 'object', 'required': ['name', 'address'], 'properties': {'city': {'type': 'string', 'maxLength': 80}, 'name': {'type': 'string', 'maxLength': 100, 'minLength': 5, 'description': 'First and last name'}, 'email': {'type': 'string', 'maxLength': 254, 'description': 'Optional'}, 'phone': {'type': 'string', 'pattern': '^[+\\d][\\d\\s\\-]{8,19}$', 'maxLength': 20, 'minLength': 9, 'description': 'Polish mobile number (optional when the customer is signed in)'}, 'address': {'type': 'string', 'maxLength': 200, 'minLength': 4, 'description': 'Street and house/flat number'}}, 'additionalProperties': False}, 'quote_id': {'type': 'string', 'pattern': '^q_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'invoice_data': {'type': 'object', 'properties': {'nip': {'type': 'string', 'pattern': '^[0-9\\-]{10,13}$', 'maxLength': 13, 'minLength': 10}, 'address': {'type': 'string', 'maxLength': 200}, 'company': {'type': 'string', 'maxLength': 150}}, 'additionalProperties': False}, 'terms_accepted': {'type': 'boolean', 'description': 'Customer accepted the terms and the consent text (must be true)'}}, 'additionalProperties': False}
reschedule_booking
Zmień termin
Moves the verified customer's booking to a slot_id obtained from check_availability(booking_reference). Cannot change price or services. Ask the customer to confirm the new time before calling. Requires customer_grant or a signed-in customer and an idempotency_key.
Destructivo
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['booking_reference', 'slot_id', 'idempotency_key'], 'properties': {'slot_id': {'type': 'string', 'pattern': '^s_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'customer_grant': {'type': 'string', 'maxLength': 80, 'minLength': 20}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9._:\\-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'booking_reference': {'type': 'string', 'pattern': '^[A-Za-z0-9\\-]{8,20}$', 'maxLength': 20, 'minLength': 8}}, 'additionalProperties': False}
resend_confirmation_code
Wyślij kod ponownie
Re-sends the SMS confirmation code for a prepared booking (rate-limited: at most one code per minute and three per 30 minutes per phone). Use only when the customer says the SMS did not arrive.
Esquema de entrada
{'type': 'object', 'required': ['confirmation_id'], 'properties': {'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'confirmation_id': {'type': 'string', 'pattern': '^c_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}}, 'additionalProperties': False}
start_phone_verification
Weryfikacja numeru
Sends an SMS code to a Polish mobile number to prove the customer controls it, so their existing bookings can be accessed, rescheduled or cancelled. The response is the same whether or not the number is known to SzuruSzuru. Not needed for a new booking (prepare_booking sends its own code).
Esquema de entrada
{'type': 'object', 'required': ['phone'], 'properties': {'phone': {'type': 'string', 'pattern': '^[+\\d][\\d\\s\\-]{8,19}$', 'maxLength': 20, 'minLength': 9}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}}, 'additionalProperties': False}
verify_phone_code
Potwierdź kod
Exchanges the SMS code from start_phone_verification for a short-lived customer_grant (60 minutes) scoped to the customer's own bookings. Pass customer_grant to get_my_bookings, check_availability(booking_reference), reschedule_booking and cancel_booking.
Esquema de entrada
{'type': 'object', 'required': ['verification_id', 'code'], 'properties': {'code': {'type': 'string', 'pattern': '^\\s*\\d{3}\\s?\\d{3}\\s*$', 'maxLength': 8, 'minLength': 6}, 'session_id': {'type': 'string', 'pattern': '^as_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}, 'verification_id': {'type': 'string', 'pattern': '^v_[0-9a-z]{26}$', 'maxLength': 40, 'minLength': 28}}, 'additionalProperties': False}
Historial
Cambios recientes en herramientas
Añadido
cancel_booking
21 de September de 2026 a las 02:40
Añadido
reschedule_booking
21 de September de 2026 a las 02:40
Añadido
get_my_bookings
21 de September de 2026 a las 02:40
Añadido
verify_phone_code
21 de September de 2026 a las 02:40
Añadido
start_phone_verification
21 de September de 2026 a las 02:40
Añadido
create_booking
21 de September de 2026 a las 02:40
Añadido
resend_confirmation_code
21 de September de 2026 a las 02:40
Añadido
prepare_booking
21 de September de 2026 a las 02:40
Añadido
check_availability
21 de September de 2026 a las 02:40
Añadido
calculate_quote
21 de September de 2026 a las 02:40
Añadido
check_service_area
21 de September de 2026 a las 02:40
Añadido
get_service_requirements
21 de September de 2026 a las 02:40
Añadido
list_upholstery_services
21 de September de 2026 a las 02:40
Descubrir
Servidores MCP similares
AdButler
com.adbutler/mcp-server
Manages AdButler advertisers, campaigns, ad items, audiences, zones, creatives, catalogs, and advertising reports.
Duvo MCP
io.github.duvoai/duvo
Provides governed retail and CPG operations for cases, queues, approvals, automations, process documentation, integrations, and a…
Lovie Company Formation
co.lovie/company-formation
Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…
freedom-mcp
com.getfreedomos/freedom-mcp
Supports company operations through commitments, teams, agents, customer evidence, leads, content workflows, spreadsheets, commer…
独行录 / opcmenu
io.github.yzlee/opcmenu
Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…
Meta Council
com.meta-council/decision-intelligence
Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting a…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…