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

> List all tokens for a specific mode

# list\_tokens\_by\_mode

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

## Tool Schema

```json theme={null}
{
  "name": "list_tokens_by_mode",
  "description": "List all tokens for a specific mode",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset"
      },
      "mode_id": {
        "type": "string",
        "description": "The ID of the mode"
      }
    },
    "required": ["tokenset_id", "mode_id"]
  }
}
```

## Parameters

| Parameter     | Type   | Required | Description |
| ------------- | ------ | -------- | ----------- |
| `tokenset_id` | string | Yes      | Tokenset ID |
| `mode_id`     | string | Yes      | Mode ID     |

## Response

```json theme={null}
{
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440030",
      "name": "color.primary",
      "type": "color",
      "value": "#007AFF",
      "description": "Primary brand color",
      "alias_to": null,
      "mode_id": "550e8400-e29b-41d4-a716-446655440020",
      "tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
      "created_at": "2025-01-15T13:00:00Z",
      "updated_at": "2025-01-15T13:00:00Z"
    }
  ],
  "total": 1
}
```

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

* [search\_tokens](/mcp/tools/search-tokens)
* [export\_tokens](/mcp/tools/export-tokens)