list_resources

Provides a hierarchical overview of all workspaces, tokensets, and modes with their IDs. This is the best tool to start with when exploring your design tokens, as it helps you understand the structure and find the IDs needed for other operations.

Tool Schema

{
  "name": "list_resources",
  "description": "List all resources (workspaces, tokensets, modes) with their IDs for easy reference",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "Optional workspace ID to get tokensets and modes"
      }
    }
  }
}

Parameters

Parameter	Type	Required	Description
`workspace_id`	string	No	Optional workspace ID to show only that workspace’s tokensets and modes

Response

When called without workspace_id:

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Design System",
      "description": "Main product design system"
    }
  ],
  "usage": "Use these IDs in other tools. Call with workspace_id to get full hierarchy."
}

When called with workspace_id:

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Design System",
      "description": "Main product design system"
    }
  ],
  "tokensets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "name": "Colors",
      "description": "Brand colors and color palette"
    }
  ],
  "modes": {
    "550e8400-e29b-41d4-a716-446655440010": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440020",
        "name": "Light",
        "is_default": true
      }
    ]
  },
  "usage": "Use these IDs in other tools. Call with workspace_id to get full hierarchy."
}

Example Usage in Claude

Get All Workspaces

You: Show me all my workspaces and their IDs

Claude: Here are all your workspaces:

**Design System** (ID: 550e8400-e29b-41d4-a716-446655440000)
- Main product design system

**Mobile App** (ID: 550e8400-e29b-41d4-a716-446655440001)
- Mobile application tokens

**Marketing Site** (ID: 550e8400-e29b-41d4-a716-446655440002)
- Marketing website design tokens

Total: 3 workspaces

Explore Workspace Structure

You: Show me the complete structure of the Design System workspace

Claude: Let me explore the Design System workspace structure.

**Workspace: Design System**
├── **Colors** (ID: 550e8400-e29b-41d4-a716-446655440010)
│   ├── Light (ID: 550e8400-e29b-41d4-a716-446655440020) - Default ✓
│   └── Dark (ID: 550e8400-e29b-41d4-a716-446655440021)
├── **Typography** (ID: 550e8400-e29b-41d4-a716-446655440011)
│   └── Light (ID: 550e8400-e29b-41d4-a716-446655440022) - Default ✓
└── **Spacing** (ID: 550e8400-e29b-41d4-a716-446655440012)
    └── Light (ID: 550e8400-e29b-41d4-a716-446655440023) - Default ✓

This workspace has 3 tokensets with 5 total modes.

Quick ID Reference

You: I need to find the ID for my Colors tokenset

Claude: Let me find your Colors tokenset.

Found in workspace "Design System":
**Colors** (ID: 550e8400-e29b-41d4-a716-446655440010)
- Brand colors and color palette

You can now use this ID in other tools.

Common Use Cases

1. Initial Exploration

You: What workspaces do I have and what's in them?

2. Finding IDs

You: I need the ID for my Colors tokenset in the Design System workspace

3. Understanding Structure

You: Show me the hierarchy of my design tokens

4. Planning Operations

You: Let me see what I can work with before making changes

Two Usage Patterns

1. Overview Mode (No workspace_id)

Shows all workspaces
Quick way to see what you have access to
Use this when you need to choose a workspace

2. Detailed Mode (With workspace_id)

Shows complete hierarchy for one workspace
Includes all tokensets and their modes
Use this when you need specific IDs for operations

Notes

This tool is your best starting point for any token operations
Always call this first if you’re unsure about IDs or structure
The response includes helpful usage instructions
IDs are what you need for all other tools

Tips

Start Here: Always use this tool first when exploring
Copy IDs: Note down the IDs you need for other operations
Understand Hierarchy: Workspaces → Tokensets → Modes → Tokens
Default Modes: Look for is_default: true flags

​list_resources

​Tool Schema

​Parameters

​Response

​Example Usage in Claude

​Get All Workspaces

​Explore Workspace Structure

​Quick ID Reference

​Common Use Cases

​1. Initial Exploration

​2. Finding IDs

​3. Understanding Structure

​4. Planning Operations

​Two Usage Patterns

​1. Overview Mode (No workspace_id)

​2. Detailed Mode (With workspace_id)

​Notes

​Tips

​See Also