> ## 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_tokensets

> List all tokensets in a workspace

# list\_tokensets

Retrieves all tokensets belonging to a specific workspace.

## Tool Schema

```json theme={null}
{
  "name": "list_tokensets",
  "description": "List all tokensets in a workspace",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "The ID of the workspace"
      }
    },
    "required": ["workspace_id"]
  }
}
```

## Parameters

| Parameter      | Type   | Required | Description                                    |
| -------------- | ------ | -------- | ---------------------------------------------- |
| `workspace_id` | string | Yes      | The ID of the workspace to list tokensets from |

## Response

```json theme={null}
{
  "tokensets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Colors",
      "description": "Brand colors and color palette",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2025-01-15T11:00:00Z",
      "updated_at": "2025-01-15T11:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Typography",
      "description": "Font families, sizes, and weights",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2025-01-15T11:15:00Z",
      "updated_at": "2025-01-15T11:15:00Z"
    }
  ],
  "total": 2
}
```

## Example Usage in Claude

### List Tokensets in a Workspace

```
You: Show me all tokensets in workspace 550e8400-e29b-41d4-a716-446655440000

Claude: Here are the tokensets in your workspace:

**Colors** (ID: 550e8400-e29b-41d4-a716-446655440001)
- Brand colors and color palette

**Typography** (ID: 550e8400-e29b-41d4-a716-446655440002)
- Font families, sizes, and weights

**Spacing** (ID: 550e8400-e29b-41d4-a716-446655440003)
- Spacing and sizing tokens

Total: 3 tokensets
```

### Find Specific Tokenset

```
You: Do I have a tokenset called "Icons" in my design system workspace?

Claude: Let me check the tokensets in your design system workspace.

Looking through your tokensets... I don't see an "Icons" tokenset. You have:
- Colors
- Typography
- Spacing
- Components

Would you like me to create an "Icons" tokenset for you?
```

## Common Use Cases

### 1. Workspace Overview

```
You: What tokensets do I have in my main workspace?
```

### 2. Token Organization Check

```
You: Show me how my design tokens are organized
```

### 3. Find Tokenset by Name

```
You: Which workspace contains the "Brand Colors" tokenset?
```

## Notes

* Tokensets are organized within workspaces
* Each tokenset can contain multiple modes (like light/dark themes)
* Use the tokenset IDs for further operations like getting tokens or creating new tokens
* The response includes creation and update timestamps

## See Also

* [get\_tokenset](/mcp/tools/get-tokenset) - Get detailed information about a specific tokenset
* [create\_tokenset](/mcp/tools/create-tokenset) - Create a new tokenset
* [list\_workspaces](/mcp/tools/list-workspaces) - Find workspace IDs
* [list\_tokens\_by\_tokenset](/mcp/tools/list-tokens-by-tokenset) - View tokens in a tokenset