# Fixou

Fixou met en relation des particuliers ayant un besoin de travaux ou de services (plomberie, électricité, rénovation, jardinage...) avec des artisans locaux. Un client décrit son besoin en quelques minutes ; sa demande est transmise gratuitement aux artisans du métier et du secteur concernés, qui répondent avec un prix indicatif et un délai.

## Pour un agent (ChatGPT, Claude, ou tout logiciel autonome)

Un agent muni d'une clé API Fixou peut créer une demande de devis au nom d'un client final, puis suivre son statut.

- Référentiel des métiers et de leurs questionnaires (public, sans clé) : `GET https://fixou.fr/api/v1/categories`
- Créer une demande (clé API requise) : `POST https://fixou.fr/api/v1/requests`
- Consulter le statut d'une demande et ses réponses (clé API requise) : `GET https://fixou.fr/api/v1/requests/{id}`
- Spécification complète (OpenAPI 3.1) : https://fixou.fr/api/v1/openapi.json
- Page d'introduction pour développeurs : https://fixou.fr/developpeurs
- Référence complète (API REST + MCP, exemples curl, codes d'erreur) : https://fixou.fr/developpeurs/docs

Confirmation par email (double opt-in) : une demande créée via l'API ou le MCP n'est PAS publiée immédiatement. Elle naît avec le statut `pending_confirmation` et le client final reçoit un email « Confirmez votre demande » contenant un lien valable 48 heures. Tant qu'il n'a pas cliqué, aucun artisan n'est contacté. C'est le clic qui publie la demande, la transmet aux artisans, connecte le client et l'amène sur le suivi. Sans confirmation sous 48 heures, la demande expire. Un agent doit donc, après création, inviter explicitement l'utilisateur à ouvrir sa boîte mail et à cliquer sur le lien de confirmation. C'est le client, pas l'agent, qui échange ensuite avec les artisans sur fixou.fr. L'API ne renvoie jamais de coordonnées (email, téléphone) tant que le client n'a pas choisi un artisan.

## MCP

Un serveur MCP (Model Context Protocol) est en ligne à l'adresse https://mcp.fixou.fr, pour une intégration directe dans les clients compatibles (Claude, ChatGPT...) sans appel HTTP manuel. Transport Streamable HTTP (sans état) : `POST https://mcp.fixou.fr/mcp`. Trois outils sont exposés : `list_categories` (métiers et questionnaires), `create_request` (créer une demande au nom d'un client final, à confirmer par email) et `get_request` (suivre le statut et les réponses). La clé API vit côté serveur : le client MCP n'a rien à fournir.

## Obtenir une clé API

Les clés API sont distribuées manuellement par l'équipe Fixou. Contact : contact@fixou.fr