Cleaning service management — book appointments, manage jobs, customer scheduling
@pampalini1
MCP server for ShineByGrace, a domestic cleaning service in the UK. Book and manage cleaning appointments, assign cleaners to customers, track job schedules, and communicate with staff — all via AI tool use.
Overview
What is Cleaning service management — book appointments, manage jobs, customer scheduling?
A cleaning service management platform that exposes 13 AI-callable tools for customers and staff via the Model Context Protocol. It integrates with the ShineByGrace system (https://shinebygrace.co.uk) and is designed for customers booking appointments and staff managing jobs.
How to use Cleaning service management — book appointments, manage jobs, customer scheduling?
Connect using claude mcp add --transport http shinebygrace https://shinebygrace.co.uk/api/mcp --header "Authorization: Bearer sbg_st_YOUR_TOKEN" (staff) or a customer token. Tools are called by AI after authentication.
Key features of Cleaning service management — book appointments, manage jobs, customer scheduling
- 13 AI-callable tools split into customer and staff sets
- Customer tools: check slots, book, cancel, reschedule, message staff
- Staff tools: list/create/update/complete jobs, manage customers
- Bearer token authentication with scoped access
- Tokens prefixed
sbg_cu_(customer) orsbg_st_(staff) - Integrates with a live API at shinebygrace.co.uk
Use cases of Cleaning service management — book appointments, manage jobs, customer scheduling
- Customers book cleaning appointments via an AI assistant
- Customers cancel or reschedule upcoming jobs
- Customers message their cleaner or escalate to management
- Staff view and manage all scheduled cleaning jobs
- Staff assign cleaners to customers and update job details
FAQ from Cleaning service management — book appointments, manage jobs, customer scheduling
What tool prefixes are available?
Customer tools use the prefix sbg_cu_; staff tools use sbg_st_.
How do I authenticate?
Use a Bearer token in the Authorization header. Tokens are scoped: staff tokens are generated by admins; customer tokens by customers via their portal.
How do I connect an AI client?
Use the MCP add command with HTTP transport and the server URL https://shinebygrace.co.uk/api/mcp, including the appropriate token header.
Where is the OpenAPI spec?
Available at https://shinebygrace.co.uk/openapi.json.
What transports are supported?
The README shows HTTP transport; no other transports are mentioned.
