Skip to main content

​
list_modes

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

​
Tool Schema

{
  "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

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset to list modes from

​
Response

{
  "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