Skip to main content

list_tokens

Retrieves all design tokens for a specific mode within a tokenset.

Tool Schema

{
  "name": "list_tokens",
  "description": "List all tokens in a tokenset mode",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "ID of the tokenset"
      },
      "mode_id": {
        "type": "string",
        "description": "ID of the mode"
      }
    },
    "required": ["tokenset_id", "mode_id"]
  }
}

Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesTokenset ID
mode_idstringYesMode ID

Response

{
  "mode": {
    "id": "mode-light",
    "name": "Light"
  },
  "tokens": [
    {
      "name": "colors.primary.500",
      "type": "color",
      "value": "#3b82f6",
      "description": "Primary brand color"
    }
  ],
  "total": 50
}

Example Usage

Basic Request

You: Show me all tokens in the Light mode of the Colors tokenset
Claude: **Light Mode - Colors Tokenset** (50 tokens)

**Colors**:
- colors.primary.500: #3b82f6 (Primary brand color)
- colors.primary.600: #2563eb
- colors.background.default: #ffffff
...

Filtered Request

You: Show me only the color tokens with "primary" in the name
Claude: [Filters tokens]
        
Found 8 primary color tokens:
- colors.primary.500: #3b82f6
- colors.primary.600: #2563eb
...

See Also