l0g.fr Risk Intelligence

Official26 toolsLive

by bluetouff · Astro

Read-only macro risk analysis, evidence, signals, and source-backed research from l0g.fr.

🛠️ Key Features

Read-only server delivering macro risk analysis
Evidence-backed research sourced from l0g.fr
Focus on commodities, cryptocurrency, economy, finance, and geopolitics

🚀 Use Cases

Researchers and analysts evaluating macro risk signals
Researchers compiling source-backed research for reports
Developers integrating risk data into dashboards or tools

⚡ Developer Benefits

Lightweight, read-only access ideal for data ingestion
Clear topic coverage aligned with finance and geopolitics
Structured data presentation for easy parsing and indexing

⚠️ Limitations

Descriptive content limited to read-only macro analyses
No interactive or real-time data streaming indicated
Source material scope limited to l0g.fr-backed research

Topics

commoditiescryptocurrencyeconomyfinancegeopolitics

Captured live from the server via tools/list.

get_agent_manifest

Renvoie le manifeste Agent Surface de l0g.fr : capacités, endpoints, règles d'usage, politiques de preuve et compteurs. Point d'entrée recommandé pour découvrir les surfaces machine sans scraper.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_risk_indices

Indices de risque publiés par l0g.fr (tableaux de bord macro US et zone euro, Yen Carry, Energie, Dette US) à la cadence des snapshots, plus un résumé de la confluence 13F. Pas de temps réel strict, pas un conseil en investissement.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_signal_history

Renvoie l'historique des changements de niveau des signaux l0g, l'état courant des scores et la confluence 13FLOW. À utiliser pour distinguer niveau courant, franchissement de seuil et signal de marché historisé.

Parameters2

key	string	optional	Signal optionnel : us, eu, yen, energie ou debt.
limit	integer	optional	Nombre maximum d'événements historiques.

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "enum": [
        "us",
        "eu",
        "yen",
        "energie",
        "debt"
      ],
      "description": "Signal optionnel : us, eu, yen, energie ou debt."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Nombre maximum d'événements historiques."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_risk_diff

Renvoie le Risk Diff l0g : ce qui a changé dans le risque depuis 1, 7 ou 30 jours. Inclut signaux, sources fraîches ou stale, claims, modèles, articles reliés et niveau de confiance.

Parameters1

window

string

optional

Fenêtre optionnelle : 1d, 7d ou 30d.

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "1d",
        "7d",
        "30d"
      ],
      "description": "Fenêtre optionnelle : 1d, 7d ou 30d."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_black_box

Renvoie le Black Box Recorder l0g : frames point-in-time hashées des signaux de risque. Avec une date, sélectionne la dernière frame publiée avant ou le jour demandé, sans reconstruction rétroactive.

Parameters2

date	string	optional	Date à rejouer au format YYYY-MM-DD. Si absente, renvoie la dernière frame.
limitFrames	integer	optional	Nombre de frames récentes à inclure quand date est absente.

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date à rejouer au format YYYY-MM-DD. Si absente, renvoie la dernière frame."
    },
    "limitFrames": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 5,
      "description": "Nombre de frames récentes à inclure quand date est absente."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_openapi_schema

Expose le contrat OpenAPI public de l'Agent Surface l0g. Permet à un agent de découvrir les chemins, méthodes et schémas sans récupérer tout le fichier si un résumé suffit.

Parameters2

