Skip to main content
Version: Next

Workspace MCP API

Tools for discovering workspaces (a.k.a. teams) accessible by the token.

Errors and retries

All MCP tools return a uniform ToolResponse envelope (ok, result, issues[]). When ok: false, inspect issues and apply retries/backoff (respect retry_after_ms for 429 and back off on 5xx/transient errors). See Errors and Retries (MCP) for details.

Tools​

workspace.list​

Lists all workspaces (teams) the current token can access. This is a read-only discovery call that helps you obtain team_id values for downstream operations like space.list. The tool returns a ToolResponse envelope with items[] where each item includes { team_id, name }.

  • Parameters: none
{}
{
  "ok": true, // Tool succeeded
  "result": {
    "items": [
      {
        "team_id": "team_1", // Workspace (team) ID
        "name": "Engineering" // Workspace name
      }
    ]
  },
  "issues": [] // Optional warnings/issues collected during execution
}
  • Errors
    • AUTH_ERROR (401), FORBIDDEN (403)
    • RATE_LIMIT (429)
    • UPSTREAM_ERROR (5xx/timeout)