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

# create_tokenset

> Create a new tokenset in a workspace

# create\_tokenset

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

## Tool Schema

```json theme={null}
{
  "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

| Parameter      | Type   | Required | Description                                       |
| -------------- | ------ | -------- | ------------------------------------------------- |
| `workspace_id` | string | Yes      | The ID of the workspace to create the tokenset in |
| `name`         | string | Yes      | The name of the tokenset (1-255 characters)       |
| `description`  | string | No       | Optional description of the tokenset              |

## Response

```json theme={null}
{
  "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

* [list\_tokensets](/mcp/tools/list-tokensets) - View all tokensets in a workspace
* [get\_tokenset](/mcp/tools/get-tokenset) - Get tokenset details
* [create\_mode](/mcp/tools/create-mode) - Add modes to a tokenset
* [create\_token](/mcp/tools/create-token) - Add tokens to a tokenset