Skip to main content
Glama

@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

search_coverage

Comprobar si Maideo presta servicio en un código postal

get_quote

Obtener un presupuesto firme válido por 72h

create_booking

Crear la reserva (devuelve un bookingToken de 72h)

enroll_avance_immediate

Enviar la inscripción a URSSAF (IBAN + identidad)

get_booking_status

Consultar el estado (pedido, trabajador, URSSAF)

Instalación

npm install -g @maideo/mcp
# or use npx without installing:
npx @maideo/mcp

Configurar 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/mcp

Variables de entorno

Variable

Predeterminado

Propósito

MAIDEO_API_BASE

https://api.maideo.fr/public/agent

URL base de la API (sobrescribir para staging/dev)

MAIDEO_AGENT_NAME

maideo-mcp-client

Identificador enviado a través de la cabecera X-Agent-Name (usado para limitación de tasa y analíticas)

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.

  1. El usuario final se inscribe a través de enroll_avance_immediate: proporciona identidad, lugar de nacimiento, dirección, IBAN

  2. El trabajador realiza la limpieza

  3. Maideo declara las horas a URSSAF

  4. URSSAF paga a Maideo directamente el 50% del importe (la parte del crédito fiscal)

  5. 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 tools
create_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

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      Not graded
      maintenance
      Enables booking cleaning services in San Francisco by collecting customer details and automatically sending booking requests via email to service partners.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      French real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings. Coverage: metropolitan France.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides deterministic cleaning cost, time, crew, and chemical usage estimates for homes and offices via MCP and HTTP endpoints.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Access 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