Fixou

Développeurs et agents IA

Construisez sur Fixou.

L'API REST et le serveur MCP qui permettent à un agent IA de créer une demande de devis pour un client final, puis d'en suivre les réponses d'artisans français.

Consulter la référenceObtenir une clé API

Le parcours d'un agent

Du besoin exprimé en langage naturel jusqu'aux réponses d'artisans, le chemin passe toujours par une confirmation du client final.

1

Le client décrit son besoin

Il explique son problème à son assistant IA, en langage naturel : « j'ai une fuite sous mon évier à Marseille ».

2

L'agent crée la demande

L'agent identifie le métier, complète le questionnaire et appelle l'API avec l'email du client final.

3

Le client confirme par email

Il reçoit « Confirmez votre demande » et clique sur le lien, valable 48 h. Ce clic, et lui seul, publie la demande.

4

Les artisans répondent

La demande part aux artisans du secteur. Le client suit les réponses et échange avec eux sur son espace fixou.fr.

Deux voies d'intégration

Les mêmes capacités, exposées de deux manières : une API REST classique, ou un serveur MCP à brancher directement dans un assistant.

API REST

Trois endpoints décrits par une spécification OpenAPI 3.1. On s'authentifie avec une clé Bearer préfixée fixou_sk_, transmise dans l'en-tête Authorization.

openapi.jsonRéférence REST

Serveur MCP

Un serveur Model Context Protocol sur https://mcp.fixou.fr/mcp, sans clé côté client, publié au registre officiel sous fr.fixou/fixou. À brancher dans Claude ou ChatGPT comme connecteur personnalisé.

Intégrer le serveur MCP

Créer une demande en un appel

Un POST /api/v1/requests enregistre la demande au statut pending_confirmation. Aucun artisan n'est contacté tant que le client final n'a pas confirmé par email.

curl -X POST https://fixou.fr/api/v1/requests \
  -H "Authorization: Bearer fixou_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "categorySlug": "plombier",
    "answers": { "type": "fuite", "lieu": "cuisine", "urgence": "urgent" },
    "description": "Fuite sous le lavabo de la cuisine, intervention rapide souhaitee.",
    "postalCode": "13001",
    "email": "[email protected]"
  }'

Exemple complet et directement exécutable, aligné sur la référence REST.

Prêt à démarrer ?

Aucun artisan n'est jamais contacté sans la confirmation par email du client final : le double opt-in protège vos utilisateurs et la qualité du réseau.

Référence complètellms.txtNous contacter pour une clé API