Skip to main content

list_workspaces

Retrieves all workspaces belonging to the authenticated user.

Tool Schema

{
  "name": "list_workspaces",
  "description": "List all Tokencraft workspaces",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

Parameters

This tool takes no parameters.

Response

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Design System",
      "description": "Main product design system",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 1
}

Example Usage in Claude

Simple Request

You: List my workspaces
Claude: You have 3 workspaces:

1. **Design System** (Created Jan 15, 2025)
   - Main product design system
   
2. **Mobile App** (Created Jan 10, 2025)
   - Mobile application tokens
   
3. **Marketing Site** (Created Jan 5, 2025)
   - Marketing website design tokens

With Follow-up

You: Show me my workspaces and tell me which one has the most tokensets

Claude: [Uses list_workspaces, then gets tokensets for each]
        
        Your workspaces:
        1. Design System - 5 tokensets
        2. Mobile App - 3 tokensets  
        3. Marketing Site - 2 tokensets
        
        The "Design System" workspace has the most tokensets (5).

Common Use Cases

1. Initial Discovery

You: What workspaces do I have?

2. Find Specific Workspace

You: Do I have a workspace called "Mobile App"?

3. Workspace Overview

You: Give me an overview of all my design systems

See Also