mode	string	optional	summary pour index, path pour un endpoint, full pour le contrat complet.
path	string	optional	Chemin OpenAPI exact, par exemple /api/v1/claims.json, utilisé avec mode=path.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "path",
        "full"
      ],
      "default": "summary",
      "description": "summary pour index, path pour un endpoint, full pour le contrat complet."
    },
    "path": {
      "type": "string",
      "description": "Chemin OpenAPI exact, par exemple /api/v1/claims.json, utilisé avec mode=path."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ndjson_feed

Lit les variantes NDJSON publiques de l'Agent Surface : catalog, claims, evidenceGraph, changes ou signalHistory. Le feed est allowlisté ; aucun chemin arbitraire n'est accepté.

Parameters3

feed	string	required	Flux NDJSON à lire.
recordType	string	optional	Filtre recordType optionnel, par exemple claim, article, node, edge ou change.
limit	integer	optional	Nombre maximum de lignes renvoyées.

Raw schema

{
  "type": "object",
  "properties": {
    "feed": {
      "type": "string",
      "enum": [
        "catalog",
        "claims",
        "evidenceGraph",
        "changes",
        "signalHistory"
      ],
      "description": "Flux NDJSON à lire."
    },
    "recordType": {
      "type": "string",
      "description": "Filtre recordType optionnel, par exemple claim, article, node, edge ou change."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Nombre maximum de lignes renvoyées."
    }
  },
  "required": [
    "feed"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_freshness

Renvoie la fraîcheur du corpus l0g : derniers contenus, compteurs, endpoints disponibles et politique de fraîcheur. À appeler avant de présenter un snapshot comme actuel.

Parameters1

limit

integer

optional

Nombre de derniers contenus à renvoyer.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Nombre de derniers contenus à renvoyer."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_content

Recherche plein texte locale dans l0g.fr : analyses, guides, glossaire, fiches méthodologiques et sources primaires. Par défaut, le serveur utilise l'index bilingue canonique partagé avec l'Agent Surface et WebMCP, sans fournisseur externe. Le mode catalog conserve l'ancien scoring léger sur titre, tags, topics et description.

Parameters4

query	string	required	Termes de recherche.
language	string	optional	Langue optionnelle : fr ou en. Sans filtre, recherche bilingue.
mode	string	optional	fulltext pour le corps des pages, catalog pour le scoring catalogue historique.
limit	integer	optional	Nombre maximum de résultats.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Termes de recherche."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue optionnelle : fr ou en. Sans filtre, recherche bilingue."
    },
    "mode": {
      "type": "string",
      "enum": [
        "fulltext",
        "catalog"
      ],
      "default": "fulltext",
      "description": "fulltext pour le corps des pages, catalog pour le scoring catalogue historique."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Nombre maximum de résultats."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

build_research_pack

Compose en un appel un paquet de recherche déterministe : documents classés, claims canoniques, sources primaires, liens claim -> preuve, fraîcheur, Risk Diff, éléments adverses, limites et URLs citables. Ne produit aucune opinion d’investissement.

Parameters5

query	string	required	Question ou thème de recherche.
language	string	required	Langue des documents recherchés : fr ou en.
asOf	string	optional	Date point-in-time optionnelle au format YYYY-MM-DD.
riskWindow	string	optional	Fenêtre Risk Diff.
limit	integer	optional	Nombre maximum de documents.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Question ou thème de recherche."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue des documents recherchés : fr ou en."
    },
    "asOf": {
      "type": "string",
      "description": "Date point-in-time optionnelle au format YYYY-MM-DD."
    },
    "riskWindow": {
      "type": "string",
      "enum": [
        "1d",
        "7d",
        "30d"
      ],
      "default": "7d",
      "description": "Fenêtre Risk Diff."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Nombre maximum de documents."
    }
  },
  "required": [
    "query",
    "language"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_claims

Interroge les relations affirmation-source extraites des articles l0g. Filtrage par article, type de claim (fait, estimation, inférence, scénario, assertion non classée) et texte. Renvoie les références cliquables, datées quand détectable.

Parameters5

articleSlug	string	optional	Slug d'article optionnel.
language	string	optional	Langue du slug fourni. Une claim reste canonique en français.
kind	string	optional	Type de claim optionnel.
query	string	optional	Filtre texte optionnel dans la claim ou le titre article.
limit	integer	optional	Nombre maximum de claims.

Raw schema

{
  "type": "object",
  "properties": {
    "articleSlug": {
      "type": "string",
      "description": "Slug d'article optionnel."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue du slug fourni. Une claim reste canonique en français."
    },
    "kind": {
      "type": "string",
      "enum": [
        "fait",
        "estimation",
        "inférence",
        "scénario",
        "unclassified-assertion"
      ],
      "description": "Type de claim optionnel."
    },
    "query": {
      "type": "string",
      "description": "Filtre texte optionnel dans la claim ou le titre article."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Nombre maximum de claims."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_claim

Renvoie une claim précise par identifiant, avec ses références cliquables, datées quand détectable. Utiliser list_article_claims ou get_claims pour découvrir les identifiants.

Parameters1

claimId

string

required

Identifiant de claim, par exemple dollar-yen-intervention-risque-carry-2026:claim-a1b2c3d4e5f6a7.

Raw schema

{
  "type": "object",
  "properties": {
    "claimId": {
      "type": "string",
      "minLength": 1,
      "description": "Identifiant de claim, par exemple dollar-yen-intervention-risque-carry-2026:claim-a1b2c3d4e5f6a7."
    }
  },
  "required": [
    "claimId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_claim_evidence

Renvoie la preuve d'une claim : affirmation, type, références, profondeur de preuve et voisinage du graphe article -> claim -> référence -> source. Les contenus reliés par hôte/source commune sont séparés de la preuve directe.

Parameters2

claimId	string	required	Identifiant de claim.
limit	integer	optional	Nombre maximum de nœuds dans le voisinage de preuve.

Raw schema

{
  "type": "object",
  "properties": {
    "claimId": {
      "type": "string",
      "minLength": 1,
      "description": "Identifiant de claim."
    },
    "limit": {
      "type": "integer",
      "minimum": 10,
      "maximum": 160,
      "default": 80,
      "description": "Nombre maximum de nœuds dans le voisinage de preuve."
    }
  },
  "required": [
    "claimId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_article_claims

Liste les claims d'un article donné, avec filtrage optionnel par type. C'est le chemin recommandé pour passer d'un article à ses affirmations vérifiables.

Parameters4

articleSlug	string	required	Slug d'article.
language	string	optional	Langue du slug fourni. Les claims renvoyées restent canoniques en français.
kind	string	optional	Type de claim optionnel.
limit	integer	optional	Nombre maximum de claims.

Raw schema

{
  "type": "object",
  "properties": {
    "articleSlug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug d'article."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue du slug fourni. Les claims renvoyées restent canoniques en français."
    },
    "kind": {
      "type": "string",
      "enum": [
        "fait",
        "estimation",
        "inférence",
        "scénario",
        "unclassified-assertion"
      ],
      "description": "Type de claim optionnel."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50,
      "description": "Nombre maximum de claims."
    }
  },
  "required": [
    "articleSlug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_claims_by_source

Trouve les claims liées à une source primaire ou à un hôte cité. Accepte un slug de source l0g (ex: federal-reserve-fred), un nom ou un host (ex: fred.stlouisfed.org).

Parameters3

sourceId	string	required	Slug de source, nom ou host.
kind	string	optional	Type de claim optionnel.
limit	integer	optional	Nombre maximum de claims.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceId": {
      "type": "string",
      "minLength": 1,
      "description": "Slug de source, nom ou host."
    },
    "kind": {
      "type": "string",
      "enum": [
        "fait",
        "estimation",
        "inférence",
        "scénario",
        "unclassified-assertion"
      ],
      "description": "Type de claim optionnel."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Nombre maximum de claims."
    }
  },
  "required": [
    "sourceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_source

Renvoie une source primaire l0g ou un hôte cité, puis les claims qui s'y rattachent. Complète list_sources quand un agent veut auditer une institution ou un domaine précis.

Parameters2

sourceId	string	required	Slug de source, nom ou host.
limit	integer	optional	Nombre maximum de claims liées.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceId": {
      "type": "string",
      "minLength": 1,
      "description": "Slug de source, nom ou host."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Nombre maximum de claims liées."
    }
  },
  "required": [
    "sourceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_artifact

Vérifie un artefact Agent Surface à partir du manifeste d'intégrité publié. Le chemin doit correspondre à un snapshot connu ; aucune lecture de chemin arbitraire n'est faite.

Parameters2

path	string	required	Chemin public, par exemple /api/v1/evidence-graph.json.
sha256	string	optional	Empreinte SHA-256 optionnelle à comparer au snapshot canonique.

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "Chemin public, par exemple /api/v1/evidence-graph.json."
    },
    "sha256": {
      "type": "string",
      "description": "Empreinte SHA-256 optionnelle à comparer au snapshot canonique."
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_changes

Interroge le changefeed machine avec filtres de type, slug et date minimale. Inclut objectId, version/hash courant, statut de diff et type de changement sémantique.

Parameters4

contentType	string	optional	Type de contenu optionnel.
slug	string	optional	Slug optionnel pour cibler un contenu.
since	string	optional	Date ISO optionnelle, incluse, par exemple 2026-06-27.
limit	integer	optional	Nombre maximum d'entrées.

Raw schema

{
  "type": "object",
  "properties": {
    "contentType": {
      "type": "string",
      "enum": [
        "article",
        "guide",
        "policy"
      ],
      "description": "Type de contenu optionnel."
    },
    "slug": {
      "type": "string",
      "description": "Slug optionnel pour cibler un contenu."
    },
    "since": {
      "type": "string",
      "description": "Date ISO optionnelle, incluse, par exemple 2026-06-27."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Nombre maximum d'entrées."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_evidence_graph

Renvoie un sous-graphe de preuve l0g : articles, claims, références, hôtes, sources primaires et datasets. Avec articleSlug, la preuve directe est séparée des contenus reliés par hôte/source/dataset commun.

Parameters4

articleSlug	string	optional	Slug d'article optionnel pour extraire son voisinage de graphe.
language	string	optional	Langue du slug fourni. Le graphe de preuve reste canonique en français.
nodeType	string	optional	Type de nœud optionnel.
limit	integer	optional	Nombre maximum de nœuds renvoyés.

Raw schema

{
  "type": "object",
  "properties": {
    "articleSlug": {
      "type": "string",
      "description": "Slug d'article optionnel pour extraire son voisinage de graphe."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue du slug fourni. Le graphe de preuve reste canonique en français."
    },
    "nodeType": {
      "type": "string",
      "enum": [
        "article",
        "claim",
        "reference",
        "host",
        "primarySource",
        "dataset"
      ],
      "description": "Type de nœud optionnel."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 80,
      "description": "Nombre maximum de nœuds renvoyés."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_sources

Liste les sources primaires institutionnelles suivies par l0g et les hôtes effectivement cités par les claims. Utile pour auditer l'origine des preuves.

Parameters2

mode	string	optional	Type de sources à renvoyer.
limit	integer	optional	Nombre maximum de sources ou hôtes.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "primary",
        "hosts",
        "both"
      ],
      "default": "both",
      "description": "Type de sources à renvoyer."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Nombre maximum de sources ou hôtes."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_integrity

Renvoie les empreintes SHA-256 canoniques des surfaces Agent Surface, JSON et NDJSON. Utile pour vérifier qu'un agent a ingéré un snapshot précis.

Parameters1

path

string

optional

Chemin optionnel, par exemple /api/v1/claims.ndjson.

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Chemin optionnel, par exemple /api/v1/claims.ndjson."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_changefeed

Renvoie les dernières publications, révisions et politiques avec objectId, version/hash courant, statut de diff et changement sémantique. À utiliser pour surveiller le corpus sans tout rescanner.

Parameters2

contentType	string	optional	Type de contenu optionnel.
limit	integer	optional	Nombre maximum d'entrées.

Raw schema

{
  "type": "object",
  "properties": {
    "contentType": {
      "type": "string",
      "enum": [
        "article",
        "guide",
        "policy"
      ],
      "description": "Type de contenu optionnel."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Nombre maximum d'entrées."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_recent_analyses

Liste les analyses (articles) les plus récentes de l0g.fr, de la plus récente à la plus ancienne, avec titre, URL, date, description et thèmes.

Parameters2

language	string	optional	Langue optionnelle : fr ou en. Sans filtre, liste bilingue.
limit	integer	optional	Nombre d'analyses à renvoyer.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue optionnelle : fr ou en. Sans filtre, liste bilingue."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "Nombre d'analyses à renvoyer."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_guides

Liste les guides de référence de l0g.fr (pages piliers durables : 13F, Form 4, GENIUS Act, OFAC, MiCA...), avec titre, URL, description et résumé définitionnel.

Parameters1

language

string

optional

Langue optionnelle : fr ou en. Sans filtre, liste bilingue.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue optionnelle : fr ou en. Sans filtre, liste bilingue."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_by_topic

Liste les analyses rattachées à un sujet (hub thématique) de l0g.fr. Sujets disponibles (slug : libellé) : credit-prive : Crédit privé & marchés privés ; macro-banques-centrales : Macro & banques centrales ; geopolitique-energie : Géopolitique & énergie ; crypto : Crypto & stablecoins ; marches-valorisations : Marchés & valorisations ; politique-us : Politique US. Accepte le slug ou un libellé approchant.

Parameters3

topic	string	required	Slug ou libellé du sujet.
language	string	optional	Langue optionnelle : fr ou en. Sans filtre, recherche bilingue.
limit	integer	optional	Nombre maximum d'analyses.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Slug ou libellé du sujet."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue optionnelle : fr ou en. Sans filtre, recherche bilingue."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Nombre maximum d'analyses."
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_article

Renvoie le texte d'une analyse ou d'un guide l0g à partir de son slug. Le résultat est paginable par offset/length et expose nextOffset pour récupérer la suite. Utiliser section=tail ou section=sources pour atteindre rapidement conclusion, limites, méthodologie et sources. Pour lire le document complet comme objet, utiliser aussi la ressource l0g://articles/{slug} ou l0g://guides/{slug}.

Parameters7

slug	string	required	Slug de l'article ou du guide.
language	string	optional	Langue optionnelle : fr ou en. Une URL /en/... permet aussi de l’inférer.
offset	integer	optional	Position de départ en caractères pour paginer le texte.
cursor	string	optional	Curseur opaque nextCursor renvoyé par un appel précédent.
limit	integer	optional	Alias de length, recommandé pour les clients agents.
length	integer	optional	Longueur maximale du segment renvoyé.
section	string	optional	Section pratique : body avec offset, head, tail ou sources.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug de l'article ou du guide."
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Langue optionnelle : fr ou en. Une URL /en/... permet aussi de l’inférer."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Position de départ en caractères pour paginer le texte."
    },
    "cursor": {
      "type": "string",
      "description": "Curseur opaque nextCursor renvoyé par un appel précédent."
    },
    "limit": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 50000,
      "description": "Alias de length, recommandé pour les clients agents."
    },
    "length": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 50000,
      "default": 16000,
      "description": "Longueur maximale du segment renvoyé."
    },
    "section": {
      "type": "string",
      "enum": [
        "body",
        "head",
        "tail",
        "sources"
      ],
      "default": "body",
      "description": "Section pratique : body avec offset, head, tail ou sources."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mcp-server/README.md16 KBView on GitHub

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é).

Endpoint public visé : https://l0g.fr/api/mcp

État de déploiement

Au 16 juillet 2026, le code du dépôt déclare 1.20.0, mais l'endpoint public annonce encore serverInfo.version = 1.19.0 et aucun tag mcp-v1.20.0 n'est publié. Le mécanisme de release atomique ci-dessous est donc prêt dans le dépôt, mais sa migration en production ne doit pas être présentée comme acquise.

Architecture

code

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/<slug>/index.html
                          /var/www/html/l0g/current/en/analysis|guides/<slug>/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, avec un cache TTL de 60 s.
Mode stateless + réponse JSON : pas de session à stocker, un serveur et un transport neufs par requête.

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

URI	Contenu
`l0g://agent-manifest`	manifeste Agent Surface
`l0g://openapi`	contrat OpenAPI complet
`l0g://freshness`	fraîcheur du corpus
`l0g://integrity`	empreintes SHA-256 canoniques
`l0g://changes/latest`	dernières publications et révisions
`l0g://risk-diff`	diff du risque sur 1, 7 et 30 jours
`l0g://black-box`	frames point-in-time hashées du risque
`l0g://signals/current`	état courant des signaux
`l0g://signals/history`	observations point-in-time et alertes de seuil

Resource templates

Template	Contenu
`l0g://articles/{slug}`	première page d'un article avec métadonnées, références et texte
`l0g://articles/{slug}{?section,offset,limit}`	page ciblée d'un article (`body`, `head`, `tail`, `sources`)
`l0g://articles/{slug}{?cursor}`	continuation d'article via `nextCursor`
`l0g://en/articles/{slug}`	première page d'une analyse anglaise, reliée aux preuves françaises canoniques
`l0g://en/articles/{slug}{?section,offset,limit}`	page ciblée d'une analyse anglaise
`l0g://en/articles/{slug}{?cursor}`	continuation d'analyse anglaise via `nextCursor`
`l0g://guides/{slug}`	première page d'un guide avec métadonnées et texte
`l0g://guides/{slug}{?section,offset,limit}`	page ciblée d'un guide (`body`, `head`, `tail`, `sources`)
`l0g://guides/{slug}{?cursor}`	continuation de guide via `nextCursor`
`l0g://en/guides/{slug}`	première page d'un guide anglais
`l0g://en/guides/{slug}{?section,offset,limit}`	page ciblée d'un guide anglais
`l0g://en/guides/{slug}{?cursor}`	continuation de guide anglais via `nextCursor`
`l0g://claims/{claim_id}`	relation affirmation-source
`l0g://sources/{source_id}`	source primaire ou hôte cité
`l0g://signals/{instrument}/current`	signal courant + historique de franchissement
`l0g://methodologies/{instrument}`	fiche méthodologique

resources/list énumère aussi les instances connues via les templates. Les variables principales ont des callbacks de complétion. Le service public actuel 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/.

Prompt	Arguments	Workflow
`audit_financial_narrative`	`topic`, `language?`	auditer un récit financier et séparer claims, preuves, inférences, scénarios et limites
`explain_risk_change`	`window?`, `language?`	expliquer un Risk Diff publié sur 1, 7 ou 30 jours sans extrapolation
`verify_claim`	`claim`, `language?`	vérifier une affirmation contre les claims canoniques, leurs preuves et leurs sources
`replay_as_of`	`date`, `question?`, `language?`	rejouer uniquement une frame Black Box réellement archivée à la date demandée

Tools exposés (tous `readOnlyHint`)

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.

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

Tool	Arguments	Renvoie
`get_agent_manifest`	aucun	capacités, endpoints, règles d'usage et politiques de preuve
`get_risk_indices`	aucun	indices de risque (US, EU, Yen, Energie, Dette US) + résumé confluence
`get_signal_history`	`key?`, `limit?`	historique des franchissements de niveau + état courant + confluence
`get_risk_diff`	`window?`	Risk Diff sur 1, 7 ou 30 jours : signaux, sources, claims, modèles, articles et confiance
`get_black_box`	`date?`, `limitFrames?`	replay point-in-time des frames de risque hashées, avec refus des dates non rejouables
`get_openapi_schema`	`mode?`, `path?`	contrat OpenAPI résumé, ciblé par endpoint ou complet
`get_ndjson_feed`	`feed`, `recordType?`, `limit?`	flux NDJSON allowlistés : catalogue, claims, evidence graph, changes, signalHistory
`get_freshness`	`limit?`	derniers contenus, compteurs, temporalité par signal et politique de fraîcheur
`search_content`	`query`, `language?`, `mode?`, `limit?`	recherche bilingue sur l'index canonique partagé avec l'Agent Surface et WebMCP
`build_research_pack`	`query`, `language`, `asOf?`, `riskWindow?`, `limit?`	paquet de preuves déterministe : documents, claims canoniques, sources, graphe, fraîcheur, Risk Diff, éléments adverses, limites et URLs citables
`get_claims`	`articleSlug?`, `language?`, `kind?`, `query?`, `limit?`	claims françaises canoniques ; un slug anglais est résolu vers ses preuves françaises
`get_claim`	`claimId`	une claim précise, ses liens ressource et son article
`get_claim_evidence`	`claimId`, `limit?`	preuve et références d'une claim, avec contenus reliés isolés dans `relatedContent`
`list_article_claims`	`articleSlug`, `language?`, `kind?`, `limit?`	claims canoniques d'un article français ou de sa traduction anglaise
`find_claims_by_source`	`sourceId`, `kind?`, `limit?`	claims rattachées à une source primaire, un nom ou un host cité
`get_source`	`sourceId`, `limit?`	source primaire ou hôte cité, plus claims associées
`get_evidence_graph`	`articleSlug?`, `language?`, `nodeType?`, `limit?`	sous-graphe canonique ; un slug anglais pointe vers le graphe français sans duplication
`list_sources`	`mode?`, `limit?`	sources primaires et hôtes effectivement cités
`get_integrity`	`path?`	empreintes SHA-256 canoniques des surfaces Agent Surface
`verify_artifact`	`path`, `sha256?`	vérification allowlistée d'un artefact via le manifeste d'intégrité
`get_changefeed`	`contentType?`, `limit?`	derniers changements avec objectId, version/hash courant et statut de diff
`get_changes`	`contentType?`, `slug?`, `since?`, `limit?`	changefeed filtrable avec métadonnées de version
`list_recent_analyses`	`language?`, `limit?`	dernières analyses, filtrables en `fr` ou `en`
`list_guides`	`language?`	guides de référence français ou anglais
`search_by_topic`	`topic`, `language?`, `limit?`	analyses d'un sujet, filtrables par langue
`get_article`	`slug`, `language?`, `offset?`, `cursor?`, `limit?`, `length?`, `section?`	texte paginé français ou anglais, avec références canoniques séparées

l0g Agent Bench

Le workflow publié exécute agent-bench.mjs contre ce serveur après le test de protocole. Les 44 cas FR/EN n’appellent aucun LLM et couvrent le top 3 documentaire, les sources primaires, la parité des traductions, asOf, le refus sans preuve, la fraîcheur et le typage des claims. Le résultat versionné et attesté est publié sur /api/v1/agent-bench.json et présenté sur /agent-bench/.

Les documents longs exposent section, offset, limit, nextOffset et nextCursor. Exemple : l0g://articles/economie-des-intentions?section=sources&offset=0&limit=12000. Les références structurées sont aussi renvoyées séparément dans references, afin de ne pas dépendre du chunk de texte courant.

get_risk_diff est le chemin court pour répondre à une question de type "qu'est-ce qui a changé dans le risque depuis hier, 7 jours ou 30 jours". get_black_box sert au replay : avec date, le tool sélectionne la dernière frame publiée avant ou le jour demandé ; si aucune frame n'existe, la réponse marque la date comme non rejouable plutôt que de recalculer après coup.

get_claim ne publie pas d’URI fragmentée de preuve : il renvoie la ressource l0g://claims/{claim_id} et oriente vers le tool get_claim_evidence. Les tools marquent les identifiants inconnus avec isError: true. Les resources inexistantes renvoient une erreur protocolaire MCP, pas un document JSON avec champ error.

Sécurité

Écoute 127.0.0.1 uniquement ; TLS et exposition gérés par Apache.
Validation Host et Origin sur chaque requête (anti DNS rebinding, exigé par la spec).
Lecture seule : aucune écriture disque, slugs en allowlist (le path traversal est rejeté), taille de corps bornée à 1 Mo.
Rate limit par IP (120 req/min par défaut, via X-Forwarded-For posé par Apache).
Apache reverse-proxy : LimitRequestBody aligné à 1 Mo, entêtes de sécurité sur réponse, timeout applicatif 30 s, keepalive proxy désactivé sur l’endpoint.
systemd durci : DynamicUser, TimeoutStartSec=45, TimeoutStopSec=15, UMask=0077, PrivateIPC, LimitCORE=0, ProtectSystem=strict, capacités vidées, ReadOnlyPaths, MemoryMax, filtre d'appels système.

Déploiement atomique (Debian, serveur « zen »)

Hypothèses : Apache sert déjà l0g.fr en HTTPS, le site est déployé dans /var/www/html/l0g/current. Node 20+ requis.

1. Installer Node 20+ (si absent)

bash

node -v   # si < 20, installer la LTS :
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Installer une fois le poller de releases attestées

Le runbook complet, le bloc de migration avec sauvegardes et la procédure de release sont dans docs/MCP-RELEASE.md. Après cette migration, le serveur ne lance plus git pull ni npm ci : il poll les GitHub Releases publiques, vérifie SHA-256 et l'attestation GitHub/Sigstore, teste le candidat, puis bascule un symlink atomiquement avec rollback automatique.

Prérequis supplémentaires : GitHub CLI doit fournir gh attestation verify. Le timer et le daemon n'ouvrent aucun port entrant de déploiement et n'utilisent aucun token GitHub permanent.

3. Test à blanc d'une source locale

bash

L0G_DATA_DIR=/var/www/html/l0g/current node server.mjs &
curl -s http://127.0.0.1:8848/healthz       # -> versions MCP/Agent Surface, SHA et fraîcheur chargée
node test-client.mjs                          # liste les tools et teste chaque appel
# le script force l'en-tête Accept requis par le Streamable HTTP :
# application/json, text/event-stream
kill %1

4. Contrôler le service et le timer

bash

systemctl status l0g-mcp l0g-mcp-deploy.timer --no-pager
journalctl -u l0g-mcp-deploy.service -n 100 --no-pager
curl -s http://127.0.0.1:8848/healthz        # -> versions MCP/Agent Surface, SHA et fraîcheur chargée

5. Brancher Apache (reverse proxy)

bash

sudo a2enmod proxy proxy_http headers

Inclure le bloc de deploy/apache-l0g-mcp.conf dans le VirtualHost HTTPS de l0g.fr (le fichier *-le-ssl.conf généré par certbot, entre <VirtualHost *:443> et </VirtualHost>). Puis :

bash

sudo apache2ctl configtest        # Syntax OK
sudo systemctl reload apache2

Après reload :

bash

sudo apache2ctl -M | rg -e "proxy_module|proxy_http_module|headers_module|rewrite_module"
curl -s -I https://l0g.fr/api/mcp | sed -n '1,20p'

6. Vérifier de l'extérieur

Cycle MCP minimal en JSON-RPC brut :

bash

curl -s -X POST https://l0g.fr/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

curl -s -X POST https://l0g.fr/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -s -X POST https://l0g.fr/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | head -c 400

Ou pointer un client compatible (Claude Desktop via mcp-remote, l'inspecteur MCP, etc.) sur https://l0g.fr/api/mcp.

Mises à jour

Données (nouvel article, indices) : automatique. Le site se redéploie, le service relit catalog.json, risk.json et debt-risk.json au plus tard 60 s après.
Code du serveur : automatique après un tag mcp-vX.Y.Z. Le workflow construit une archive versionnée avec SBOM, l'atteste par OIDC, la publie en GitHub Release, attend le déploiement atomique de zen, puis publie le manifeste dans le MCP Registry par OIDC.
Registry : canal de découverte en preview, principalement destiné aux agrégateurs downstream. Il est vérifié après publication, mais ne remplace ni les tests vivants ni la stratégie d'adoption.

Variables d'environnement

Variable	Défaut	Rôle
`MCP_HOST`	`127.0.0.1`	interface d'écoute
`MCP_PORT`	`8848`	port local
`MCP_PATH`	`/mcp`	chemin de l'endpoint
`L0G_DATA_DIR`	`/var/www/html/l0g/current`	racine du site déployé (lecture)
`L0G_SITE`	`https://l0g.fr`	base des URL renvoyées
`MCP_ALLOWED_HOSTS`	`l0g.fr,127.0.0.1,localhost`	en-têtes Host acceptés
`MCP_ALLOWED_ORIGINS`	`https://l0g.fr`	en-têtes Origin acceptés
`MCP_MAX_BODY_BYTES`	`1048576`	limite de payload par requête (1 Mo)
`MCP_RATE_MAX`	`120`	requêtes/min/IP
`MCP_HEADER_TIMEOUT`	`10000`	timeout headers HTTP (ms)
`MCP_REQUEST_TIMEOUT`	`15000`	timeout requête HTTP complet (ms)
`MCP_KEEP_ALIVE_TIMEOUT`	`5000`	timeout keep-alive TCP (ms)
`MCP_MAX_HEADERS_COUNT`	`64`	nombre maximum d'en-têtes parsables
`MCP_RELEASE_ATTESTED`	absent	`1` uniquement dans une archive dont le poller a vérifié la provenance

Install

Tools (26)

get_agent_manifestget_risk_indicesget_signal_historyget_risk_diffget_black_boxget_openapi_schemaget_ndjson_feedget_freshness

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://l0g.fr/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "l0g": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://l0g.fr/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_agent_manifest

get_risk_indices

get_signal_history

get_risk_diff

get_black_box

get_openapi_schema

get_ndjson_feed

get_freshness

search_content

build_research_pack

get_claims

get_claim

get_claim_evidence

list_article_claims

find_claims_by_source

get_source

verify_artifact

get_changes

get_evidence_graph

list_sources

get_integrity

get_changefeed

list_recent_analyses

list_guides

search_by_topic

get_article

Serveur MCP de l0g.fr

État de déploiement

Architecture

Resources exposées

Resources statiques

Resource templates

Prompts exposés

Tools exposés (tous readOnlyHint)

l0g Agent Bench

Sécurité

Déploiement atomique (Debian, serveur « zen »)

1. Installer Node 20+ (si absent)

2. Installer une fois le poller de releases attestées

3. Test à blanc d'une source locale

4. Contrôler le service et le timer

5. Brancher Apache (reverse proxy)

6. Vérifier de l'extérieur

Mises à jour

Variables d'environnement

Install

Remote endpoint

Tools exposés (tous `readOnlyHint`)