API et serveur MCP

Les données de Compoatlas s'interrogent directement, en lecture seule et sans compte : par une API JSON ou par un serveur MCP que les assistants IA (Claude, ChatGPT et d'autres) peuvent utiliser comme connecteur. Les réponses sont celles des pages, avec les sources officielles datées.

API JSON

GET /api/v1/ingredients/{adresse} : statut d'un ingrédient (Union européenne, cas d'interdiction, danger classé, autres pays, identifiants, sources). Exemple : /api/v1/ingredients/phenoxyethanol
GET /api/v1/products/{code-barres} : composition relevée et datée d'un cosmétique, certitude de chaque rattachement
GET /api/v1/alerts?barcode=… (ou substance=, brand=) : alertes européennes Safety Gate sur des cosmétiques. Exemple : /api/v1/alerts?substance=hydroquinone
POST /api/v1/report avec {"products": [{"gtin": …, "ingredients": …}]} : rapport de conformité de 200 produits au plus (ingrédient interdit, alerte Safety Gate, liste absente), rien n'est conservé
GET /api/v1/search?q=… : recherche
POST /api/v1/analyze avec {"text": "Aqua, Glycerin, …"} : analyse d'une liste imprimée
Description OpenAPI : /api/v1/openapi.json

Serveur MCP

Adresse : https://compoatlas.com/mcp (transport Streamable HTTP, sans authentification). Compatible avec la version 2026-07-28 du protocole et avec les versions 2025 qui utilisent encore la poignée de main initialize. Cinq outils, tous en lecture seule : search, get_ingredient, get_product, search_alerts, analyze_ingredient_list.

Correspondances et jeux de données

Les tables et les correspondances (format SSSOM, avec la méthode et la certitude de chaque lien) sont sur la page Données ouvertes. Le serveur ne garde pas les questions posées, sauf l'adresse d'une requête en erreur, conservée 7 jours pour corriger le site (voir les mentions légales).