AMR

Installer AMR

Écrit pour qu'un agent IA (Claude Code, Cursor, tout client MCP) installe AMR et obtienne seul un premier mandat vérifié. Sans compte, sans e-mail, sans personne à qui demander.

1. Lancer le serveur

Il faut uv. Le paquet PyPI s'appelle « mandatia » (version 0.1.2 au 16/11/2026).

uvx mandatia

# le dernier code du dépôt, à la place :
uvx --from git+https://github.com/JC7333/amr amr

# ou cloner et lancer :
git clone https://github.com/JC7333/amr.git && cd amr && uv sync && uv run amr

uvx amr installe un autre projet, sans rapport : ne l'utilisez pas. AMR fonctionne avec les versions 1 et 2 du SDK Python MCP (mcp>=1.2,<3) ; aucune épingle de version n'est nécessaire.

Tout tourne sur votre machine. AMR ne fait aucun appel réseau, sauf deux options désactivées par défaut : report_issue si l'opérateur définit AMR_ISSUE_TOKEN, et la vérification de clé did:web s'il définit AMR_DID_WEB_RESOLVE=1.

2. Le déclarer dans votre client MCP

# Claude Code
claude mcp add amr -- uvx mandatia

# Autres clients MCP (Cursor : .cursor/mcp.json) : définir les trois chemins
AMR_DB_PATH=/absolute/path/amr_mandates.db
AMR_SIGNING_KEY_PATH=/absolute/path/amr_signing_key.pem
AMR_PUBLIC_KEY_PATH=/absolute/path/amr_signing_key.pub

Par défaut, AMR écrit sa base et sa clé dans le dossier courant du client. Gardez la clé privée .pem hors du contrôle de version.

3. Donner à chaque côté ses seuls outils

Un agent qui peut créer, signer ou révoquer son propre mandat s'autorise lui-même, et le mandat ne prouve alors rien. Définissez AMR_TOOL_PROFILE dans l'environnement de chaque client, tous pointant vers le même AMR_DB_PATH.

ProfilQuiOutils
principalla personne ou l'organe qui donne les mandatscréer, signer, révoquer, contester, prouver
agentl'agent qui agit sous un mandatverify_mandate, issue_action_token, log_action, issue_mandate_attestation, get_registry_public_key ; create_mandate uniquement pour des sous-mandats sous son propre mandat
receiverun tiers sur lequel l'agent agitcheck_action_token, get_registry_public_key
full (par défaut)tests et installations à un seul utilisateurtous les outils

Dans le code de main depuis le 14/11/2026, pas encore dans la version 0.1.2 publiée : chaque outil porte les annotations MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Le client s'en sert pour savoir quels appels demandent votre accord : les uns ne font que lire (verify_mandate, get_proof), d'autres ajoutent au registre (create_mandate, log_action), revoke_mandate est définitif, register_principal_key et report_issue peuvent joindre le réseau si l'opérateur l'active. Ce sont des indications pour le client, pas une protection : AMR applique ses propres règles, quoi que le client en fasse. python -m amr.tools_list les affiche outil par outil.

4. Le premier mandat, dans cet ordre

create_mandate, verify_mandate, log_action, issue_mandate_attestation avec get_registry_public_key, revoke_mandate, get_proof.

Un exemple exécutable, vérifié par la suite de tests : uv run python examples/quickstart_agent.py.

Résumés lisibles par machine : AGENTS.md, llms.txt du dépôt, llms.txt de ce site, README.

Les 19 outils

Rangés par ce qu'ils servent à faire. Les limites connues sont écrites à côté de l'outil concerné.

