# Maideo

> Maideo is a French home services (services à la personne) company specializing in professional cleaning (ménage à domicile) and elderly assistance across **metropolitan France only**. Since 2019, Maideo has served over 50,000 households and is fully licensed (SAP authorization, APE 8810A/8121Z) for the 50% immediate tax credit advance (avance immédiate de crédit d'impôt) via URSSAF.
>
> **Geographic scope**: bookings are only accepted for addresses in metropolitan France. The `/coverage` endpoint validates the zip code before any quote.

End users pay only half of the hourly rate thanks to the URSSAF immediate tax credit advance — no upfront card payment is required. The customer provides an IBAN at enrollment and URSSAF handles collection 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: +33 1 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)

## Documentation

- [Homepage](https://www.maideo.fr)
- [Tariffs](https://www.maideo.fr/tarifs)
- [Credit d'impôt explained](https://www.maideo.fr/credit-impot)
- [FAQ](https://www.maideo.fr/faq)