Protocol

Universal Plug Protocol

Checkable evidence for AI agents: what an agent did, and on whose authority. Closed by default.

The problem

An agent can act for you. It can send a message, change a record, or move value. Later, someone asks whether it was allowed to. Ordinary logs can be edited, and the agent’s own word is not evidence. A useful answer has to be checkable by a third party who does not have to trust the agent, its operator, or you.

What the protocol provides

  • Prove and check. A fact’s hash, type, issuer, times, and labels are signed together and anchored on a ledger. A check accepts the result only if the signature, the issuer, the anchor, and the verifier’s own trust policy all hold.
  • Grants: on whose behalf. Consent, mandates, and approvals are one primitive: a signed grant with a scope, an expiry, and optional delegation that can only narrow. A check of authority tells you whether an action was authorized, in scope, and not revoked.
  • Closed by default. No issuer is trusted, no host is fetched, and no fact type is provable by a model until an operator grants it. Opening a permission is an explicit, logged act.
  • Personal data stays off the ledger. Only an unlinkable hash is anchored. Erase the salt, and the link is gone.

The ledger can be a local log or a public chain. Keys can be held in software or in a hardware security module. A model can be given prove and check tools while the server keeps every key.

A short example

from upp import Attestation, LocalLedger, Plug

plug = Plug()
plug.register("log", LocalLedger("evidence.jsonl"))
plug.open("log")
receipt = plug.prove({"tool": "email.send", "to": "bob"}, "agent.action")

auditor = Plug(trust={"log": {"issuers": [plug.active().subject]}})
auditor.register("log", LocalLedger("evidence.jsonl"))
print(auditor.check(Attestation.from_receipt(receipt))["valid"])

In the protocol’s own examples, a reminder message is authorized, a marketing message outside the grant is refused, a relabeled action fails the proof, and a revocation stops later use of the same grant while leaving earlier authorized acts intact.

Status

The protocol is pre-1.0. The design and the programming interface may still change. It has been tested against public cryptographic test vectors and an independent verifier, and it has not had an external audit.

Source, specification, and examples: github.com/gor-agi/universal-plug-protocol. The project is released under the Apache License 2.0.