Workspaces

The workspace tools choose where an assistant's work lands when your Nodaro account belongs to an organization, such as a school or a team. In the web app you choose a workspace in a switcher; an MCP client has no switcher, so list_workspaces answers "where can I work?" and select_workspace answers "work there". Read more about organizations in Workspaces.

The tools exist only on Nodaro Cloud instances where organizations are switched on. Everywhere else they are absent, so a client learns that workspaces do not apply instead of finding a switch that does nothing. Connections authorized before organizations existed do not have the workspace permissions; remove the connector and add it again to grant them.

list_workspaces

Returns the organizations and workspaces your account belongs to, and the workspace the session works in now.

Permission: workspaces:read. Credits: free. Nodaro Cloud only.

This tool has no parameters.

Returns:

{
  "workspaces": [
    { "id": "uuid", "orgId": "uuid", "name": "Class 1", "slug": "class-1", "role": "member", "memberStatus": "active", "archived": false }
  ],
  "organizations": [
    { "id": "uuid", "slug": "kent-high", "name": "Kent High", "kind": "school", "status": "active", "role": "owner" }
  ],
  "selectedWorkspaceId": "uuid"
}

Empty lists mean the account belongs to no organization. That is normal, not an error.

select_workspace

Makes the session work in a workspace, and remembers the choice for the next sessions. Pass null to go back to your personal space.

Permission: workspaces:write. Credits: free. Nodaro Cloud only.

Returns: whether the workspace was selected or refused.

• The server decides. The tool proposes a workspace, and Nodaro accepts it or refuses it. Only a workspace that was accepted is remembered.
• The choice is checked at every session. Membership can end between two sessions. If you are no longer in the saved workspace, Nodaro clears the choice and the session continues in your personal space.
• Selecting grants nothing. It records where the session's work belongs. It gives no access and moves no work, so a wrong choice costs one step and exposes nothing.

Usage reports of an organization are not available through MCP. Read them with the SDK, the CLI or the REST API.