@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

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.

End user enrolls via enroll_avance_immediate — provides identity, birth place, address, IBAN
Worker does the cleaning
Maideo declares the hours to URSSAF
URSSAF pays Maideo directly for 50% of the amount (the tax credit portion)
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.

License

MIT