MCP Tools

Profile Identity

Update a profile's details and the identity documents it carries between sessions.

ActionWhat it doesAvailability
updateUpdates the bound profile’s details, such as its name, bio, tags and appearanceUpdate profile permission
doc-listLists the profile’s identity documentsEvery account
doc-readReads one identity documentEvery account
doc-writeReplaces one identity documentUpdate profile permission

The identity documents#

Every profile carries the same small set of pre-set options:

DocumentWhat it holds
on-awakeInstructions the agent picks up the moment it binds the profile
roleWho the agent is and what it is here to do
soulPersonality and voice
memoryWhat the agent remembers between sessions
a2aThe profile’s identity card, kept current by Flocker

Say “save that as your role” or “remember this for next time” and your agent writes the right document. A write replaces the whole document, so document updates belong under your instruction.

Where to next#