fenix-mcp 1.6.0__tar.gz → 1.8.0__tar.gz

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 1.6.0
+Version: 1.8.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "1.6.0"
+__version__ = "1.8.0"

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/fenix_mcp/application/tools/knowledge.py

@@ -78,6 +78,10 @@ class KnowledgeAction(str, Enum):
         "work_assign_to_me",
         "Assigns a work item to the current user.",
     )
+    WORK_BULK_CREATE = (
+        "work_bulk_create",
+        "Creates multiple work items atomically with hierarchy. Use temp_id as temporary identifier and parent_temp_id to reference parent in the same batch, or parent_key to reference an existing work item (e.g., TEMA-0056). Cannot use both parent_temp_id and parent_key on the same item. Example: [{temp_id:'epic-1', title:'My Epic', item_type:'epic', work_category:'backend'}, {temp_id:'task-1', parent_temp_id:'epic-1', title:'My Task', item_type:'task', work_category:'backend'}] or [{temp_id:'task-1', parent_key:'TEMA-0056', title:'My Task', item_type:'task', work_category:'backend'}]",
+    )
 
     # Boards
     BOARD_LIST = ("board_list", "Lists available boards with optional filters.")
@@ -260,6 +264,19 @@ class KnowledgeRequest(ToolRequest):
         default=None,
         description="List of work item IDs for batch operations (UUIDs).",
     )
+    work_items: Optional[List[Dict[str, Any]]] = Field(
+        default=None,
+        description=(
+            "List of work items for bulk create (max 50). Each item requires: "
+            "temp_id (your temporary ID like 'epic-1', 'task-a'), title, item_type, work_category. "
+            "Use parent_temp_id to set parent from same batch (e.g., parent_temp_id:'epic-1'), "
+            "OR parent_key to set parent from existing work item (e.g., parent_key:'TEMA-0056'). "
+            "Cannot use both parent_temp_id and parent_key on the same item. "
+            "Optional: description, priority (low/medium/high/critical), story_points, tags, due_date. "
+            'Example: [{"temp_id":"e1", "title":"Epic", "item_type":"epic", "work_category":"backend"}, '
+            '{"temp_id":"t1", "parent_temp_id":"e1", "title":"Task", "item_type":"task", "work_category":"backend"}]'
+        ),
+    )
 
     # Mode fields
     mode_id: Optional[UUIDStr] = Field(
@@ -579,6 +596,52 @@ class KnowledgeTool(Tool):
             count = len(payload.work_item_ids)
             return text(f"✅ {count} work item(s) assigned to sprint.")
 
+        if action is KnowledgeAction.WORK_BULK_CREATE:
+            if not payload.work_items:
+                return text(
+                    "❌ Provide work_items array. Each item requires: temp_id, title, item_type, work_category. "
+                    "Optional: parent_temp_id OR parent_key (not both), description, priority, story_points, tags, due_date."
+                )
+            if len(payload.work_items) > 50:
+                return text("❌ Maximum 50 items per bulk create.")
+
+            # Validate required fields
+            for i, item in enumerate(payload.work_items):
+                if not item.get("temp_id"):
+                    return text(f"❌ Item {i}: missing temp_id.")
+                if not item.get("title"):
+                    return text(f"❌ Item {i}: missing title.")
+                if not item.get("item_type"):
+                    return text(f"❌ Item {i}: missing item_type.")
+                if not item.get("work_category"):
+                    return text(f"❌ Item {i}: missing work_category.")
+                if item.get("parent_temp_id") and item.get("parent_key"):
+                    return text(
+                        f"❌ Item {i}: cannot have both parent_temp_id and parent_key. Use one or the other."
+                    )
+
+            items = await self._service.work_bulk_create({"items": payload.work_items})
+
+            # Format response with summary
+            type_counts: Dict[str, int] = {}
+            for item in items:
+                item_type = item.get("item_type", "unknown")
+                type_counts[item_type] = type_counts.get(item_type, 0) + 1
+
+            lines = [f"✅ **{len(items)} work items created**", ""]
+            for item in items:
+                key = item.get("key", "")
+                title = item.get("title", "Untitled")
+                item_type = item.get("item_type", "unknown")
+                lines.append(f"- [{key}] {title} ({item_type})")
+
+            lines.append("")
+            lines.append("**Summary by type:**")
+            for item_type, count in sorted(type_counts.items()):
+                lines.append(f"- {item_type}: {count}")
+
+            return text("\n".join(lines))
+
         return text(
             "❌ Unsupported work item action.\n\nChoose one of the values:\n"
             + "\n".join(

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/fenix_mcp/domain/knowledge.py

@@ -181,6 +181,11 @@ class KnowledgeService:
     async def work_bulk_update(self, payload: Dict[str, Any]) -> Dict[str, Any]:
         return await self._call(self.api.bulk_update_work_items, _strip_none(payload))
 
+    async def work_bulk_create(self, payload: Dict[str, Any]) -> List[Dict[str, Any]]:
+        return await self._call_list(
+            self.api.bulk_create_work_items, _strip_none(payload)
+        )
+
     # ------------------------------------------------------------------
     # Work boards
     # ------------------------------------------------------------------

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/fenix_mcp/infrastructure/fenix_api/client.py

@@ -573,6 +573,9 @@ class FenixApiClient:
     def bulk_update_work_items(self, payload: Mapping[str, Any]) -> Any:
         return self._request("PATCH", "/api/work-items/bulk-update", json=payload)
 
+    def bulk_create_work_items(self, payload: Mapping[str, Any]) -> Any:
+        return self._request("POST", "/api/work-items/bulk-create", json=payload)
+
     # ------------------------------------------------------------------
     # Knowledge: boards
     # ------------------------------------------------------------------

{fenix_mcp-1.6.0 → fenix_mcp-1.8.0}/fenix_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 1.6.0
+Version: 1.8.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10