rootly-mcp-server 2.0.14__py3-none-any.whl → 2.0.15__py3-none-any.whl

{rootly_mcp_server-2.0.14.dist-info → rootly_mcp_server-2.0.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rootly-mcp-server
-Version: 2.0.14
+Version: 2.0.15
 Summary: A Model Context Protocol server for Rootly APIs using OpenAPI spec
 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
@@ -63,7 +63,7 @@ Configure your MCP-compatible editor (tested with Cursor) with one of the config
         "run",
         "--from",
         "rootly-mcp-server",
-        "rootly-mcp-server",
+        "rootly-mcp-server"
       ],      
       "env": {
         "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
@@ -83,7 +83,7 @@ Configure your MCP-compatible editor (tested with Cursor) with one of the config
       "args": [
         "--from",
         "rootly-mcp-server",
-        "rootly-mcp-server",
+        "rootly-mcp-server"
       ],      
       "env": {
         "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
@@ -143,46 +143,60 @@ Alternatively, connect directly to our hosted MCP server:
 - **Dynamic Tool Generation**: Automatically creates MCP resources from Rootly's OpenAPI (Swagger) specification
 - **Smart Pagination**: Defaults to 10 items per request for incident endpoints to prevent context window overflow
 - **API Filtering**: Limits exposed API endpoints for security and performance
-- **AI-Powered Incident Analysis**: Smart tools that learn from historical incident data
-  - **`find_related_incidents`**: Uses TF-IDF similarity analysis to find historically similar incidents
+- **Intelligent Incident Analysis**: Smart tools that analyze historical incident data
+  - **`find_related_incidents`**: Uses TF-IDF similarity analysis to find historically similar incidents  
   - **`suggest_solutions`**: Mines past incident resolutions to recommend actionable solutions
 - **MCP Resources**: Exposes incident and team data as structured resources for easy AI reference
 - **Intelligent Pattern Recognition**: Automatically identifies services, error types, and resolution patterns
 
-### Whitelisted Endpoints
-
-By default, the following Rootly API endpoints are exposed to the AI agent (see `allowed_paths` in `src/rootly_mcp_server/server.py`):
-
-```
-/v1/incidents
-/v1/incidents/{incident_id}/alerts
-/v1/alerts
-/v1/alerts/{alert_id}
-/v1/severities
-/v1/severities/{severity_id}
-/v1/teams
-/v1/teams/{team_id}
-/v1/services
-/v1/services/{service_id}
-/v1/functionalities
-/v1/functionalities/{functionality_id}
-/v1/incident_types
-/v1/incident_types/{incident_type_id}
-/v1/incident_action_items
-/v1/incident_action_items/{incident_action_item_id}
-/v1/incidents/{incident_id}/action_items
-/v1/workflows
-/v1/workflows/{workflow_id}
-/v1/workflow_runs
-/v1/workflow_runs/{workflow_run_id}
-/v1/environments
-/v1/environments/{environment_id}
-/v1/users
-/v1/users/{user_id}
-/v1/users/me
-/v1/status_pages
-/v1/status_pages/{status_page_id}
-```
+### Available Tools
+
+**Alerts**
+- `listIncidentAlerts`
+- `listAlerts`
+- `attachAlert`
+- `createAlert`
+
+**Environments**
+- `listEnvironments`
+- `createEnvironment`
+
+**Functionalities**
+- `listFunctionalities`
+- `createFunctionality`
+
+**Workflows**
+- `listWorkflows`
+- `createWorkflow`
+
+**Incidents**
+- `listIncidentActionItems`
+- `createIncidentActionItem`
+- `listIncident_Types`
+- `createIncidentType`
+- `search_incidents`
+- `find_related_incidents`
+- `suggest_solutions`
+
+**On-Call**
+- `get_oncall_shift_metrics`
+- `get_oncall_handoff_summary`
+- `get_shift_incidents`
+
+**Services & Severities**
+- `listServices`
+- `createService`
+- `listSeverities`
+- `createSeverity`
+
+**Teams & Users**
+- `listTeams`
+- `createTeam`
+- `listUsers`
+- `getCurrentUser`
+
+**Meta**
+- `list_endpoints`
 
 ### Why Path Limiting?
 
@@ -193,14 +207,14 @@ We limit exposed API paths for two key reasons:
 
 To expose additional paths, modify the `allowed_paths` variable in `src/rootly_mcp_server/server.py`.
 
-### AI-Powered Smart Tools
+### Smart Analysis Tools
 
 The MCP server includes intelligent tools that analyze historical incident data to provide actionable insights:
 
 #### `find_related_incidents`
-Finds historically similar incidents using machine learning text analysis:
+Finds historically similar incidents using text similarity analysis:
 ```
-find_related_incidents(incident_id="12345", similarity_threshold=0.3, max_results=5)
+find_related_incidents(incident_id="12345", similarity_threshold=0.15, max_results=5)
 ```
 - **Input**: Incident ID, similarity threshold (0.0-1.0), max results
 - **Output**: Similar incidents with confidence scores, matched services, and resolution times
@@ -215,7 +229,7 @@ suggest_solutions(incident_title="Payment API errors", incident_description="Use
 ```
 - **Input**: Either incident ID OR title/description text
 - **Output**: Actionable solution recommendations with confidence scores and time estimates  
-- **Use Case**: Get AI-powered suggestions based on successful past resolutions
+- **Use Case**: Get intelligent suggestions based on successful past resolutions
 
 #### How It Works
 - **Text Similarity**: Uses TF-IDF vectorization and cosine similarity (scikit-learn)
@@ -232,6 +246,56 @@ For optimal results, ensure your Rootly incidents have descriptive:
 
 Example good resolution summary: `"Restarted auth-service, cleared Redis cache, and increased connection pool from 10 to 50"`
 
+### On-Call Shift Metrics
+
+Get on-call shift metrics for any time period, grouped by user, team, or schedule. Includes primary/secondary role tracking, shift counts, hours, and days on-call.
+
+```
+get_oncall_shift_metrics(
+    start_date="2025-10-01",
+    end_date="2025-10-31",
+    group_by="user"
+)
+```
+
+### On-Call Handoff Summary
+
+Complete handoff: current/next on-call + incidents during shifts.
+
+```python
+# All on-call (any timezone)
+get_oncall_handoff_summary(
+    team_ids="team-1,team-2",
+    timezone="America/Los_Angeles"
+)
+
+# Regional filter - only show APAC on-call during APAC business hours
+get_oncall_handoff_summary(
+    timezone="Asia/Tokyo",
+    filter_by_region=True
+)
+```
+
+Regional filtering shows only people on-call during business hours (9am-5pm) in the specified timezone.
+
+Returns: `schedules` with `current_oncall`, `next_oncall`, and `shift_incidents`
+
+### Shift Incidents
+
+Incidents during a time period, with filtering by severity/status/tags.
+
+```python
+get_shift_incidents(
+    start_time="2025-10-20T09:00:00Z",
+    end_time="2025-10-20T17:00:00Z",
+    severity="critical",  # optional
+    status="resolved",    # optional
+    tags="database,api"   # optional
+)
+```
+
+Returns: `incidents` list + `summary` (counts, avg resolution time, grouping)
+
 ## About Rootly AI Labs
 
 This project was developed by [Rootly AI Labs](https://labs.rootly.ai/), where we're building the future of system reliability and operational excellence. As an open-source incubator, we share ideas, experiment, and rapidly prototype solutions that benefit the entire community.
@@ -265,7 +329,20 @@ To add new dependencies during development:
 uv pip install <package>
 ```
 
-### 3. Verify Installation
+### 3. Set Up Git Hooks (Recommended for Contributors)
+
+Install pre-commit hooks to automatically run linting and tests before commits:
+
+```bash
+./scripts/setup-hooks.sh
+```
+
+This ensures code quality by running:
+- Ruff linting
+- Pyright type checking
+- Unit tests
+
+### 4. Verify Installation
 
 The server should now be ready to use with your MCP-compatible editor.
 

{rootly_mcp_server-2.0.14.dist-info → rootly_mcp_server-2.0.15.dist-info}/RECORD

@@ -1,12 +1,13 @@
 rootly_mcp_server/__init__.py,sha256=rvIuqIyuzgC7b9qSnylrdDP2zPO-7Ou9AoblR6re1co,629
 rootly_mcp_server/__main__.py,sha256=_F4p65_VjnN84RtmEdESVLLH0tO5tL9qBfb2Xdvbj2E,6480
 rootly_mcp_server/client.py,sha256=uit-YijR7OAJtysBoclqnublEDVkFfcb29wSzhpBv44,4686
-rootly_mcp_server/server.py,sha256=dlqsLnD3QzRtSlUYzK_PUe5zR9rbQRvySRSjmKbCy5w,51476
+rootly_mcp_server/server.py,sha256=Qmsv-BKNhsEj8_7S1glBgLEN6OlSKqOvMRgJ40ZFeCg,98716
 rootly_mcp_server/smart_utils.py,sha256=lvGN9ITyJjBkm7ejpYagd8VWodLKnC6FmwECfCOcGwM,22973
+rootly_mcp_server/texttest.json,sha256=KV9m13kWugmW1VEpU80Irp50uCcLgJtV1YT-JzMogQg,154182
 rootly_mcp_server/utils.py,sha256=NyxdcDiFGlV2a8eBO4lKgZg0D7Gxr6xUIB0YyJGgpPA,4165
 rootly_mcp_server/data/__init__.py,sha256=fO8a0bQnRVEoRMHKvhFzj10bhoaw7VsI51czc2MsUm4,143
-rootly_mcp_server-2.0.14.dist-info/METADATA,sha256=XvbzBwNb-XkGeedNz2oZDRebwvBA1cUYSYSrPftB9L4,9078
-rootly_mcp_server-2.0.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-rootly_mcp_server-2.0.14.dist-info/entry_points.txt,sha256=NE33b8VgigVPGBkboyo6pvN1Vz35HZtLybxMO4Q03PI,70
-rootly_mcp_server-2.0.14.dist-info/licenses/LICENSE,sha256=c9w9ZZGl14r54tsP40oaq5adTVX_HMNHozPIH2ymzmw,11341
-rootly_mcp_server-2.0.14.dist-info/RECORD,,
+rootly_mcp_server-2.0.15.dist-info/METADATA,sha256=stGxakp4C-3jGIZG7pqAm3wim_UxAlrTikO--kApdiE,10552
+rootly_mcp_server-2.0.15.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+rootly_mcp_server-2.0.15.dist-info/entry_points.txt,sha256=NE33b8VgigVPGBkboyo6pvN1Vz35HZtLybxMO4Q03PI,70
+rootly_mcp_server-2.0.15.dist-info/licenses/LICENSE,sha256=c9w9ZZGl14r54tsP40oaq5adTVX_HMNHozPIH2ymzmw,11341
+rootly_mcp_server-2.0.15.dist-info/RECORD,,