devhelm-mcp-server 0.8.2__tar.gz → 1.0.0__tar.gz

devhelm_mcp_server-1.0.0/CHANGELOG.md

@@ -0,0 +1,120 @@
+# Changelog
+
+All notable changes to `devhelm-mcp-server` are documented here.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-05-06
+
+First GA release. Cut alongside the `1.0.0` GA of the `devhelm` Python
+SDK, the `devhelm` CLI, and the `@devhelm/sdk` JS/TS SDK. The schema
+and tool surface that `0.8.3` shipped is the GA contract — no
+behavioral changes from `0.8.3`, only the version bump and the SDK
+floor change below.
+
+### Changed
+
+- Bump `devhelm` Python SDK floor to `>=1.0.0`. Aligns with the GA
+  release of the SDK; future patch/minor SDK bumps will be picked up
+  automatically without an explicit floor change here.
+
+### Compatibility
+
+- All tool input schemas, tool names, and response shapes are
+  unchanged from `0.8.3`. Existing clients keep working without
+  modification.
+
+## [0.8.3] — 2026-05-06
+
+### Changed
+
+- Rewrite `initialize.instructions` to point at transport-layer auth
+  (`Authorization: Bearer ...` for hosted, `DEVHELM_API_TOKEN` env for
+  stdio) and explicitly note that tool schemas no longer accept
+  `api_token` arguments. The previous wording ("All operations require
+  a valid DevHelm API token") contradicted the 0.7.0 schema change and
+  caused LLMs to attempt to thread tokens into tool args.
+- Add `CHANGELOG.md` retroactively covering 0.6.0 → 0.8.x. Going
+  forward, every release lands with a corresponding stanza.
+
+## [0.8.2] — 2026-05-06
+
+### Changed
+
+- Bump `devhelm` Python SDK floor to `>=0.7.2`. Older versions raise Pydantic
+  `extra_forbidden` on the new `managedBy` field that the API now returns on
+  resource DTOs.
+
+## [0.8.1] — 2026-05-06
+
+### Changed
+
+- Sync OpenAPI spec and refresh bundled SDK to pick up the new monitor
+  validation contract (`frequencySeconds` bounds, dynamic region whitelist)
+  and `managedBy` resource-attribution field.
+
+## [0.8.0] — 2026-05-06
+
+### Added
+
+- **Maintenance window tools** (`maintenance_window_*`): list / create / get
+  / update / cancel scheduled maintenance windows so AI agents can suppress
+  alerts during planned deploys.
+
+## [0.7.1] — 2026-05-06
+
+### Fixed
+
+- `--help` / `--version` no longer hang waiting on stdin. The binary now ships
+  a proper `argparse` interface with `--transport {stdio,http}`, `--host`,
+  `--port` flags. (Also addressable via `DEVHELM_MCP_TRANSPORT`,
+  `DEVHELM_MCP_HOST`, `DEVHELM_MCP_PORT` env vars.)
+- ASCII banner suppressed on stdio transport so it doesn't pollute JSON-RPC.
+- `/mcp` (no trailing slash) is rewritten in-process instead of returning a
+  `307` redirect (which not all MCP clients follow correctly).
+- `serverInfo` now reports `name=devhelm-mcp-server`, `version=<package>`
+  (was the FastMCP runtime `name=DevHelm`, `version=3.x.y`). Makes support
+  triage unambiguous and lets clients pin behavior to a published wheel.
+
+## [0.7.0] — 2026-05-05
+
+### **Breaking**
+
+- **Tool input schemas no longer accept `api_token`.** Authentication is
+  resolved at the transport layer:
+  - Hosted Streamable HTTP: `Authorization: Bearer <token>` header.
+  - Stdio: `DEVHELM_API_TOKEN` environment variable.
+  This eliminates the per-call token-passing friction that made the server
+  awkward in Cursor / Claude Desktop. Existing clients that still pass
+  `api_token` in tool arguments will get an `unexpected_keyword_argument`
+  Pydantic error from FastMCP.
+
+- **`create_monitor` no longer accepts a caller-supplied `managedBy`.**
+  The server forces `managedBy=MCP` on every monitor it creates so resource
+  attribution is honest. Callers that need a different attribution should
+  use the SDK or CLI directly.
+
+- **`delete_monitor` parameter renamed:** `id` → `monitor_id`. (Same shape
+  applied across other resource delete tools — `incident_id`,
+  `channel_id`, etc. for consistency.)
+
+- **`list_*` tools no longer require an empty `body: {}` envelope.** Pass
+  no arguments instead.
+
+### Fixed
+
+- Upstream API failures now surface as `isError: true` ToolError responses
+  instead of being swallowed silently.
+- Documented user journeys end-to-end now actually work without hand-tuning.
+
+### Added
+
+- Usage telemetry now reports `surface=mcp` so we can tell MCP traffic from
+  raw SDK traffic in dashboards.
+
+## [0.6.0] — 2026-05-04
+
+Initial public release with 101 tools covering monitors, incidents, alert
+channels, notification policies, environments, secrets, tags, resource
+groups, webhooks, API keys, service dependencies, deploy locks, status
+pages, and dashboard read.

{devhelm_mcp_server-0.8.2 → devhelm_mcp_server-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhelm-mcp-server
-Version: 0.8.2
+Version: 1.0.0
 Summary: DevHelm MCP server — AI agent access to monitors, incidents, alerting, and more
 Project-URL: Homepage, https://devhelm.io
 Project-URL: Repository, https://github.com/devhelmhq/mcp-server
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
-Requires-Dist: devhelm>=0.7.2
+Requires-Dist: devhelm>=1.0.0
 Requires-Dist: fastmcp>=2.0.0
 Description-Content-Type: text/markdown
 

{devhelm_mcp_server-0.8.2 → devhelm_mcp_server-1.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devhelm-mcp-server"
-version = "0.8.2"
+version = "1.0.0"
 description = "DevHelm MCP server — AI agent access to monitors, incidents, alerting, and more"
 authors = [{ name = "DevHelm", email = "hello@devhelm.io" }]
 license = "MIT"
@@ -19,11 +19,14 @@ classifiers = [
 ]
 
 dependencies = [
-    # Floor bumped to 0.7.2: required for `managedBy` field on resource DTOs
-    # and for the new monitor validation contract (frequencySeconds bounds,
-    # dynamic region whitelist). Older devhelm versions raise Pydantic
-    # `extra_forbidden` errors when the API returns `managedBy`.
-    "devhelm>=0.7.2",
+    # Floor bumped to 1.0.0: aligns with the GA release of the Python SDK
+    # cut alongside this server's 1.0.0. The 1.0.0 SDK includes every
+    # contract the server currently relies on (`managedBy` on resource
+    # DTOs, the monitor validation contract — frequencySeconds bounds,
+    # dynamic region whitelist) and commits to semver going forward, so
+    # `>=1.0.0` lets us pull in compatible patch/minor bumps without
+    # explicit floor bumps each time.
+    "devhelm>=1.0.0",
     "fastmcp>=2.0.0",
 ]
 

{devhelm_mcp_server-0.8.2 → devhelm_mcp_server-1.0.0}/src/devhelm_mcp/server.py

@@ -78,8 +78,12 @@ mcp = FastMCP(
         "Use these tools to manage uptime monitors, incidents, alert channels, "
         "notification policies, environments, secrets, tags, resource groups, "
         "webhooks, API keys, service dependencies, deploy locks, maintenance "
-        "windows, status pages, and view dashboard status. All operations "
-        "require a valid DevHelm API token."
+        "windows, status pages, and view dashboard status. "
+        "Authentication is handled at the transport layer: "
+        "`Authorization: Bearer <token>` for the hosted endpoint "
+        "(https://mcp.devhelm.io/mcp/), or the `DEVHELM_API_TOKEN` environment "
+        "variable when running over stdio (e.g. `uvx devhelm-mcp-server`). "
+        "Do not pass tokens in tool arguments — tool schemas no longer accept them."
     ),
 )
 

{devhelm_mcp_server-0.8.2 → devhelm_mcp_server-1.0.0}/uv.lock

@@ -388,20 +388,20 @@ wheels = [
 
 [[package]]
 name = "devhelm"
-version = "0.7.2"
+version = "1.0.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "pydantic", extra = ["email"] },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/90/5d/b853660ac8f5cfd3662f18b3608fb0c80ce8f7c246a0d66eae6806d0c212/devhelm-0.7.2.tar.gz", hash = "sha256:84e8218a42719799a2166290fcb84b7ed36c0386a41009c028a2c8abf2ff162c", size = 245192, upload-time = "2026-05-06T15:57:36.421Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/10/9b/df5ce6deb9726da8bd461f1151db446d6ebd0dd6e47264f9bfb498ed3f88/devhelm-1.0.0.tar.gz", hash = "sha256:32f6aff4ff483038af0ae91376435935c9d5e2eadb6fb10587b0dd33a7d9b51d", size = 245190, upload-time = "2026-05-06T19:25:29.309Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2c/e6/74b538b202e4ff01293382af9b2951a1cc0ecdf9c5535b42f8ee919781bc/devhelm-0.7.2-py3-none-any.whl", hash = "sha256:63117a0f7722fa8aa6aa63395c4f08925299dfb9b1442bf62cd40a60f9188d94", size = 78306, upload-time = "2026-05-06T15:57:35.114Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/ab/f76135202042ea1168892d81193294d62d1911087c25731dc46e441efdcf/devhelm-1.0.0-py3-none-any.whl", hash = "sha256:8eb4962f17fe8ee3668dc79cd405200b8294a7d4988a7380505c40aebdad0717", size = 78304, upload-time = "2026-05-06T19:25:28.133Z" },
 ]
 
 [[package]]
 name = "devhelm-mcp-server"
-version = "0.8.2"
+version = "1.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "devhelm" },
@@ -419,7 +419,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "devhelm", specifier = ">=0.7.2" },
+    { name = "devhelm", specifier = ">=1.0.0" },
     { name = "fastmcp", specifier = ">=2.0.0" },
 ]