maideo
@maideo/mcp
Servidor oficial MCP (Model Context Protocol) para la API de Maideo Agent.
Permite que cualquier agente de IA compatible con MCP (Claude Desktop, Claude Code, ChatGPT desktop, Continue.dev, Cursor, etc.) reserve servicios profesionales de limpieza a domicilio (ménage à domicile) en cualquier lugar de Francia, de principio a fin, sin intervención humana.
Qué hace
Comprueba la cobertura por código postal
Devuelve un presupuesto firme
Crea una reserva en el back-office de Maideo (visible para el equipo de operaciones)
Inscribe al usuario final en URSSAF para el anticipo inmediato del 50% del crédito fiscal (no se necesita pago con tarjeta; domiciliación bancaria SEPA después de cada intervención)
Consulta el estado de la reserva
Related MCP server: Sherlock Homes
Herramientas expuestas
Herramienta | Propósito |
| Comprobar si Maideo presta servicio en un código postal |
| Obtener un presupuesto firme válido por 72h |
| Crear la reserva (devuelve un |
| Enviar la inscripción a URSSAF (IBAN + identidad) |
| Consultar el estado (pedido, trabajador, URSSAF) |
Instalación
npm install -g @maideo/mcp
# or use npx without installing:
npx @maideo/mcpConfigurar Claude Desktop
Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"maideo": {
"command": "npx",
"args": ["-y", "@maideo/mcp"],
"env": {
"MAIDEO_AGENT_NAME": "claude-desktop"
}
}
}
}Reinicie Claude Desktop. Ahora puede pedirle a Claude:
"¿Puedes reservarme una limpieza semanal de 3 horas en 12 rue de Rivoli, 75001 París, a partir del próximo lunes?"
Claude encadenará las 5 herramientas automáticamente.
Configurar Claude Code
claude mcp add maideo npx -- -y @maideo/mcpVariables de entorno
Variable | Predeterminado | Propósito |
|
| URL base de la API (sobrescribir para staging/dev) |
|
| Identificador enviado a través de la cabecera |
Retención antifraude
Todas las reservas creadas a través de este servidor MCP se retienen durante 48 horas antes de asignar al trabajador. El equipo de operaciones de Maideo puede llamar o enviar un SMS al usuario final para verificar. No envíe reservas con datos falsos en producción. Su MAIDEO_AGENT_NAME podría ser incluido en una lista negra.
También debe obtener el consentimiento explícito del usuario final antes de llamar a create_booking. Pase agentConsent: true como atestación de vinculación.
Cómo funciona el pago (no hay paso de pago)
Maideo utiliza el avance immédiate de crédit d'impôt (anticipo inmediato del crédito fiscal) de URSSAF, un programa del gobierno francés para servicios a domicilio.
El usuario final se inscribe a través de
enroll_avance_immediate: proporciona identidad, lugar de nacimiento, dirección, IBANEl trabajador realiza la limpieza
Maideo declara las horas a URSSAF
URSSAF paga a Maideo directamente el 50% del importe (la parte del crédito fiscal)
URSSAF cobra el 50% restante al usuario final mediante domiciliación bancaria SEPA
Sin tarjeta, sin Stripe, sin pago por adelantado, sin PDF firmado. El IBAN + la identidad son suficientes.
Enlaces
Licencia
MIT
Available Tools
5 toolscreate_bookingA
Create a booking. Requires a quoteToken from get_quote plus the end-user's identity, address, and explicit consent. Returns a bookingToken (72h) for subsequent calls and a bookingId. The booking is held for 48h before worker dispatch as anti-fraud protection.
Inputs: quoteToken (required), client (required), address (required), dateDebut (required), +5 more.
enroll_avance_immediateA
Enroll the end user with URSSAF for the 50% immediate tax credit advance. After this succeeds, the user pays only half the gross hourly rate via SEPA. Required: bookingToken from create_booking, full identity, birth place, postal address, IBAN.
Inputs: bookingId (required), bookingToken (required), civilite (required), nomNaissance (required), +8 more.
get_booking_statusA
Poll the current status of a booking (order, mission, worker assignment, URSSAF enrollment). Requires bookingId + bookingToken from create_booking.
Inputs: bookingId (required), bookingToken (required).
get_quoteA
Get a firm price quote for a cleaning booking. Returns a quoteToken valid for 72h that must be passed to create_booking.
Inputs: zip (required), nbHeuresSemaine (required), frequency (required), city, +3 more.
search_coverageA
Check whether Maideo serves a given French postal code and get the estimated hourly rate (gross, before the 50% tax credit advance). Use this BEFORE get_quote.
Inputs: zip (required), prestation.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct, non-overlapping purpose: search_coverage checks service availability, get_quote provides pricing, create_booking initiates a booking, enroll_avance_immediate handles tax credit enrollment, and get_booking_status tracks progress. The descriptions clearly differentiate their roles in the booking workflow, leaving no ambiguity for agent selection.
Four tools follow a consistent verb_noun pattern (create_booking, get_booking_status, get_quote, search_coverage), but enroll_avance_immediate deviates with a mixed verb_noun structure and includes a French term. This minor inconsistency slightly disrupts the pattern but remains readable and understandable.
With 5 tools, this server is well-scoped for its domain of booking and managing cleaning services. Each tool serves a specific step in the workflow (coverage check, quoting, booking, enrollment, status tracking), and none feel redundant or missing, making the count appropriate for the purpose.
The tool set provides complete coverage for the booking lifecycle: search_coverage initiates the process, get_quote handles pricing, create_booking creates the booking, enroll_avance_immediate manages tax credit enrollment, and get_booking_status allows tracking. There are no obvious gaps, and the tools support a seamless workflow from start to finish.
Maintenance
Related MCP Connectors
Quote, hold and book US house cleaning jobs on a customer's behalf, at each business's own prices.
Search and book local services in France: real availability, quotes, consented one-tap bookings.
Quotes, invoices, French e-invoicing, website and bookings for French freelancers.
Quote and book home cleaning in Paris & Île-de-France; request office-cleaning quotes.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceEnables booking cleaning services in San Francisco by collecting customer details and automatically sending booking requests via email to service partners.1-
- FlicenseNot gradedqualityDmaintenanceFrench real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings. Coverage: metropolitan France.-
- AlicenseNot gradedqualityDmaintenanceProvides deterministic cleaning cost, time, crew, and chemical usage estimates for homes and offices via MCP and HTTP endpoints.MIT
- AlicenseNot gradedqualityCmaintenanceAccess 17M+ geocoded French property transactions (DVF), 22M+ DPE energy ratings, and 20M+ building records via MCP or REST API. Search transactions, market stats, comparables, price trends, rental yield, flip detection, and more.MIT