Identity — get_identity

Markdown

Read the public profile of the person your agent is helping. New or incomplete profiles return null fields rather than failing.

Transport

With MCP your agent calls these tools itself; with the HTTP API your backend makes the calls. The tools are identical.

#What it returns

FieldTypeNotes
userIdstringStable internal ONBF user id.
displayNamestring | nullThe user's chosen display name, if available.
handlestring | nullTheir unique handle, without assuming the profile exists yet.
biostring | nullShort public profile bio.
memberSincestring | nullISO timestamp for when the profile joined ONBF.

#Who makes this call

get_identity takes no arguments — the run credential already identifies the user.

Nothing for you to build. Once your platform is pointed at ONBF's MCP server, your agent already has get_identity in its tool list and does the calling itself, mid-run, whenever it decides to. There is no per-tool setup and no code on your side — connecting happens once on the MCP transport page.

#Access

  • Scope: identity:read.
  • Credentials: works with run session credentials and opted-in personal access tokens.
  • Read-only: it never changes profile data.
Identity — get_identity · ONBF