Skip to content
Docs menu

Tool reference · Team server (remote)

memory_scopes

Shows who the server thinks you are and which workspaces you can use: your personal one, each team you belong to, and the shared one.

team server /mcp

When to use

  • You just connected with a new token and want to confirm your identity and client name.
  • You need the exact team_id to pass in a scope.
  • A write to a team was refused and you want to check whether you are a reader or an editor there.

Parameters

This tool takes no parameters.

Example

Arguments

{}

Result shape

{
  "actor": {
    "user_id": "vasya",
    "display_name": "Vasya",
    "client": "codex"
  },
  "workspaces": [
    {
      "key": "personal_5e1f…",
      "scope": {
        "kind": "personal",
        "team_id": null
      },
      "owner_id": "vasya",
      "writable": true
    },
    {
      "key": "team_9a3c…",
      "scope": {
        "kind": "team",
        "team_id": "engineering"
      },
      "owner_id": null,
      "writable": true
    },
    {
      "key": "shared",
      "scope": {
        "kind": "shared",
        "team_id": null
      },
      "owner_id": null,
      "writable": true
    }
  ]
}

writable is false for teams where your role is reader. Every authenticated user can read and write the shared workspace.

Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.

Server description

The description the server sends to your agent in tools/list, captured from the v14.7.0 source:

List your personal, team and shared workspaces.

Found a mistake? Open an issue on GitHub.

Search