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

# list_workspaces

> List all workspaces in your Tokencraft account

# list\_workspaces

Retrieves all workspaces belonging to the authenticated user.

## Tool Schema

```json theme={null}
{
  "name": "list_workspaces",
  "description": "List all Tokencraft workspaces",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}
```

## Parameters

This tool takes no parameters.

## Response

```json theme={null}
{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Design System",
      "description": "Main product design system",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 1
}
```

## Example Usage in Claude

### Simple Request

```
You: List my workspaces
```

```
Claude: You have 3 workspaces:

1. **Design System** (Created Jan 15, 2025)
   - Main product design system
   
2. **Mobile App** (Created Jan 10, 2025)
   - Mobile application tokens
   
3. **Marketing Site** (Created Jan 5, 2025)
   - Marketing website design tokens
```

### With Follow-up

```
You: Show me my workspaces and tell me which one has the most tokensets

Claude: [Uses list_workspaces, then gets tokensets for each]
        
        Your workspaces:
        1. Design System - 5 tokensets
        2. Mobile App - 3 tokensets  
        3. Marketing Site - 2 tokensets
        
        The "Design System" workspace has the most tokensets (5).
```

## Common Use Cases

### 1. Initial Discovery

```
You: What workspaces do I have?
```

### 2. Find Specific Workspace

```
You: Do I have a workspace called "Mobile App"?
```

### 3. Workspace Overview

```
You: Give me an overview of all my design systems
```

## See Also

* [get\_workspace](/mcp/tools/get-workspace) - Get details of a specific workspace
* [get\_tokenset](/mcp/tools/get-tokenset) - Get tokensets in a workspace