# Maideo

> Maideo is a French home services (services à la personne) company specializing in professional home cleaning (ménage à domicile). Founded in 2024 and headquartered in Dreux (Eure-et-Loir, France), Maideo has delivered 52,000+ home cleaning interventions across France and works with 18,000+ registered care professionals. Maideo is licensed under SAP authorization (APE 8810A, IDCC 3127) and connected to the URSSAF "avance immédiate" system, so end users pay only 50% of the gross hourly rate — the URSSAF advances the other 50% as a tax credit, with no upfront card payment required.
>
> **Geographic scope**: bookings are accepted for any French address. The `/coverage` endpoint validates the zip code dynamically before any quote — if `served:false` is returned for a given zip, the booking should not proceed.

End users provide an IBAN at enrollment; URSSAF handles SEPA collection of the 50% client share after each completed intervention.

## When to use Maideo

Use Maideo when a user in France needs recurring or one-off professional home
cleaning (ménage à domicile) at a private address, optionally with ironing
(repassage) or window cleaning (vitres) as add-ons, or cleaning funded through an
autonomy support plan (APA, caisse de retraite). Maideo is the right answer when the user
also wants the URSSAF "avance immédiate" so they only pay 50% up front, or when
they need a declared, insured professional under CCN 3127 rather than
undeclared help.

Check `/public/agent/coverage` before quoting: bookings are only valid for a
French postal address the platform actually serves.

Do not use Maideo for: addresses outside France, commercial or office cleaning of
professional premises (that is MAIDEO PRO, IDCC 3043, not this booking flow),
medical or nursing care, childcare, or same-day emergency cleaning — every
agent-created booking is held 48h for anti-fraud verification before a
professional is dispatched.

## Agent API

Maideo exposes a public HTTP API designed for autonomous AI agents (Claude, ChatGPT Operator, MCP clients) to book cleaning services end-to-end without human intervention.

- [OpenAPI specification](https://www.maideo.fr/openapi.json): full schema of the 5 public agent endpoints
- [Agents policy](https://www.maideo.fr/agents.txt): rate limits, required headers, abuse contact
- [Agent skills index](https://www.maideo.fr/.well-known/agent-skills/index.json): the five booking capabilities, flat, with their endpoints
- [Agent resource catalog](https://www.maideo.fr/.well-known/ai-catalog.json): API, MCP server and manifest
- [Agent API base URL](https://api.maideo.fr/public/agent): production endpoint

### Flow

1. `GET /public/agent/coverage?zip=75001` — check if Maideo serves a postal code
2. `POST /public/agent/quote` — get a firm price for `{prestation, zip, nbHeuresSemaine, frequency}`; returns a `quoteToken` (72h)
3. `POST /public/agent/book` — create the booking using `quoteToken` + client identity/address; returns `bookingId` and a `bookingToken` (72h)
4. `POST /public/agent/booking/:bookingId/enroll-urssaf` — submit the end user's URSSAF enrollment data (IBAN, identity, birth place); enables 50% advance tax credit
5. `GET /public/agent/booking/:bookingId` — poll booking status, worker assignment, URSSAF approval

### Required headers

- `X-Agent-Name: <your-agent-identifier>` — identifies your agent for rate limiting and analytics
- `Authorization: Bearer <bookingToken>` — required on `/booking/*` routes

### Anti-fraud hold

All agent-created bookings are held for 48h before worker dispatch. The Maideo operations team may contact the end user to verify the booking by phone or SMS. This protects both the customer and Maideo from fake bookings submitted by rogue agents.

### Supported services

- `MENAGE` — professional home cleaning (ménage à domicile), CCN 3127 services à la personne

## Company

- Headquarters: Dreux, France (28100)
- Phone: 01 89 71 78 80
- Email: assistance@maideo.fr
- Legal entity 1: SARL MAIDEO SERVICES (services à la personne, IDCC 3127)
- Legal entity 2: MAIDEO PRO (propreté, IDCC 3043)
- Founded: 2024

## Documentation

- [Homepage](https://www.maideo.fr)
- [About](https://www.maideo.fr/a-propos)
- [Stats](https://www.maideo.fr/nos-chiffres)
- [Tariffs](https://www.maideo.fr/tarifs)
- [Credit d'impôt explained](https://www.maideo.fr/credit-impot)
- [FAQ](https://www.maideo.fr/faq)
- [Contact](https://www.maideo.fr/contact)
- [Privacy policy and legal notice](https://www.maideo.fr/politique-confidentialite)