Skip to main content

​
Agent identity

Every agent registered with Mnemom receives a unique, permanent agent ID assigned at the time of first registration. This ID is the cryptographic anchor for the agent’s reputation, alignment cards, and proof chain.

​
ID format

New agents receive IDs in the mnm-{uuid_v4} format: 
mnm-550e8400-e29b-41d4-a716-446655440000
This is a standard UUID v4 with the mnm- prefix. The UUID provides 128 bits of entropy — zero practical collision risk even at millions of agents.

​
Legacy format

Agents registered before April 2026 use the original smolt-{8_hex} format: 
smolt-a4c12709
Both formats are permanently valid and fully supported. Existing agents will never have their IDs changed — these IDs are cryptographically committed to proof chains and on-chain anchors.

​
How IDs are assigned

Agent IDs are server-assigned, not derived from your API key. When you first use an API key with the Mnemom gateway, the gateway registers a new agent and assigns it a UUID. That UUID is returned in the x-mnemom-agent response header and stored in your local CLI config. This means:
  • You cannot predict your agent ID before registration
  • If you lose your CLI config, re-running mnemom init with the same API key recovers your existing agent ID from the server — the API key hash uniquely identifies your agent
  • Two uses of the same API key always get the same agent, regardless of which machine or session

​
Finding your agent ID

mnemom status
# Agent: my-agent
# ID:    mnm-550e8400-e29b-41d4-a716-446655440000
Or from any gateway response header: 
x-mnemom-agent: mnm-550e8400-e29b-41d4-a716-446655440000

​
Stability guarantee

Agent IDs never change. They are:
  • Referenced in every alignment card (agent_id field)
  • Anchored in on-chain Merkle proofs
  • Embedded in ZK-STARK attestations
  • Used as the stable foreign key across all integrity records
Do not attempt to update or reassign an agent ID. The ID is the agent.

​
Using agent IDs in API calls

All agent-specific API endpoints accept both mnm-* and smolt-* formats interchangeably: 
# New format
curl https://api.mnemom.ai/v1/agents/mnm-550e8400-e29b-41d4-a716-446655440000/card

# Legacy format (still fully supported)
curl https://api.mnemom.ai/v1/agents/smolt-a4c12709/card