Cleaning service management — book appointments, manage jobs, customer scheduling
@ShineByGrace
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
ShineByGrace MCP Server
A cleaning service management platform with 13 AI-callable tools.
Tools
Customer tools (token prefix sbg_cu_):
get_available_slots— check available booking timescreate_booking— book a cleaning appointmentcancel_job— cancel an upcoming jobrequest_reschedule— request a job reschedulesend_message_to_agent— message your assigned cleanersend_message_to_manager— escalate to management
Staff tools (token prefix sbg_st_):
list_jobs— list scheduled jobscreate_job— schedule a new cleaning jobupdate_job— modify job detailscomplete_job— mark a job as completelist_customers— list all customersget_customer— get customer detailsassign_agent_access— assign a cleaner to a customer
Authentication
Bearer token authentication. Tokens are scoped:
- Staff tokens (
sbg_st_) — generated by admins in the dashboard - Customer tokens (
sbg_cu_) — generated by customers in their portal
Connect
claude mcp add --transport http shinebygrace https://shinebygrace.co.uk/api/mcp --header "Authorization: Bearer sbg_st_YOUR_TOKEN"
Links
- Website: https://shinebygrace.co.uk
- OpenAPI spec: https://shinebygrace.co.uk/openapi.json
- A2A Agent Card: https://shinebygrace.co.uk/.well-known/agent.json
Server Config
{
"mcpServers": {
"shinebygrace": {
"url": "https://shinebygrace.co.uk/api/mcp",
"headers": {
"Authorization": "Bearer sbg_st_YOUR_TOKEN"
}
}
}
}