fix: add tags filter to search_workshop_collections

Brings search_workshop_collections to feature parity with
search_workshop_items - both now support:
- app_id (required)
- search_query (text search)
- tags (array of Workshop tags to filter by)
- sort_by (popular/trend/recent/rating)
- max_results

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: CodeKeanu

src/steam_mcp/endpoints/steam_workshop.py

@@ -425,6 +425,12 @@ async def get_workshop_item_details(
                 "description": "Text search filter (optional)",
                 "required": False,
             },
+            "tags": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Filter by Workshop tags (e.g., 'Maps', 'Weapons', 'Characters')",
+                "required": False,
+            },
             "sort_by": {
                 "type": "string",
                 "description": "Sort order: 'popular' (most voted), 'trend' (trending), 'recent' (newest), 'rating' (highest rated)",
@@ -446,6 +452,7 @@ async def search_workshop_collections(
         self,
         app_id: int,
         search_query: str = "",
+        tags: list[str] | None = None,
         sort_by: str = "popular",
         max_results: int = 10,
         format: str = "text",
@@ -467,6 +474,10 @@ async def search_workshop_collections(
         if search_query:
             params["search_text"] = search_query
 
+        if tags:
+            for i, tag in enumerate(tags):
+                params[f"requiredtags[{i}]"] = tag
+
         try:
             result = await self.client.get(
                 "IPublishedFileService",
@@ -488,7 +499,9 @@ async def search_workshop_collections(
             msg = f"No Workshop collections found for app {app_id}."
             if search_query:
                 msg += f" Search query: '{search_query}'"
-            msg += "\n\nThis game may not have Workshop collections, or no collections match your search."
+            if tags:
+                msg += f" Tags: {', '.join(tags)}"
+            msg += "\n\nThis game may not have Workshop collections, or no collections match your filters."
             if format == "json":
                 return json.dumps({"error": msg})
             return msg
@@ -531,6 +544,8 @@ async def search_workshop_collections(
 
         if search_query:
             output.append(f"Search: '{search_query}'")
+        if tags:
+            output.append(f"Tags: {', '.join(tags)}")
         output.append("")
 
         for coll in collections:

tests/test_steam_workshop.py

@@ -244,6 +244,22 @@ async def test_search_collections_with_query(self, workshop_service, mock_client
         assert call_args[1]["params"]["search_text"] == "weapon skins"
         assert call_args[1]["params"]["filetype"] == 2  # Collections only
 
+    @pytest.mark.asyncio
+    async def test_search_collections_with_tags(self, workshop_service, mock_client):
+        """Should pass tags to API."""
+        mock_client.get.return_value = {
+            "response": {"total": 0, "publishedfiledetails": []}
+        }
+
+        await workshop_service.search_workshop_collections(
+            app_id=730, tags=["Maps", "Competitive"]
+        )
+
+        call_args = mock_client.get.call_args
+        assert call_args[1]["params"]["requiredtags[0]"] == "Maps"
+        assert call_args[1]["params"]["requiredtags[1]"] == "Competitive"
+        assert call_args[1]["params"]["filetype"] == 2
+
     @pytest.mark.asyncio
     async def test_search_collections_empty_results(self, workshop_service, mock_client):
         """Should handle no results gracefully."""