rootly-mcp-server 2.2.17__tar.gz → 2.2.19__tar.gz

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to the Rootly MCP Server will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.19] - Released 2026-04-17
+
+### Features
+
+- **Scoped Incident Creation Tool**: Added a custom `createIncident` tool so agents can create incidents directly from MCP without exposing the full raw `/incidents` OpenAPI surface
+
+### Documentation
+
+- **Custom Tool List Updated**: Added `createIncident` to the README custom tool section with its scoped workflow-oriented behavior
+
+## [2.2.18] - Released 2026-04-15
+
+### Features
+
+- **Workflow Task Tools**: Added complete workflow task management tools to enable creation, listing, retrieval, and updating of workflow actions/tasks
+- **Enhanced Workflow Functionality**: Users can now build complete functional workflows instead of just workflow shells
+
+### New Tools
+
+- `createWorkflowTask` - Create new workflow actions (POST `/v1/workflows/{workflow_id}/workflow_tasks`)
+- `listWorkflowTasks` - List all actions in a workflow (GET `/v1/workflows/{workflow_id}/workflow_tasks`)  
+- `getWorkflowTask` - Retrieve specific workflow action details (GET `/v1/workflow_tasks/{id}`)
+- `updateWorkflowTask` - Modify existing workflow actions (PUT `/v1/workflow_tasks/{id}`)
+
+### Documentation
+
+- **Tool Count Updated**: Increased from 105 to 109 tools reflecting new workflow task capabilities
+- **Tool List Updated**: Added workflow task tools to OpenAPI-generated tools section
+- **Badge Cleanup**: Removed broken Cursor install badge
+
+### Security
+
+- **Delete Operations**: `deleteWorkflowTask` remains intentionally excluded following security policy for destructive operations
+
 ## [2.2.17] - Released 2026-04-14
 
 ### Fixes

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rootly-mcp-server
-Version: 2.2.17
+Version: 2.2.19
 Summary: Secure Model Context Protocol server for Rootly APIs with AI SRE capabilities, comprehensive error handling, and input validation
 Project-URL: Homepage, https://github.com/Rootly-AI-Labs/Rootly-MCP-server
 Project-URL: Issues, https://github.com/Rootly-AI-Labs/Rootly-MCP-server/issues
