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

> List all modes in a tokenset

# list\_modes

Retrieves all modes (themes) available in a specific tokenset.

## Tool Schema

```json theme={null}
{
  "name": "list_modes",
  "description": "List all modes in a tokenset",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset"
      }
    },
    "required": ["tokenset_id"]
  }
}
```

## Parameters

| Parameter     | Type   | Required | Description                               |
| ------------- | ------ | -------- | ----------------------------------------- |
| `tokenset_id` | string | Yes      | The ID of the tokenset to list modes from |

## Response

```json theme={null}
{
  "modes": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "name": "Light",
      "is_default": true,
      "tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
      "created_at": "2025-01-15T12:00:00Z",
      "updated_at": "2025-01-15T12:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440021",
      "name": "Dark",
      "is_default": false,
      "tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
      "created_at": "2025-01-15T12:15:00Z",
      "updated_at": "2025-01-15T12:15:00Z"
    }
  ],
  "total": 2
}
```

## Example Usage in Claude

### List Modes in a Tokenset

```
You: Show me all modes in tokenset 550e8400-e29b-41d4-a716-446655440010

Claude: Here are the modes in your tokenset:

**Light** (ID: 550e8400-e29b-41d4-a716-446655440020) - Default ✓
- Standard light theme colors

**Dark** (ID: 550e8400-e29b-41d4-a716-446655440021)
- Dark theme variant

**High Contrast** (ID: 550e8400-e29b-41d4-a716-446655440022)
- High contrast accessibility mode

Total: 3 modes
```

### Check Default Mode

```
You: Which mode is the default in my color tokenset?

Claude: Let me check the modes in your color tokenset.

The default mode is:
**Light** (ID: 550e8400-e29b-41d4-a716-446655440020) - Default ✓
```

## Common Use Cases

### 1. Theme Overview

```
You: What themes do I have available in my design system?
```

### 2. Mode Management

```
You: Show me all the modes in my component tokenset
```

### 3. Default Mode Check

```
You: Which is the default mode for my typography tokens?
```

## Notes

* Every tokenset has at least one mode (usually "Light" as default)
* One mode per tokenset is marked as `is_default: true`
* Modes contain different values for the same tokens (e.g., light vs dark colors)
* Use mode IDs when working with tokens in specific modes
* The response includes creation and update timestamps

## See Also

* [get\_mode](/mcp/tools/get-mode) - Get detailed information about a specific mode
* [create\_mode](/mcp/tools/create-mode) - Create a new mode
* [list\_tokens\_by\_mode](/mcp/tools/list-tokens-by-mode) - View tokens in a specific mode
* [get\_tokens\_by\_mode](/mcp/tools/get-tokens-by-mode) - Get tokens by mode name