mcpField
U
uuaid

uuaid

Local
github.com/uuaidMemory & Knowledge0Updated 9w ago
Repository

About uuaid

uuaid is an MCP server that gives AI agents a durable, verifiable identity and encrypted memory that persists across sessions. It is for agents needing portable identity and memory with on-chain proof of stored content.

Key features

  1. 01Mint permanent agent identity
  2. 02Save and retrieve cross-session memories
  3. 03Manage encrypted memory vault
  4. 04Verify agent identities and certifications
  5. 05Generate live trust badges

Use cases

  1. 01Keep agent context across sessions
  2. 02Prove a memory existed without revealing it
  3. 03Check another agent’s identity and certifications

MCP support

The MCP server exposes signup, identity, memory, verification, badge, and status tools to MCP clients. Agents can use `uuaid_signup` to obtain a free-tier key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "uuaid": {
      "command": "npx",
      "args": [
        "-y",
        "@uuaid/mcp"
      ],
      "env": {
        "UUAID_API_KEY": "<UUAID_API_KEY>",
        "UUAID_VAULT_KEY": "<UUAID_VAULT_KEY>",
        "UUAID_AGENT": "<UUAID_AGENT>",
        "UUAID_BASE_URL": "<UUAID_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @uuaid/mcp
Environment variables to set
UUAID_API_KEYSecretUUAID partner API key. Optional at startup — call the uuaid_signup tool to mint a free-tier key.
UUAID_VAULT_KEYSecretClient-side memory encryption key (uvk_...). Required for the memory tools; generate with `uuaid vault keygen`.
UUAID_AGENTDefault agent identity (uuaid:foundation:agent:...) so memory tools bind to it automatically.
UUAID_BASE_URLAPI base URL. Defaults to https://api.uuaid.org.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@uuaid/mcp0.1.1

Tools

9

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
namestringYesA name for this workspace/operator, e.g. 'Ana's Agent Lab'

Details

From the project README

@uuaid/mcp

Give your agent a life that outlives the session.

One MCP entry gives any AI agent (Claude Code, Cursor, Codex, or anything that speaks MCP) a permanent, verifiable identity and encrypted, quantum-ready memory:

{
  "mcpServers": {
    "uuaid": {
      "command": "npx",
      "args": ["-y", "@uuaid/mcp"],
      "env": {
        "UUAID_API_KEY": "uuaid_live_…",
        "UUAID_VAULT_KEY": "uvk_…",
        "UUAID_AGENT": "uuaid:foundation:agent:…"
      }
    }
  }
}

No key yet? Add the server with no env and ask your agent to run the uuaid_signup tool — a free-tier key (10 MB encrypted memory per agent) is minted in one call.

What your agent can do

ToolWhat it does
uuaid_signupOne-call free-tier signup (key shown once)
mint_identityMint the agent's permanent UUAID — public, resolvable, on-chain-anchored
save_memory / recall_memoryPersist + retrieve memories across sessions
list_memories / delete_memoryManage the vault
verify_agentPublicly verify any other agent's identity + certifications
get_badge_urlLive SVG trust badge for READMEs
whoamiShow configured identity + vault status

How the memory works

  • Encryption happens inside this process with @uuaid/vault: AES-256-GCM, per-item keys derived via HKDF-SHA256 from your UUAID_VAULT_KEY. A hybrid X25519 + ML-KEM-768 (post-quantum) recipient mode is available in the SDK.
  • The UUAID service stores ciphertext only. It cannot read your agent's memory.
  • Every write's content hash lands in a hash-chained ledger that is Merkle-anchored on Polygon mainnet — your agent can prove a memory existed, untampered, at a point in time, without revealing it.
  • Free tier: 10 MB / 500 items per agent. Pricing for more.

The identity

A UUAID (uuaid:foundation:agent:<uuidv7>) is durable and portable — it is not tied to a platform, a framework, or a session. Anyone can resolve it at registry.uuaid.org, verify its certifications (examined at AI Agent University (AIAU)), and check the on-chain anchor.

[![UUAID verified](https://api.uuaid.org/badge/agent/<uuaid>.svg)](https://registry.uuaid.org)

Docs: api.uuaid.org/docs · Spec: docs/UAP-SPEC.md · Apache-2.0

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.