MCP server
MaidCentral MCP by usefulapi
Read services, prices and open dates; create leads, quotes, bookings and notes in…
- Runs
- Remotely
- Version
- 1.7.0
- Listing updated
- 4 days ago
About MaidCentral MCP by usefulapi
MaidCentral MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read services, prices and open dates; create leads, quotes, bookings and notes in MaidCentral.
Install
Run in a terminal
claude mcp add --transport http maidcentral https://maidcentral.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://maidcentral.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"maidcentral": {
"url": "https://maidcentral.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"maidcentral": {
"type": "http",
"url": "https://maidcentral.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"maidcentral": {
"serverUrl": "https://maidcentral.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"maidcentral": {
"type": "http",
"url": "https://maidcentral.usefulapi.io/mcp"
}
}
}Tools this server provides (20)
Read directly from the server.
- maidcentral_list_scope_groups
- List service categories (scope groups) with their scopes of work and frequency ids. Start here: the ids feed quotes, pricing and bookings. API: GET /api/Lead/ScopeGroups.
- maidcentral_list_scopes
- List the scopes of work (and frequencies) of one scope group. API: GET /api/Lead/Scopes.
- maidcentral_list_scope_frequencies
- List the frequency options (one-time, weekly, ...) of one scope. API: GET /api/Lead/ScopeFrequencies.
- maidcentral_list_questions
- List the questions (home size, bedrooms, ...) and answer options for one or more scopes. Required questions must be answered in quotes and pricing. API: GET /api/Lead/Questions.
- maidcentral_list_rate_modifications
- List the extras, discounts and other rate modifications available for a scope group. API: GET /api/Lead/RateModifications.
- maidcentral_list_available_dates
- List dates on which a quoted job of a given length or price can be booked for a scope group. Give hours or amount. API: GET /api/Lead/Availability.
- maidcentral_list_postal_codes
- List the postal codes the company serves, with their home zone. API: GET /api/Lead/PostalCodes.
- maidcentral_list_customer_sources
- List customer (lead) sources. API: GET /api/Lead/CustomerSources.
- maidcentral_list_billing_terms
- List billing terms usable when booking. API: GET /api/Lead/BillingTerms.
- maidcentral_list_teams
- List teams that jobs can be scheduled to. API: GET /api/Lead/Teams.
- maidcentral_list_tags
- List tags with their category ids (lead tags = category 8, service set tags = 5, first job tags = 6). API: GET /api/Lead/Tags.
- maidcentral_list_note_types
- List note types (Email = 1, Note = 2, PhoneCall = 3, TextMessage = 4). API: GET /api/Note/Types.
- maidcentral_get_lead
- Get a lead by id: contact details, status, source, scope group and addresses. API: GET /api/Lead/Lead.
- maidcentral_get_quote
- Get a quote by id: status, addresses, and per-scope and per-frequency prices, hours and booked state. API: GET /api/Lead/Quote.
- maidcentral_calculate_price
- Calculate a price for scopes, frequencies, extras and question answers without creating a lead or quote. Stores nothing. API: POST /api/Lead/CalculatePrice.
- maidcentral_create_or_update_lead
- WRITE: create a lead, or update one when lead_id is given. The postal code must be in a home zone. By default MaidCentral may send the lead email, add the lead to campaigns and trigger webhooks: set send_lead_email, add_to_campaigns and trigger_webhook to false to avoid that. Without allow_duplicates, a matching contact links to the existing lead. API: POST /api/Lead/CreateOrUpdate.
- maidcentral_create_or_update_quote
- WRITE: create a quote for a lead (or update one when quote_id is given) with service address, scopes, frequencies and question answers. Optionally emails the quote 5 minutes later (send_quote_email, default false). API: POST /api/Lead/CreateOrUpdateQuote.
- maidcentral_book_quote
- WRITE: convert a quote into a customer and schedule the first job on first_job_date. Check dates with maidcentral_list_available_dates first. Booking emails default to the vendor setting: set send_booked_email and send_customer_portal_invite to false to stay silent. API: POST /api/Lead/BookQuote.
- maidcentral_create_note
- WRITE: add a note (or logged email, call, text) to a quote, customer or employee. Give entity_id with entity_type_id, or entity_contact_info (email or phone). API: POST /api/Note/Create.
- maidcentral_add_utm_data
- WRITE: attach UTM campaign data to a lead or quote. Give lead_id, email or phone. API: POST /api/Lead/Utm.
MaidCentral MCP by usefulapi FAQ
How do I add MaidCentral MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http maidcentral https://maidcentral.usefulapi.io/mcp