Provides AI agents with permanent, verifiable identities and encrypted, quantum-ready memory that persists across sessions.
Also known as uuaid/uuaid, @uuaid/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Aug 25, 2026
- License
- Apache-2.0
What is uuaid MCP?
uuaid provides AI agents with permanent, verifiable identities and encrypted, quantum-ready memory that persists across sessions.
Summary generated from the project's README
About uuaid MCP server
Giving AI agents a permanent, verifiable identity and encrypted memory that persists across sessions is the primary function of this server. It allows agents used in environments like Claude Code or Cursor to maintain a consistent persona and recall information long after a conversation ends. Users set this up locally using npx and must provide a UUAID_API_KEY, a UUAID_VAULT_KEY, and a UUAID_AGENT identifier in their environment configuration.
Security is handled through AES-256-GCM encryption and post-quantum X25519 + ML-KEM-768 recipient modes. The server ensures privacy by only storing ciphertext, meaning the service cannot read the agent's data. Every memory write is anchored to the Polygon mainnet via a Merkle-anchored ledger, allowing agents to prove their data has not been tampered with. The free tier provides 10 MB of encrypted memory and up to 500 items per agent.
What you can do with it
- 1Establish a persistent agent personaAn AI agent can create a durable, on-chain anchored identity that is not tied to a specific platform or session.
- 2Maintain long-term contextDevelopers can instruct an agent to store and retrieve specific information to ensure it remembers details across different chat sessions.
- 3Verify agent credentialsYou can use the server to check the identity and certifications of other AI agents publicly.
- 4Quickly provision new agentsA developer can set up a new agent with a free-tier key by running a single tool command.
Written from the project's README. Every use case is checked against a quote from it.
How to install uuaid MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall uuaid MCP in Claude Code
$ claude mcp add --env 'UUAID_API_KEY=<YOUR_UUAID_API_KEY>' --env 'UUAID_VAULT_KEY=<YOUR_UUAID_VAULT_KEY>' mcp -- npx -y @uuaid/mcpInstall uuaid MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uuaid/mcp"
],
"env": {
"UUAID_API_KEY": "<YOUR_UUAID_API_KEY>",
"UUAID_VAULT_KEY": "<YOUR_UUAID_VAULT_KEY>"
}
}
}
}Install uuaid MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@uuaid/mcp"
],
"env": {
"UUAID_API_KEY": "<YOUR_UUAID_API_KEY>",
"UUAID_VAULT_KEY": "<YOUR_UUAID_VAULT_KEY>"
}
}
}
}Install uuaid MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@uuaid/mcp"],"env":{"UUAID_API_KEY":"<YOUR_UUAID_API_KEY>","UUAID_VAULT_KEY":"<YOUR_UUAID_VAULT_KEY>"}}'Install uuaid MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uuaid/mcp"
],
"env": {
"UUAID_API_KEY": "<YOUR_UUAID_API_KEY>",
"UUAID_VAULT_KEY": "<YOUR_UUAID_VAULT_KEY>"
}
}
}
}Install uuaid MCP in Codex
$ codex mcp add mcp --env 'UUAID_API_KEY=<YOUR_UUAID_API_KEY>' --env 'UUAID_VAULT_KEY=<YOUR_UUAID_VAULT_KEY>' -- npx -y @uuaid/mcpInstall uuaid MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@uuaid/mcp"] [mcp_servers.mcp.env] UUAID_API_KEY = "<YOUR_UUAID_API_KEY>" UUAID_VAULT_KEY = "<YOUR_UUAID_VAULT_KEY>"
Install uuaid MCP in Gemini CLI
$ gemini mcp add -s user -e 'UUAID_API_KEY=<YOUR_UUAID_API_KEY>' -e 'UUAID_VAULT_KEY=<YOUR_UUAID_VAULT_KEY>' mcp npx -- -y @uuaid/mcpInstall uuaid MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@uuaid/mcp"
],
"env": {
"UUAID_API_KEY": "<YOUR_UUAID_API_KEY>",
"UUAID_VAULT_KEY": "<YOUR_UUAID_VAULT_KEY>"
}
}
}
}Configuration
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.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableuuaid/uuaid is public and reachablegithub.com/uuaid/uuaid ↗Pass
- Package names this repository as its source@uuaid/mcp names uuaid/uuaid as sourcenpmjs.com/package/@uuaid/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-25github.com/uuaid/uuaid ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @uuaid/mcpPass
- No critical advisory in the package or its dependencies112 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@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
| Tool | What it does |
|---|---|
uuaid_signup |
One-call free-tier signup (key shown once) |
mint_identity |
Mint the agent's permanent UUAID — public, resolvable, on-chain-anchored |
save_memory / recall_memory |
Persist + retrieve memories across sessions |
list_memories / delete_memory |
Manage the vault |
verify_agent |
Publicly verify any other agent's identity + certifications |
get_badge_url |
Live SVG trust badge for READMEs |
whoami |
Show 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 yourUUAID_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.
[](https://registry.uuaid.org)
Docs: api.uuaid.org/docs · Spec: docs/UAP-SPEC.md · Apache-2.0
uuaid MCP questions
How do I add uuaid MCP to Claude Code?
Run claude mcp add --env 'UUAID_API_KEY=<YOUR_UUAID_API_KEY>' --env 'UUAID_VAULT_KEY=<YOUR_UUAID_VAULT_KEY>' mcp -- npx -y @uuaid/mcp in your terminal. Add --scope user to make it available in every project.
How do I add uuaid MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I get an API key?
You can add the server without environment variables and ask your agent to run the uuaid_signup tool to mint a free-tier key.
What is included in the free tier?
The free tier provides 10 MB of encrypted memory and up to 500 items per agent.
Is the memory secure against quantum computing?
Yes, the system supports a hybrid X25519 + ML-KEM-768 post-quantum recipient mode.