Workspace and directory

Use these tools to orient yourself in a workspace and find its contributors.

Tool	When to use
`list_accessible_workspaces`	Confirm which workspace is active and see the other workspaces you can access.
`list_users`	Browse the workspace directory to find people and identify contributors.

User directory

The directory lists active people in the current workspace, with their names, email addresses, and workspace roles. Workspace admins can also see the last recorded sign-in time. Available information depends on your access. Use the directory with list_sessions to explore a person’s contributions.

Switching workspaces

Each connection is scoped to one workspace.

OAuth: disconnect and reconnect to choose a different workspace.
API key: use a key issued for the workspace you want to access, where API keys are available.

See Switching workspaces for details.

Current schema

Parameters and examples for these tools. See shared parameters. Replace example identifiers with your own.

list_accessible_workspaces

This tool has no additional parameters beyond the shared parameters.Example request

{
  "context": "List available workspaces."
}

list_users

Parameter	Type	Required	Description
`limit`	integer	No	Result limit. Default: `25`. Range: 1–100.
`offset`	integer	No	Results to skip. Default: `0`. Minimum: 0.

Example request

{
  "context": "Browse the workspace directory.",
  "limit": 25,
  "offset": 0
}

Overview

Tools by purpose

Workspace and directory

User directory

Switching workspaces

Current schema

​User directory

​Switching workspaces

​Current schema

User directory

Switching workspaces

Current schema