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

# list_resources

> List all resources with their IDs for easy reference

# 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

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

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

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

* [list\_workspaces](/mcp/tools/list-workspaces) - Simple workspace list
* [list\_tokensets](/mcp/tools/list-tokensets) - Tokensets in a workspace
* [list\_modes](/mcp/tools/list-modes) - Modes in a tokenset
* [get\_tokens\_by\_mode](/mcp/tools/get-tokens-by-mode) - Get tokens by mode name