{
  "name": "get_tokens_by_mode",
  "description": "Get all tokens from a specific mode in a tokenset",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset"
      },
      "mode_name": {
        "type": "string",
        "description": "Optional mode name to search for (e.g., 'Light', 'Dark'). If not provided, uses the default mode"
      }
    },
    "required": ["tokenset_id"]
  }
}

{
  "mode": {
    "id": "550e8400-e29b-41d4-a716-446655440020",
    "name": "Light",
    "is_default": true
  },
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440030",
      "name": "color.primary",
      "type": "color",
      "value": "#007AFF",
      "description": "Primary brand color",
      "alias_to": null
    }
  ],
  "total": 1
}

You: Show me all tokens in the default mode of my Colors tokenset

Claude: I'll get the tokens from the default mode (Light) of your Colors tokenset.

**Light Mode (Default)**
- **color.primary**: #007AFF (Primary brand color)
- **color.secondary**: #5856D6 (Secondary brand color)
- **color.accent**: #FF9500 (Accent color)

Total: 3 tokens

You: Get all tokens from the Dark mode in my Colors tokenset

Claude: I'll find and get tokens from the Dark mode.

**Dark Mode**
- **color.primary**: #0A84FF (Dark mode primary)
- **color.secondary**: #5E5CE6 (Dark mode secondary)
- **color.background**: #000000 (Dark background)

Total: 3 tokens

You: Compare the color tokens between Light and Dark modes

Claude: Let me get tokens from both modes for comparison.

**Light Mode:**
- color.primary: #007AFF
- color.secondary: #5856D6
- color.background: #FFFFFF

**Dark Mode:**
- color.primary: #0A84FF (darker variant)
- color.secondary: #5E5CE6 (darker variant)
- color.background: #000000

The dark mode uses darker variants for better contrast.

You: Get tokens from the "Experimental" mode

Claude: I tried to find a mode named "Experimental" but it doesn't exist.

Available modes in this tokenset:
- Light (Default)
- Dark

Would you like me to get tokens from one of these modes instead?

You: Show me how colors differ between Light and Dark themes

You: What are the token values in the Dark mode?

You: Give me all the default tokens for this tokenset

You: Get the High Contrast mode tokens