Cleaning service management — book appointments, manage jobs, customer scheduling
About
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.
Details
- Author
- pampalini1
- Downloads
- 244
- Categories
- Search
Jump to
- 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) or sbg_st_ (staff)
- Integrates with a live API at shinebygrace.co.uk
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Cleaning service management — book appointments, manage jobs, customer schedulingCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
"shinebygrace": {
"url": "https://shinebygrace.co.uk/api/mcp",
"headers": {
"Authorization": "Bearer sbg_st_YOUR_TOKEN"
}
}
}
}
}McpServers
{
"shinebygrace": {
"url": "https://shinebygrace.co.uk/api/mcp",
"headers": {
"Authorization": "Bearer sbg_st_YOUR_TOKEN"
}
}
}ShineByGrace MCP Server
A cleaning service management platform with 13 AI-callable tools.Tools
Customer tools (token prefixsbg_cu_):
- get_available_slots — check available booking times
- create_booking — book a cleaning appointment
- cancel_job — cancel an upcoming job
- request_reschedule — request a job reschedule
- send_message_to_agent — message your assigned cleaner
- send_message_to_manager — escalate to management
Staff tools (token prefix sbg_st_):
- list_jobs — list scheduled jobs
- create_job — schedule a new cleaning job
- update_job — modify job details
- complete_job — mark a job as complete
- list_customers — list all customers
- get_customer — get customer details
- assign_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.jsonSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
