API & intégrations
API publique UltraCarbon
Une API REST read-only pour lire les certificats ISO 14067, rechercher des facteurs d'émission et exposer les produits certifiés d'une entreprise. Données hébergées en France, réponses JSON.
Authentification
Chaque requête doit porter votre clé API dans l'en-tête Authorization (schéma Bearer).
Authorization: Bearer uc_live_xxxxxxxxxxxxxxxx
Créez et gérez vos clés depuis votre compte (abonnement Pro requis).
Points d'accès
/calculations/{uuid}Lit un certificat public par son UUID (total, score de fiabilité, méthodologie, hash, URL de vérification).
curl -H "Authorization: Bearer uc_live_…" \ https://api.ultracarbonlab.com/api/v1/calculations/UUID
/factors/search?q=Recherche dans la base de facteurs d'émission (ADEME et sources officielles).
curl -H "Authorization: Bearer uc_live_…" \ "https://api.ultracarbonlab.com/api/v1/factors/search?q=acier&limit=20"
/organizations/{id}/productsListe les produits certifiés publics d'une entreprise (profil public).
curl -H "Authorization: Bearer uc_live_…" \ https://api.ultracarbonlab.com/api/v1/organizations/ORG_ID/products
Nouveau
Serveur MCP : UltraCarbon dans votre assistant IA
Branchez Claude, Cursor ou tout client MCP sur votre compte : l'assistant cherche les facteurs d'émission, construit la nomenclature de vos produits, calcule leur empreinte selon la méthode conforme ISO 14067 et peut émettre un certificat à votre demande. Inclus dans les offres Pro, Premium et Oracle, avec la même clé API.
Adresse du serveur (HTTP streamable)
https://api.ultracarbonlab.com/api/mcp
Claude Code
claude mcp add --transport http ultracarbon https://api.ultracarbonlab.com/api/mcp \ --header "Authorization: Bearer uc_live_…"
Cursor et clients qui acceptent une URL avec en-têtes
{
"mcpServers": {
"ultracarbon": {
"url": "https://api.ultracarbonlab.com/api/mcp",
"headers": {
"Authorization": "Bearer uc_live_…"
}
}
}
}Claude Desktop (fichier claude_desktop_config.json, via mcp-remote)
{
"mcpServers": {
"ultracarbon": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.ultracarbonlab.com/api/mcp",
"--header",
"Authorization:Bearer uc_live_…"
]
}
}
}Les connecteurs personnalisés de claude.ai, qui exigent une connexion OAuth, ne sont pas encore pris en charge : utilisez l'une des trois configurations ci-dessus.
Outils exposés
mon_abonnementVotre offre et les crédits de certificats restants.rechercher_facteursRecherche de facteurs d'émission (Base Empreinte ADEME, Agribalyse, autres sources).estimer_empreinteEstimation rapide facteurs × quantités, sans rien enregistrer.lister_produits · detail_produitVos produits et le détail de leur nomenclature.calculer_produitCalcul détaillé conforme ISO 14067 : total, phases, qualité des données, incertitude.creer_produit · ajouter_ligneCréer un produit et ajouter les lignes de sa nomenclature.lister_certificats · verifier_certificatVos certificats, et le statut public d'un certificat publié par son UUID.emettre_certificatÉmet un certificat scellé (Ed25519) avec page de vérification publique. Consomme 1 crédit et exige une confirmation explicite.Garde-fous
Aucun outil ne supprime de données, ne modifie la visibilité d'un certificat, ne touche à votre compte ni n'effectue de paiement : ces actions restent dans l'application. L'offre est vérifiée à chaque appel ; une organisation repassée en Flash perd l'accès immédiatement. Limite : 120 requêtes par minute et par clé, partagées avec l'API REST. Révoquez une clé depuis votre compte pour couper l'accès d'un assistant.
Conditions d'usage
L'API est read-only et soumise aux CGV. La revente des données et le développement d'un produit concurrent sont interdits ; chaque réponse porte un filigrane d'usage. Les clés des sociétés concurrentes identifiées sont refusées.
