Skip to main content

​
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

ParameterTypeRequiredDescription
workspace_idstringNoOptional 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

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

​
See Also