Skip to main content

create_tokenset

Creates a new tokenset within a workspace to organize related design tokens.

Tool Schema

{
  "name": "create_tokenset",
  "description": "Create a new tokenset in a workspace",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "The ID of the workspace"
      },
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "The name of the tokenset"
      },
      "description": {
        "type": "string",
        "description": "Optional description of the tokenset"
      }
    },
    "required": ["workspace_id", "name"]
  }
}

Parameters

ParameterTypeRequiredDescription
workspace_idstringYesThe ID of the workspace to create the tokenset in
namestringYesThe name of the tokenset (1-255 characters)
descriptionstringNoOptional description of the tokenset

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "name": "Component Styles",
  "description": "Design tokens for UI components",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2025-01-20T14:30:00Z",
  "updated_at": "2025-01-20T14:30:00Z"
}

Example Usage in Claude

Create a Basic Tokenset

You: Create a new tokenset called "Colors" in workspace 550e8400-e29b-41d4-a716-446655440000

Claude: I'll create a new tokenset called "Colors" in your workspace.

Tokenset created successfully:
- **Name**: Colors
- **ID**: 550e8400-e29b-41d4-a716-446655440010
- **Description**: (none)
- **Workspace**: 550e8400-e29b-41d4-a716-446655440000

Create Tokenset with Description

You: Create a tokenset called "Typography" with description "Font families, sizes, and spacing" in my design system workspace

Claude: I'll create the typography tokenset with your description.

Tokenset created successfully:
- **Name**: Typography
- **ID**: 550e8400-e29b-41d4-a716-446655440011
- **Description**: Font families, sizes, and spacing
- **Workspace**: Design System

Common Use Cases

1. Token Organization

You: Create separate tokensets for colors, typography, spacing, and components

2. Project Structure

You: Set up tokensets for foundation, component, and utility tokens

3. Thematic Organization

You: Create tokensets for light theme, dark theme, and high contrast mode

Notes

  • Tokensets belong to a specific workspace
  • Each tokenset automatically gets a default “Light” mode when created
  • You can create multiple tokensets within one workspace
  • Tokenset names should be unique within a workspace
  • Use tokensets to logically group related design tokens

See Also