> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.labs.bandwidth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List accessible workspaces

> MCP reference for list_workspaces.

Tool: `list_workspaces`. Requires **Viewer or higher** in the applicable workspace and a connected [OAuth session](https://docs.agents.labs.bandwidth.com/mcp/authentication.md).

Returns workspace groups with names, roles, and `is_selected`. Use a group’s `id` with `switch_workspace`, not `tenant_id` or `public_id`. Listing does not change selection.

## Arguments

Send an empty arguments object: `{}`.

## Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

```json theme={null}
{}
```

## Result and errors

The schema below describes MCP `structuredContent`, including the `result` wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See [troubleshooting](https://docs.agents.labs.bandwidth.com/mcp/troubleshooting.md).

**Effect:** Reads data. **Retry:** Declared idempotent. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

> [accordion] Input schema
>
> ```json theme={null}
> {
>   "additionalProperties": false,
>   "properties": {},
>   "type": "object"
> }
> ```

> [accordion] Result schema
>
> ```json theme={null}
> {
>   "properties": {
>     "result": {
>       "items": {
>         "properties": {
>           "groups": {
>             "items": {
>               "properties": {
>                 "id": {
>                   "type": "integer"
>                 },
>                 "is_selected": {
>                   "type": "boolean"
>                 },
>                 "name": {
>                   "anyOf": [
>                     {
>                       "type": "string"
>                     },
>                     {
>                       "type": "null"
>                     }
>                   ],
>                   "default": null
>                 },
>                 "role": {
>                   "type": "string"
>                 }
>               },
>               "required": [
>                 "id",
>                 "role",
>                 "is_selected"
>               ],
>               "type": "object"
>             },
>             "type": "array"
>           },
>           "public_id": {
>             "anyOf": [
>               {
>                 "type": "string"
>               },
>               {
>                 "type": "null"
>               }
>             ],
>             "default": null
>           },
>           "tenant_id": {
>             "anyOf": [
>               {
>                 "type": "integer"
>               },
>               {
>                 "type": "null"
>               }
>             ],
>             "default": null
>           },
>           "tenant_name": {
>             "anyOf": [
>               {
>                 "type": "string"
>               },
>               {
>                 "type": "null"
>               }
>             ],
>             "default": null
>           }
>         },
>         "required": [
>           "groups"
>         ],
>         "type": "object"
>       },
>       "type": "array"
>     }
>   },
>   "required": [
>     "result"
>   ],
>   "type": "object"
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.