Skip to main content
Glama
Sign In
deenesjakoruzh
maideo

maideo

by ikki-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

@maideo/mcp

Official MCP (Model Context Protocol) server for the Maideo Agent API.

Lets any MCP-compatible AI agent (Claude Desktop, Claude Code, ChatGPT desktop, Continue.dev, Cursor, etc.) book professional home cleaning services (ménage à domicile) anywhere in France, end-to-end, without human intervention.

What it does

  • Checks coverage by postal code

  • Returns a firm price quote

  • Creates a booking in Maideo's back-office (visible to the ops team)

  • Enrolls the end user with URSSAF for the 50% immediate tax credit advance (no card payment needed — SEPA direct debit after each intervention)

  • Polls booking status

Related MCP server: Sherlock Homes

Tools exposed

Tool

Purpose

search_coverage

Check if Maideo serves a zip code

get_quote

Get a firm 72h-valid price quote

create_booking

Create the booking (returns a 72h bookingToken)

enroll_avance_immediate

Submit URSSAF enrollment (IBAN + identity)

get_booking_status

Poll status (order, worker, URSSAF)

Install

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

Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maideo": {
      "command": "npx",
      "args": ["-y", "@maideo/mcp"],
      "env": {
        "MAIDEO_AGENT_NAME": "claude-desktop"
      }
    }
  }
}

Restart Claude Desktop. You can now ask Claude:

"Can you book me a weekly 3-hour cleaning at 12 rue de Rivoli, 75001 Paris, starting next Monday?"

Claude will chain the 5 tools automatically.

Configure Claude Code

claude mcp add maideo npx -- -y @maideo/mcp

Environment variables

Variable

Default

Purpose

MAIDEO_API_BASE

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

API base URL (override for staging/dev)

MAIDEO_AGENT_NAME

maideo-mcp-client

Identifier sent via X-Agent-Name header (used for rate limiting and analytics)

Anti-fraud hold

All bookings created via this MCP server are held for 48h before worker dispatch. The Maideo ops team may phone/SMS the end user to verify. Do not submit bookings with fake data in production. Your MAIDEO_AGENT_NAME may be blocklisted.

You must also collect explicit consent from the end user before calling create_booking. Pass agentConsent: true as a binding attestation.

How payment works (there is no payment step)

Maideo uses the URSSAF avance immédiate de crédit d'impôt (immediate tax credit advance), a French government program for home services.

  1. End user enrolls via enroll_avance_immediate — provides identity, birth place, address, IBAN

  2. Worker does the cleaning

  3. Maideo declares the hours to URSSAF

  4. URSSAF pays Maideo directly for 50% of the amount (the tax credit portion)

  5. URSSAF collects the remaining 50% from the end user via SEPA direct debit

No card, no Stripe, no upfront payment, no signed PDF. The IBAN + identity are enough.

Links

License

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…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • SF Cleaning Service

      Rana-X
      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
      -

    • Sherlock Homes

      RomainLaffitau
      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.
      -

    • 11fgb-cleaning-tools-mcp

      kossik
      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
    • Normi — French Real Estate Data (DVF)

      Normi — French Real Estateofficial

      NormiHQ
      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