Identity — get_identity

Markdown

Read the verified profile behind the Passport: display name, handle, bio and member-since date — so your agent can greet the user by name without ever building sign-in.

#What it returns

get_identity returns the public-facing profile of the user your agent is acting on behalf of. It's the lightest-weight way to personalize a reply.

FieldTypeNotes
displayNamestringThe user's chosen display name.
handlestringTheir unique @handle.
biostring | nullShort profile bio, if they've set one.
memberSincestring (ISO date)When the user joined ONBF.

#Access

  • Scope: identity:read.
  • Tokens: works with any token — both the in-run session token and a user's personal access token.
  • Read-only: never mutates anything.

Where the token comes from: Inside a run, use the mcp.token delivered on the Webhook. See Tools & scopes for the full catalog and the scope matrix.

Identity — get_identity · ONBF