l0g.fr Risk Intelligence

Serveur MCP de l0g.fr

Serveur Model Context Protocol en lecture seule, qui expose les données de l0g.fr (Agent Surface, OpenAPI, Risk Diff, Black Box Recorder, NDJSON, evidence graph, claims, sources, fraîcheur, intégrité, changefeed, historique des signaux, analyses, guides) à des agents IA via resources, prompts, resource templates et tools, avec le transport Streamable HTTP (spec 2025-11-25, le transport SSE est déprécié).

Endpoints publics visés :

• https://l0g.fr/api/mcp/compact : façade recommandée à six tools ;
• https://l0g.fr/api/mcp : surface complète conservée pour compatibilité et usages experts.

get_risk_state est le produit principal de la façade compacte. Son contrat regroupe l’état courant, le diff 1/7/30 jours, l’historique par instrument et le replay point-in-time avec date de référence, source, méthode et limites.

Le contrat anti-dérive est publié sur https://l0g.fr/api/v1/toolset-manifest.json.

État de déploiement

La version active, son SHA source et son statut d'attestation ne sont pas figés dans cette documentation. Ils sont publiés par la ressource l0g://mcp/server et vérifiables avec scripts/verify-public-mcp-release.mjs. Le daemon de production est servi depuis le runtime atomique /opt/l0g-mcp-runtime/releases/.

Réutilisation et licences

Tout client compatible MCP peut utiliser le service distant public sans compte ni clé API. Une nouvelle intégration doit commencer par https://l0g.fr/api/mcp/compact; https://l0g.fr/api/mcp conserve la surface complète pour la compatibilité et les usages experts. Les deux sont en lecture seule et consacrés aux données de l0g.fr.

Le code du serveur, ses tests et ses scripts de déploiement sont réutilisables sous licence MIT. Les textes, données et artefacts éditoriaux renvoyés par le service sont sous licence CC BY 4.0 avec attribution, dans la limite des droits détenus par leur auteur. Les éléments tiers conservent leurs propres droits. Consulter LICENSE et NOTICE.md dans l'archive de release.

L'archive Linux/Node publiée est le runtime de production de l0g.fr : elle est auditable et redistribuable selon ces licences, mais elle n'est pas présentée comme un paquet npm générique prêt à héberger un autre corpus ou domaine.

Architecture

agent / client MCP

| HTTPS (Streamable HTTP, POST JSON-RPC) v Apache (443, l0g.fr) ──reverse proxy──> 127.0.0.1:8848 (service Node, systemd) | | lit (lecture seule) v /var/www/html/l0g/current/agents.json /var/www/html/l0g/current/openapi.json /var/www/html/l0g/current/api/v1/*.json|*.ndjson /var/www/html/l0g/current/risk-events.json /var/www/html/l0g/current/confluence.json /var/www/html/l0g/current/posts|guides/ /index.html /var/www/html/l0g/current/en/analysis|guides/ /index.html

• Le service Node n'écoute qu'en 127.0.0.1, jamais exposé directement.
• Les données proviennent du site déjà déployé : agents.json, catalog.json, search-index.json, claims.json, evidence-graph.json, sources.json, freshness.json, integrity.json, changes.json, risk-diff.json, black-box.json, leurs variantes NDJSON, openapi.json, risk.json, debt-risk.json, risk-events.json et confluence.json. Le service ne fait que lire ces fichiers. Le cache est lié au répertoire réel de la release atomique : il est conservé tant que le symlink current pointe sur la même release, puis rechargé après la bascule.
• Mode stateless + réponse JSON : pas de session à stocker, un serveur et un transport neufs par requête.
• Un agrégat MCP séparé compte par jour et endpoint les initialisations, tools/list, appels, succès/erreurs, latences p50/p95, tailles de réponse, tools, resources, prompts et familles stables issues de clientInfo. Les user-agents internes l0g sont exclus avant agrégation. Aucune IP, session, empreinte, chaîne user-agent, requête ou réponse n’est conservée. Les libellés normalisés classés other restent sept jours dans le fichier privé afin de corriger la taxonomie ; seuls ceux atteignant k=5 sont visibles dans le diagnostic local /_l0g/mcp-client-taxonomy. Rapport public : /api/mcp/usage.

Diagnostic de fiabilité

Le rapport /api/mcp/usage conserve les compteurs de succès et d’erreurs. Un succès technique indique seulement une réponse MCP sans erreur déclarée ; il ne valide ni l’analyse économique, ni la source, ni la fraîcheur du résultat.

Chaque ligne tools expose désormais error_reasons, des catégories fixes agrégées sur la même fenêtre que le compteur d’erreurs. Chaque catégorie publiée atteint k=5. errors_without_detailed_reason inclut les anciennes erreurs sans cause enregistrée et les catégories sous ce seuil. Le fichier de schéma 2 reste lisible sans le nouveau champ interne errorReasons. Aucun nom d’outil inconnu, argument, slug, texte de réponse ou identifiant réseau n’est enregistré.

Les causes des 30 erreurs get_document et 32 erreurs build_research_pack mentionnées dans le rapport du 8 octobre 2026 ne peuvent pas être reconstruites à partir de ces seuls agrégats. Les correctifs locaux de pagination et de validation ont des tests de régression ; ils ne démontrent pas la cause de ces événements historiques. Pour comparer une nouvelle release, relever sa version et son SHA avec les dates des captures avant/après, puis calculer les erreurs sur les seuls résultats connus. Ne pas mélanger deux fenêtres glissantes comme s’il s’agissait d’un flux exact entre deux dates.

La catégorie client other reste inconnue tant que le diagnostic local ne fournit pas d’éléments suffisants. Ne pas l’attribuer à un fournisseur par supposition. Les familles déclarées et les jours actifs ne comptent ni personnes ni installations uniques.

Resources exposées

Les documents et datasets stables sont exposés comme resources MCP. Les tools restent réservés aux opérations de recherche, filtrage et synthèse.

Resources statiques

Resource templates

resources/list est volontairement borné aux dix resources statiques afin de ne pas injecter le catalogue entier dans le contexte des clients. Les articles, guides, claims, sources, signaux et méthodologies restent lisibles par URI via les templates ; resources/templates/list les découvre et les variables principales conservent leurs callbacks de complétion. Les tools de recherche et de filtrage fournissent la découverte ciblée. Le service est stateless en requête/réponse et n’annonce pas resources.subscribe ni resources.listChanged : pour surveiller le corpus, lire l0g://changes/latest ou appeler get_changefeed.

Prompts exposés

Les prompts MCP sont des workflows sélectionnés explicitement par l'utilisateur. Le serveur annonce la capability prompts, sans listChanged, et valide chaque argument avant de rendre le message. Leur définition unique vit dans src/lib/agent-prompts.mjs, également utilisée par la page /agents/.

Tools exposés

Tous les tools renvoient désormais :

• un résumé humain court dans content;
• les données exploitables dans structuredContent;
• un outputSchema déclaré et validé par le SDK.
• un title et les hints readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false ;
• des resource_link natifs lorsque la réponse référence des documents, claims ou sources.

Le JSON n'est donc plus caché dans un bloc texte à reparser.

Façade compacte

Surface complète

| get_risk_indices | aucun | indice