{
  "name": "search_tokens",
  "description": "Search for tokens by name, type, or value across all tokensets and modes. If no workspace_id provided, will search across all workspaces.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "Optional workspace ID. If not provided, will search across all workspaces"
      },
      "query": {
        "type": "string",
        "description": "Search query (name, type, or value pattern)"
      },
      "type": {
        "type": "string",
        "description": "Optional token type filter (color, dimension, etc.)"
      }
    },
    "required": ["query"]
  }
}

{
  "query": "primary",
  "type_filter": null,
  "workspace_filter": "all workspaces",
  "results": [
    {
      "workspace": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Design System"
      },
      "tokenset": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "name": "Colors"
      },
      "tokens": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440030",
          "name": "color.primary",
          "type": "color",
          "value": "#007AFF",
          "description": "Primary brand color",
          "mode_id": "550e8400-e29b-41d4-a716-446655440020",
          "alias_to": null
        }
      ]
    }
  ],
  "total_found": 3,
  "usage": "Use these token IDs and mode IDs in other tools"
}

You: Find all tokens with "primary" in the name

Claude: Found 8 tokens with "primary":

**Light Mode**:
- colors.primary.500: #3b82f6
- colors.primary.600: #2563eb
- button.primary.background → colors.primary.500

**Dark Mode**:
- colors.primary.500: #60a5fa
- colors.primary.600: #3b82f6
- button.primary.background → colors.primary.500

You: Show me all color tokens

You: Find tokens related to "brand"

Claude: Found 5 tokens related to "brand":
- colors.primary.500: "Primary brand color"
- colors.secondary.500: "Secondary brand color"
...

You: Find all dimension tokens with "spacing" in the name in the Light mode