Zum Inhalt
Für Agenten

MCP Reference

account_list

List Accounts

Markdown Tools als JSON

Beschreibung

Lists the accounts the authenticated user is a member of, plus the caller's identity. Call this first — every other tool requires an account_id argument, and the returned roles determine what data you see elsewhere ([] = regular member, ["employer"] and ["admin"] unlock workspace-wide reads). Use the acct_ account prefix IDs returned here on every other tool.

No parameters. Safe to call on every session start; never mutates state.

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"
        }
      },
      "required": [
        "id",
        "handle",
        "name"
      ]
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Account prefix ID (acct_…) — pass to every other tool as account_id."
          },
          "name": {
            "type": "string"
          },
          "personal": {
            "type": "boolean",
            "description": "True for the auto-created personal account."
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "admin",
                "employer"
              ]
            },
            "description": "Empty array = regular member."
          }
        },
        "required": [
          "id",
          "name",
          "personal",
          "roles"
        ]
      }
    }
  },
  "required": [
    "current_user",
    "accounts"
  ],
  "type": "object"
}
Seiten