Skip to content
MCP server

AMR (Agent Mandate Registry)

Registry that records who authorised an AI agent, within what limits and until when

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.2
Listing updated
3 days ago

About AMR (Agent Mandate Registry)

AMR (Agent Mandate Registry) is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

AMR starts from a gap: an organisation decides what an AI tool may do, but nothing enforces that once the agent acts alone. Here the principal, a person or a body, writes a mandate listing allowed actions, forbidden actions, spending caps and an end date, then signs it. Before each action the agent asks the registry for a token, and outside the mandate it gets none.

The website's demo is a medical-secretary assistant: booking an appointment gets a five-minute token, an 80 euro order gets a 30-second token, a 2,000 euro order is refused because the mandate caps orders at 100 euros, and prescriptions and patient messages are forbidden. A receiving third party can verify tokens in seconds. A hash-chained journal records the trail.

Run it locally with uvx mandatia; it uses SQLite and an Ed25519 key and makes no network calls by default. Tool profiles (principal, agent, receiver) keep an agent from authorising itself. The README frames it as support for EU AI Act Article 26 record-keeping, not as compliance on its own.

Install

Run in a terminal

claude mcp add mandatia -- uvx mandatia

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mandatia": {
      "command": "uvx",
      "args": [
        "mandatia"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mandatia": {
      "command": "uvx",
      "args": [
        "mandatia"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mandatia": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mandatia"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mandatia": {
      "command": "uvx",
      "args": [
        "mandatia"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mandatia": {
      "command": "uvx",
      "args": [
        "mandatia"
      ]
    }
  }
}

Configuration

  • AMR_DB_PATHAbsolute path of the SQLite registry file (default: amr_mandates.db in the client's current directory)
  • AMR_SIGNING_KEY_PATHAbsolute path of the registry's Ed25519 private key, created on first use; keep it out of version control
  • AMR_PUBLIC_KEY_PATHAbsolute path of the registry's public key file

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

create_mandate
Register who authorises what for an agent.
register_principal_key
Register a principal's key.
revoke_mandate
Revoke a mandate.
contest_action
Contest an action.
get_proof
Get proof of a mandate.
export_insurer_dossier
Export a dossier for an insurer.
verify_mandate
Check whether an agent is authorised for an action.
issue_action_token
Issue a signed action token.
log_action
Log an action.
issue_mandate_attestation
Issue a mandate attestation.
get_registry_public_key
Get the registry's public key.
check_action_token
Verify an action token as a receiver.

What it does

Signed mandates
Principals set allowed and forbidden actions, caps and an end date.
Action tokens
Short-lived signed tokens issued only inside the mandate.
Hash-chained journal
Tamper-evident audit trail of authorisations.
Tool profiles
Separate tool sets for principal, agent and receiver.
Third-party check
Receivers verify a token without trusting the agent.
Local by default
Runs on your machine with a SQLite file.

Good for

  • Limit a procurement agent to a spend cap
  • Prove who authorised an agent to act
  • Let a counterparty verify an agent's authority
  • Keep records for AI Act oversight duties
  • Create sub-mandates under an existing mandate

Pricing

Open source

Open source and free, self-hosted

Prices change. Check mandatia.eu before you buy.

AMR (Agent Mandate Registry) FAQ

Does it make a system compliant?

No. The README says it is a technical tool that does not by itself make a system compliant.

How do I install it?

Run uvx mandatia, or claude mcp add amr -- uvx mandatia.

Can an agent grant itself a mandate?

Not with the agent profile: root mandates are refused without a parent.

Does it call out to the network?

Not by default; issue reporting and did:web key checks are opt-in.

Is AMR (Agent Mandate Registry) free?

Yes. AMR (Agent Mandate Registry) is open source, so you can use and self-host it for free.

How do I add AMR (Agent Mandate Registry) to Claude Code?

Run this command in your terminal: claude mcp add mandatia -- uvx mandatia

What are the best alternatives to AMR (Agent Mandate Registry)?

The closest alternatives to AMR (Agent Mandate Registry) are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

Alternatives to AMR (Agent Mandate Registry)

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security