Skip to main content

list_tokensets

Retrieves all tokensets belonging to a specific workspace.

Tool Schema

{
  "name": "list_tokensets",
  "description": "List all tokensets in a workspace",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "The ID of the workspace"
      }
    },
    "required": ["workspace_id"]
  }
}

Parameters

ParameterTypeRequiredDescription
workspace_idstringYesThe ID of the workspace to list tokensets from

Response

{
  "tokensets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Colors",
      "description": "Brand colors and color palette",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2025-01-15T11:00:00Z",
      "updated_at": "2025-01-15T11:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Typography",
      "description": "Font families, sizes, and weights",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2025-01-15T11:15:00Z",
      "updated_at": "2025-01-15T11:15:00Z"
    }
  ],
  "total": 2
}

Example Usage in Claude

List Tokensets in a Workspace

You: Show me all tokensets in workspace 550e8400-e29b-41d4-a716-446655440000

Claude: Here are the tokensets in your workspace:

**Colors** (ID: 550e8400-e29b-41d4-a716-446655440001)
- Brand colors and color palette

**Typography** (ID: 550e8400-e29b-41d4-a716-446655440002)
- Font families, sizes, and weights

**Spacing** (ID: 550e8400-e29b-41d4-a716-446655440003)
- Spacing and sizing tokens

Total: 3 tokensets

Find Specific Tokenset

You: Do I have a tokenset called "Icons" in my design system workspace?

Claude: Let me check the tokensets in your design system workspace.

Looking through your tokensets... I don't see an "Icons" tokenset. You have:
- Colors
- Typography
- Spacing
- Components

Would you like me to create an "Icons" tokenset for you?

Common Use Cases

1. Workspace Overview

You: What tokensets do I have in my main workspace?

2. Token Organization Check

You: Show me how my design tokens are organized

3. Find Tokenset by Name

You: Which workspace contains the "Brand Colors" tokenset?

Notes

  • Tokensets are organized within workspaces
  • Each tokenset can contain multiple modes (like light/dark themes)
  • Use the tokenset IDs for further operations like getting tokens or creating new tokens
  • The response includes creation and update timestamps

See Also