feat: add reorder_status_page_layout MCP tool

pyproject.toml

@@ -19,10 +19,10 @@ classifiers = [
 ]
 
 dependencies = [
-    # Floor bumped to 0.1.3 because mcp-server depends on the strict error
-    # taxonomy (DevhelmValidationError / DevhelmApiError / DevhelmTransportError)
-    # and `extra='forbid'` response validation introduced in that release.
-    "devhelm>=0.2.0",
+    # Floor bumped to 0.2.1 for `StatusPages.reorder_layout` and the
+    # `Incidents.delete` removal (which the `reorder_status_page_layout`
+    # tool below depends on, and which the parity check requires).
+    "devhelm>=0.2.1",
     "fastmcp>=2.0.0",
 ]
 
@@ -64,4 +64,4 @@ dev = [
     "pytest>=8.0",
     "ruff>=0.8",
     "twine>=5.0",
-]
+]

src/devhelm_mcp/tools/status_pages.py

@@ -13,6 +13,7 @@
     CreateStatusPageIncidentUpdateRequest,
     CreateStatusPageRequest,
     ReorderComponentsRequest,
+    ReorderPageLayoutRequest,
     UpdateStatusPageComponentGroupRequest,
     UpdateStatusPageComponentRequest,
     UpdateStatusPageIncidentRequest,
@@ -85,6 +86,29 @@ def delete_status_page(api_token: str, page_id: str) -> str:
         except DevhelmError as e:
             return format_error(e)
 
+    @mcp.tool()
+    def reorder_status_page_layout(
+        api_token: str, page_id: str, body: ReorderPageLayoutRequest
+    ) -> str:
+        """Batch-reorder a status page's full layout.
+
+        Required: sections — top-level layout in their new order, where each
+        entry is either {kind:"component", componentId} or
+        {kind:"group", groupId}. Use ``groupOrders`` (optional) to also
+        reorder components within specific groups; only include groups whose
+        internal order changed. The full top-level set must be provided —
+        partial reorders are rejected by the API.
+
+        Use this for "drag-and-drop" layout edits that touch both groups and
+        ungrouped components. To reorder components within a single group
+        only, prefer ``reorder_status_page_components``.
+        """
+        try:
+            _sp(api_token).reorder_layout(page_id, as_payload(body))
+            return "Status page layout reordered successfully."
+        except DevhelmError as e:
+            return format_error(e)
+
     # ── Components ────────────────────────────────────────────────────────
 
     @mcp.tool()

tests/test_tools.py

@@ -87,6 +87,7 @@
     "create_status_page",
     "update_status_page",
     "delete_status_page",
+    "reorder_status_page_layout",
     "list_status_page_components",
     "create_status_page_component",
     "update_status_page_component",
@@ -157,6 +158,7 @@ def test_tool_count(self, registered_tools: RegisteredTools) -> None:
     "create_status_page",
     "update_status_page",
     "delete_status_page",
+    "reorder_status_page_layout",
 ]
 
 STATUS_PAGE_COMPONENT_TOOLS = [