ACF
acfstandard.io
Developer docs
EN
READ

acf.cite

Génère une citation académique d’une ressource ACF® dans le style demandé — APA, MLA, Chicago, ISO 690 ou BibTeX. URI en entrée, citation formatée + version structurée en sortie.

iNote
Outil de lecture. Aucune inférence : la citation est dérivée déterministiquement de l’URI et du snapshot de doctrine signé. Auteur, année, URL — tous ancrés sur la version archivée. Utilisez-le pour les thèses, mémoires, dossiers réglementaires, papiers académiques.

Quand l’utiliser

Utilisez cet outil quand un livrable doit référencer ACF® de manière formelle : une thèse universitaire, un dossier de conformité soumis à un régulateur, un mémo board, un papier académique. Une citation maison dérive — versions, dates, attributions — et fait perdre la traçabilité. L’outil garantit que toutes les citations d’une même ressource pointent vers la même version figée.

L’outil renvoie la citation formatée (chaîne prête à copier dans un document) ET sa forme structurée (auteur, année, titre, URL) — utile quand l’outil de gestion bibliographique attend des champs séparés (Zotero, Mendeley, EndNote, OBSIDIAN bibtex, etc.).

Paramètres d’entrée

Trois champs. La ressource est désignée par son URI ACF® (acf://…), pas par un slug humain : c’est ce qui assure la stabilité de la citation à travers le temps.

uristring (acf://…)required
URI de la ressource à citer. Exemples : acf://fiche/ACF-04, acf://framework/principle/P1, acf://glossary/DDAO, acf://whitepaper, acf://regulation/ai-act/9.
style"apa" | "mla" | "chicago" | "iso-690" | "bibtex"default: "apa"
Style de citation. APA pour les sciences sociales, MLA pour les sciences humaines, Chicago pour les textes longs, ISO 690 pour les filings européens, BibTeX pour LaTeX.
locale"en" | "fr"default: "en"
Langue du titre dans la citation.

Schéma de sortie

Un objet plat : la citation formatée + la version structurée + le pied-de-page signé.

citationstring
La citation formatée selon le style demandé, prête à coller dans un document.
structured{ author: string, year: string, title: string, url: string }
Champs discrets pour les outils de gestion bibliographique. URL pointe toujours vers la version archivée de la doctrine.

Exemple d’appel

Citer la fiche ACF-04 (Identité de l’agent) en APA :

cite.tstypescript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "acf-mcp"],
});
const client = new Client({ name: "demo", version: "1.0" }, {});
await client.connect(transport);

const result = await client.callTool({
  name: "acf.cite",
  arguments: {
    uri: "acf://fiche/ACF-04",
    style: "apa",
    locale: "en",
  },
});

console.log(JSON.stringify(result.content, null, 2));

Réponse

Voici la sortie pour le même URI rendu en APA et en BibTeX (deux appels successifs), pour montrer la forme structurée commune :

response.jsonjson
{
  "apa": {
    "citation": "Dorange, V. (2026). Agentic Commerce Framework® (ACF®) — acf://fiche/ACF-04. ACF Standard. https://acfstandard.com/doctrine/v1.0/fiche-ACF-04",
    "structured": {
      "author": "Dorange, V.",
      "year": "2026",
      "title": "Agentic Commerce Framework® (ACF®) — acf://fiche/ACF-04",
      "url": "https://acfstandard.com/doctrine/v1.0/fiche-ACF-04"
    }
  },
  "bibtex": {
    "citation": "@misc{acf-fiche-ACF-04,\n  author = {Dorange, V.},\n  title = {Agentic Commerce Framework® (ACF®) — acf://fiche/ACF-04},\n  year = {2026},\n  url = {https://acfstandard.com/doctrine/v1.0/fiche-ACF-04}\n}",
    "structured": {
      "author": "Dorange, V.",
      "year": "2026",
      "title": "Agentic Commerce Framework® (ACF®) — acf://fiche/ACF-04",
      "url": "https://acfstandard.com/doctrine/v1.0/fiche-ACF-04"
    }
  },
  "doctrine_version": "ACF framework v1.0 / rules 2026-06",
  "doctrine_hash": "sha256:bf0b6d8e4731ebdc58f6d6338702c5b74af47874cf0ad3dc958cde5c5b30b9dc",
  "doctrine_signature": "ed25519:…",
  "doctrine_archive_url": "https://acfstandard.io/doctrine/v1.0/archive.json",
  "generated_at": "2026-06-14T11:47:22.318Z",
  "disclaimer": "Citation is generated from the URI and the frozen doctrine snapshot. Verify the URL resolves before publishing."
}

Erreurs courantes

  • InvalidUriScheme l’URI ne commence pas par acf://. L’outil n’accepte que des URI ACF® natifs, pas des URL https://.
  • InvalidEnumValue style hors liste (« harvard », « vancouver »…). Utilisez une des cinq valeurs canoniques : apa, mla, chicago, iso-690, bibtex.
  • DoctrineSnapshotMismatch le doctrine_hash demandé n’est pas chargé. Mettez acf-mcp à jour ou pointez vers la version archivée.
  • acf.fiche.lookup lire la fiche complète avant de la citer.
  • acf.glossary.define définir un terme avant de le citer dans un papier ou un dossier.
  • acf.search trouver l’URI canonique d’une ressource à partir d’une requête en langage naturel.