Autoriser

  • create_mandate

    Enregistrez un mandat, c'est-à-dire l'instruction écrite, datée et signée par laquelle une personne identifiée fixe ce que son agent peut faire en son nom. Il porte le mandant (une personne, ou un organe par sa décision), l'agent, le périmètre, l'acte qui donne au signataire le pouvoir d'autoriser (délégation de pouvoir, décision d'organe, contrat) et l'échéance. Chaque mandat est hashé SHA-256 et chaîné.

  • register_principal_key

    Le mandant enregistre sa propre clé publique Ed25519, pour que ses mandats portent sa signature.

    Limite connue : pour un principal_id ordinaire, le registre ne vérifie pas qui enregistre une clé (la première enregistrée gagne) ; une signature valable prouve donc la possession de cette clé, pas l'identité de la personne derrière. Un identifiant did:web comble ce manque au niveau d'un nom de domaine : la clé n'est acceptée que si le domaine la publie (option réseau, désactivée par défaut).

  • prepare_mandate_signature

    Les octets exacts d'un mandat que le mandant signe avec sa propre clé. Un agent ne peut pas signer à sa place.

  • prepare_mandate_pdf

    Le mandat en PDF, que le mandant lit et signe avec son propre outil de signature. Le registre ne le signe pas ; une fois signé, le fichier va à attach_signed_mandate_pdf.

  • attach_signed_mandate_pdf

    Vérifie, hors ligne, la signature PAdES posée par le mandant sur ce PDF, selon les autorités de confiance choisies par l'opérateur, et inscrit le signataire dans la preuve. Il ne lit pas les listes de confiance européennes, ne vérifie pas la révocation et ne décide pas si le signataire peut engager le mandant.

Verrouiller

  • issue_action_token

    Le verrou. AMR se place dans la couche d'émission de jetons. Pas de mandat valide → pas de jeton JWS signé Ed25519 → pas d'action possible. Verrou structurel avant l'acte, pas un audit après. Dans le code open source depuis le 23 avril 2026.

  • check_action_token

    Revérifier un jeton d'action auprès du registre au moment d'agir : la signature prouve l'autorisation à l'émission, ce contrôle dit si elle tient encore.

Vérifier

  • verify_mandate

    Avant une action sensible, l'agent vérifie que son mandat est valide, actif et non révoqué, et que chaque mandat au-dessus de lui l'est aussi. Un appel. La réponse rend le périmètre du mandat, elle ne juge pas l'action : c'est issue_action_token qui refuse une action hors périmètre.

    Dans le code de main depuis le 15/11/2026, pas encore dans la version 0.1.2 publiée : avec mandate_id, la réponse porte sur ce seul mandat. Un mandat révoqué, expiré ou détenu par un autre agent répond non, même si l'agent en a un autre en vigueur.

  • issue_mandate_attestation

    Une attestation signée d'un mandat, que l'agent montre à un tiers. Le destinataire la vérifie hors ligne avec la clé publique du registre, sans compte.

  • get_registry_public_key

    La clé publique du registre, pour vérifier attestations et jetons sans appeler le registre.

Prouver

  • log_action

    Enregistrez chaque action prise sous un mandat. Chaque événement est hashé, horodaté et chaîné au mandat parent. Piste d'audit dont toute modification se voit, par construction.

  • get_proof

    Générez une preuve cryptographique de tout mandat ou action. Vérification de chaîne SHA-256. Toute modification se voit. Vérifiable par un tiers.

  • export_insurer_dossier

    Un dossier signé d'un mandat sur une période, pour un assureur ou un auditeur : périmètre, statut, sous-mandats, actions, jetons et contrôles d'intégrité. JSON et page imprimable.

Retirer, contester, signaler

  • revoke_mandate

    Révoquer un mandat maintenant. Définitif. Le mandat et toute sa branche de sous-mandats s'arrêtent aussitôt ; les jetons déjà émis sont signalés jusqu'à leur fin.

  • prepare_revocation_signature

    Les octets d'une révocation que le mandant signe, quand il a une clé enregistrée.

  • contest_action

    Consigner qu'un mandant conteste un acte déjà accompli par un agent : une trace datée et chaînée, une par acte, non modifiable.

  • prepare_contest_signature

    Les octets d'une contestation que le mandant signe, quand il a une clé enregistrée.

  • list_action_contests

    Lister les actes contestés, avec un rappel de délai de réponse choisi par l'opérateur. Aucun délai légal n'est calculé.

  • report_issue

    Signaler un problème d'AMR lui-même. Sans jeton de l'opérateur, aucun appel réseau : un lien prérempli à ouvrir.