@@ -46,7 +46,6 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://badge.fury.io/py/rootly-mcp-server.svg)](https://pypi.org/project/rootly-mcp-server/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/rootly-mcp-server)](https://pypi.org/project/rootly-mcp-server/)
 [![Python Version](https://img.shields.io/pypi/pyversions/rootly-mcp-server.svg)](https://pypi.org/project/rootly-mcp-server/)
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=rootly&config=eyJ1cmwiOiJodHRwczovL21jcC5yb290bHkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciA8WU9VUl9ST09UTFlfQVBJX1RPS0VOPiJ9fQo=)
 
 An MCP server for the [Rootly API](https://docs.rootly.com/api-reference/overview) for Cursor, Windsurf, Claude, and other MCP clients.
 
@@ -409,13 +408,14 @@ docker run -p 8000:8000 \
 
 ## Supported Tools
 
-The default server configuration exposes **105 tools**.
+The default server configuration exposes **110 tools**.
 
 ### Custom Agentic Tools
 
 - `check_oncall_health_risk`
 - `check_responder_availability`
 - `collect_incidents`
+- `createIncident` - create a new incident with a scoped set of fields for agent workflows
 - `create_override_recommendation`
 - `find_related_incidents`
 - `getIncident` - retrieve a single incident for direct verification, including PIR-related fields
@@ -457,6 +457,7 @@ createService
 createSeverity
 createTeam
 createWorkflow
+createWorkflowTask
 deleteEscalationLevel
 deleteEscalationPath
 deleteEscalationPolicy
@@ -482,6 +483,7 @@ getSeverity
 getTeam
 getUser
 getWorkflow
+getWorkflowTask
 listAlerts
 listEnvironments
 listEscalationLevels
@@ -506,6 +508,7 @@ listShifts
 listTeams
 listUsers
 listWorkflows
+listWorkflowTasks
 updateAlert
 updateEnvironment
 updateEscalationLevel
@@ -524,6 +527,7 @@ updateSeverity
 updateTeam
 updateUser
 updateWorkflow
+updateWorkflowTask
 ```
 
 Delete operations are intentionally scoped to screenshot coverage paths:

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/README.md

@@ -4,7 +4,6 @@
 [![PyPI version](https://badge.fury.io/py/rootly-mcp-server.svg)](https://pypi.org/project/rootly-mcp-server/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/rootly-mcp-server)](https://pypi.org/project/rootly-mcp-server/)
 [![Python Version](https://img.shields.io/pypi/pyversions/rootly-mcp-server.svg)](https://pypi.org/project/rootly-mcp-server/)
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=rootly&config=eyJ1cmwiOiJodHRwczovL21jcC5yb290bHkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciA8WU9VUl9ST09UTFlfQVBJX1RPS0VOPiJ9fQo=)
 
 An MCP server for the [Rootly API](https://docs.rootly.com/api-reference/overview) for Cursor, Windsurf, Claude, and other MCP clients.
 
@@ -367,13 +366,14 @@ docker run -p 8000:8000 \
 
 ## Supported Tools
 
-The default server configuration exposes **105 tools**.
+The default server configuration exposes **110 tools**.
 
 ### Custom Agentic Tools
 
 - `check_oncall_health_risk`
 - `check_responder_availability`
 - `collect_incidents`
+- `createIncident` - create a new incident with a scoped set of fields for agent workflows
 - `create_override_recommendation`
 - `find_related_incidents`
 - `getIncident` - retrieve a single incident for direct verification, including PIR-related fields
@@ -415,6 +415,7 @@ createService
 createSeverity
 createTeam
 createWorkflow
+createWorkflowTask
 deleteEscalationLevel
 deleteEscalationPath
 deleteEscalationPolicy
@@ -440,6 +441,7 @@ getSeverity
 getTeam
 getUser
 getWorkflow
+getWorkflowTask
 listAlerts
 listEnvironments
 listEscalationLevels
@@ -464,6 +466,7 @@ listShifts
 listTeams
 listUsers
 listWorkflows
+listWorkflowTasks
 updateAlert
 updateEnvironment
 updateEscalationLevel
@@ -482,6 +485,7 @@ updateSeverity
 updateTeam
 updateUser
 updateWorkflow
+updateWorkflowTask
 ```
 
 Delete operations are intentionally scoped to screenshot coverage paths:

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rootly-mcp-server"
-version = "2.2.17"
+version = "2.2.19"
 description = "Secure Model Context Protocol server for Rootly APIs with AI SRE capabilities, comprehensive error handling, and input validation"
 readme = "README.md"
 requires-python = ">=3.12"

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/src/rootly_mcp_server/server_defaults.py

@@ -67,6 +67,8 @@ DEFAULT_ALLOWED_PATHS = [
     # Workflows
     "/workflows",
     "/workflows/{workflow_id}",
+    "/workflows/{workflow_id}/workflow_tasks",
+    "/workflow_tasks/{id}",
     # Workflow runs
     "/workflow_runs",
     "/workflow_runs/{workflow_run_id}",

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/src/rootly_mcp_server/tools/incidents.py

@@ -29,6 +29,14 @@ def _split_csv_values(value: str) -> list[str]:
     return [part.strip() for part in value.split(",") if part.strip()]
 
 
+def _normalize_optional_text(value: str | None) -> str | None:
+    """Normalize optional text inputs by trimming whitespace and empty values."""
+    if value is None:
+        return None
+    normalized = value.strip()
+    return normalized or None
+
+
 def _extract_incident_severity(severity_value: Any) -> str | None:
     """Normalize severity values from Rootly API responses into a compact string."""
     if severity_value is None:
@@ -641,6 +649,100 @@ def register_incident_tools(
                 ),
             )
 
+    @mcp.tool(name="createIncident")
+    async def create_incident(
+        title: Annotated[
+            str | None,
+            Field(description="Incident title. If omitted, Rootly may autogenerate one."),
+        ] = None,
+        summary: Annotated[
+            str | None,
+            Field(description="Incident summary or short description."),
+        ] = None,
+        severity_id: Annotated[
+            str | None,
+            Field(description="Optional severity ID to attach to the incident."),
+        ] = None,
+        service_ids: Annotated[
+            str | None,
+            Field(description="Comma-separated service IDs to attach to the incident."),
+        ] = None,
+        team_ids: Annotated[
+            str | None,
+            Field(description="Comma-separated team IDs to attach to the incident."),
+        ] = None,
+        environment_ids: Annotated[
+            str | None,
+            Field(description="Comma-separated environment IDs to attach to the incident."),
+        ] = None,
+        incident_type_ids: Annotated[
+            str | None,
+            Field(description="Comma-separated incident type IDs to attach to the incident."),
+        ] = None,
+    ) -> JsonDict:
+        """Create an incident with a scoped set of fields for agent-driven workflows."""
+        normalized_title = _normalize_optional_text(title)
+        normalized_summary = _normalize_optional_text(summary)
+
+        if normalized_title is None and normalized_summary is None:
+            return cast(
+                JsonDict,
+                mcp_error.tool_error(
+                    "Must provide at least one of title or summary",
+                    "validation_error",
+                ),
+            )
+
+        attributes: dict[str, Any] = {}
+
+        if normalized_title is not None:
+            attributes["title"] = normalized_title
+        if normalized_summary is not None:
+            attributes["summary"] = normalized_summary
+
+        normalized_severity_id = _normalize_optional_text(severity_id)
+        if normalized_severity_id is not None:
+            attributes["severity_id"] = normalized_severity_id
+
+        csv_attribute_map = (
+            ("service_ids", service_ids),
+            ("group_ids", team_ids),
+            ("environment_ids", environment_ids),
+            ("incident_type_ids", incident_type_ids),
+        )
+        for attribute_name, raw_value in csv_attribute_map:
+            if raw_value is None:
+                continue
+            values = _split_csv_values(raw_value)
+            if values:
+                attributes[attribute_name] = values
+
+        payload = {
+            "data": {
+                "type": "incidents",
+                "attributes": attributes,
+            }
+        }
+
+        try:
+            response = await make_authenticated_request("POST", "/v1/incidents", json=payload)
+            response.raise_for_status()
+
+            response_data = response.json()
+            if isinstance(response_data.get("data"), dict):
+                stripped = strip_heavy_nested_data({"data": [response_data["data"]]})
+                response_data["data"] = stripped["data"][0]
+            return cast(JsonDict, response_data)
+        except Exception as e:
+            error_type, error_message = mcp_error.categorize_error(e)
+            return cast(
+                JsonDict,
+                mcp_error.tool_error(
+                    f"Failed to create incident: {error_message}",
+                    error_type,
+                ),
+            )
+
     @mcp.tool(name="updateIncident")
     async def update_incident(
         incident_id: Annotated[str, Field(description="Incident ID to update")],

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/tests/unit/test_server.py

@@ -215,6 +215,19 @@ class TestBundledIncidentFormFieldSelectionTools:
 
         assert "deleteIncidentFormFieldSelection" not in tool_names
 
+    async def test_workflow_task_tools_are_available_without_delete(self, mock_environment_token):
+        server = create_rootly_mcp_server(hosted=False)
+
+        tools = await server.list_tools()
+        tool_names = {tool.name for tool in tools}
+
+        assert "createWorkflowTask" in tool_names
+        assert "listWorkflowTasks" in tool_names
+        assert "getWorkflowTask" in tool_names
+        assert "updateWorkflowTask" in tool_names
+
+        assert "deleteWorkflowTask" not in tool_names
+
 
 @pytest.mark.unit
 class TestAuthenticatedHTTPXClient:

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/tests/unit/test_server_defaults_module.py

@@ -11,6 +11,8 @@ class TestServerDefaultsModule:
         assert "/incidents/{incident_id}/alerts" in DEFAULT_ALLOWED_PATHS
         assert "/incidents/{incident_id}/form_field_selections" in DEFAULT_ALLOWED_PATHS
         assert "/incident_form_field_selections/{id}" in DEFAULT_ALLOWED_PATHS
+        assert "/workflows/{workflow_id}/workflow_tasks" in DEFAULT_ALLOWED_PATHS
+        assert "/workflow_tasks/{id}" in DEFAULT_ALLOWED_PATHS
         assert "/shifts" in DEFAULT_ALLOWED_PATHS
         assert "/on_call_roles" in DEFAULT_ALLOWED_PATHS
 

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/tests/unit/test_tools.py

@@ -143,9 +143,74 @@ class TestScopedIncidentUpdateTool:
     async def test_update_incident_tool_is_registered_with_customer_facing_name(self):
         tools, _ = self._register_tools()
 
+        assert "createIncident" in tools
         assert "updateIncident" in tools
         assert "getIncident" in tools
 
+    @pytest.mark.asyncio
+    async def test_create_incident_sends_only_allowed_fields(self):
+        tools, request = self._register_tools()
+        response = Mock()
+        response.raise_for_status.return_value = None
+        response.json.return_value = {
+            "data": {
+                "id": "inc-123",
+                "type": "incidents",
+                "attributes": {
+                    "title": "Database latency spike",
+                    "summary": "Primary API requests timing out",
+                    "severity_id": "sev-1",
+                    "service_ids": ["svc-1", "svc-2"],
+                    "group_ids": ["team-1", "team-2"],
+                    "environment_ids": ["env-1"],
+                    "incident_type_ids": ["type-1"],
+                },
+            }
+        }
+        request.return_value = response
+
+        result = await tools["createIncident"](
+            title="  Database latency spike  ",
+            summary=" Primary API requests timing out ",
+            severity_id=" sev-1 ",
+            service_ids="svc-1, svc-2",
+            team_ids="team-1, team-2",
+            environment_ids="env-1",
+            incident_type_ids="type-1",
+        )
+
+        request.assert_awaited_once_with(
+            "POST",
+            "/v1/incidents",
+            json={
+                "data": {
+                    "type": "incidents",
+                    "attributes": {
+                        "title": "Database latency spike",
+                        "summary": "Primary API requests timing out",
+                        "severity_id": "sev-1",
+                        "service_ids": ["svc-1", "svc-2"],
+                        "group_ids": ["team-1", "team-2"],
+                        "environment_ids": ["env-1"],
+                        "incident_type_ids": ["type-1"],
+                    },
+                }
+            },
+        )
+        assert result["data"]["id"] == "inc-123"
+        assert result["data"]["attributes"]["title"] == "Database latency spike"
+
+    @pytest.mark.asyncio
+    async def test_create_incident_requires_title_or_summary(self):
+        tools, request = self._register_tools()
+
+        result = await tools["createIncident"](title="   ", summary=None)
+
+        request.assert_not_called()
+        assert result["error"] is True
+        assert result["error_type"] == "validation_error"
+        assert "Must provide at least one of title or summary" in result["message"]
+
     @pytest.mark.asyncio
     async def test_get_incident_fetches_single_incident(self):
         tools, request = self._register_tools()

{rootly_mcp_server-2.2.17 → rootly_mcp_server-2.2.19}/uv.lock

@@ -1702,7 +1702,7 @@ wheels = [
 
 [[package]]
 name = "rootly-mcp-server"
-version = "2.2.16"
+version = "2.2.19"
 source = { editable = "." }
 dependencies = [
     { name = "authlib" },