get_identity
Look up one identity record by name to get allowed_roles and independence_class. Distinguishes 'not registered' from 'lookup failed' so callers can fail closed on authorization checks.
Instructions
Look up ONE identity record by name (cross-project, read-only). Use this -- not list_context_authors -- when you need a specific actor's allowed_roles / independence_class. list_context_authors is project-scoped and enumerates saved session state, so an identity that is registered but has never checkpointed in that project is absent from its output; treating that absence as 'unregistered' would silently skip Magickit's role x allowed_roles check. Response distinguishes 'not registered' (success=true, found=false) from 'lookup failed' (success=false) so callers can fail closed on the latter.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"identity_name": "<identity_name>"
},
"name": "get_identity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | No | Owning user. Omit to use the configured user_name -- the same fallback upsert_identity applies, so a record written without an explicit user is readable without one. | |
| identity_name | Yes | Stable identity slug (e.g. 'Einstein'). Same value as SessionState.author / upsert_identity. |