# 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 39,000+ home cleaning interventions across France and works with 11,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.

## 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 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)