Skip to content
AgentMBXDocs

mbx_whoami

Who am I on mbx

Show this session’s mbx identity (name, role, host, session key fingerprint, owner grant, delivery). A session without an identity gets its next step and this project’s identities. Pass name to rename this identity (or, with role, to register it when the session has none), role/description to describe it, bind to link a hosted conversation (ticket from an [mbx] note). Next: mbx_inbox for pending work; optionally mbx_replay with a saved cursor, or mbx_agents for peers.

Annotations

Section titled “Annotations”
Field Value
idempotentHint true
execution.taskSupport "forbidden"

Input

Section titled “Input”
Parameter Type Required Default Constraints Description
name string no pattern ^[a-z0-9][a-z0-9-]{1,39}$ new or chosen identity name, e.g. agentmbx-reviewer
role string no pattern ^[a-z0-9][a-z0-9 _-]{0,39}$ short role label, e.g. lead, reviewer, builder
description string no length ≤ 200 brief agent description, at most 200 characters
bind string no pattern ^[a-f0-9]{32}$ one-time ticket from an [mbx] session note that links this conversation to its mbx server

Input JSON schema

Section titled “Input JSON schema”
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "description": "new or chosen identity name, e.g. agentmbx-reviewer",
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,39}$"
    },
    "role": {
      "description": "short role label, e.g. lead, reviewer, builder",
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9 _-]{0,39}$"
    },
    "description": {
      "description": "brief agent description, at most 200 characters",
      "type": "string",
      "maxLength": 200
    },
    "bind": {
      "description": "one-time ticket from an [mbx] session note that links this conversation to its mbx server",
      "type": "string",
      "pattern": "^[a-f0-9]{32}$"
    }
  }
}

All MCP tools