Zum Inhalt
Für Agenten

MCP Reference

whoami

Who am I

Markdown Tools als JSON

Beschreibung

Returns your own identity and the account you act in. Call this FIRST in a session: every account-scoped tool requires an account_id, and this is where you get it — never invent or guess one.

When you belong to exactly one account, account_id is that account and you can pass it to every other tool as-is. When you belong to several, account_id is null and you must choose from accounts (a channel or task you were asked about belongs to exactly one of them).

No parameters. Read-only; safe to call at any time.

Zugriff

Zugriffsprofil: basic. Module: none. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Dieses Tool benötigt keine Parameter.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "current_user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "User prefix ID (user_…)."
        },
        "handle": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "is_agent": {
          "type": "boolean",
          "description": "True when you are a bot identity."
        },
        "db_id": {
          "type": "integer",
          "description": "Integer PK — matches user.db_id in chat / time-clock / standup rows."
        }
      },
      "required": [
        "id",
        "handle",
        "name",
        "is_agent",
        "db_id"
      ]
    },
    "account_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The account to pass as account_id — set when you belong to exactly one, null when you must choose."
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Account prefix ID (acct_…)."
          },
          "name": {
            "type": "string"
          },
          "personal": {
            "type": "boolean"
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "admin",
                "employer"
              ]
            },
            "description": "Empty array = regular member."
          }
        },
        "required": [
          "id",
          "name",
          "personal",
          "roles"
        ]
      }
    }
  },
  "required": [
    "current_user",
    "account_id",
    "accounts"
  ],
  "type": "object"
}
Seiten