@hoststack.dev/mcp 0.21.0 → 0.23.0

package/README.md

@@ -83,9 +83,21 @@ npx @hoststack.dev/mcp --print-config claude-code
 
 If `HOSTSTACK_API_KEY` is set in your shell, it gets baked into the snippet; otherwise you'll see a `hs_live_your_api_key_here` placeholder you can search-and-replace.
 
+`--help` and `--version` work the same way — no key needed, because the people
+most likely to reach for them are the ones who haven't set one up yet:
+
+```bash
+npx @hoststack.dev/mcp --help
+npx @hoststack.dev/mcp --version
+```
+
+Running it with no arguments starts the server on stdio, and that is the one
+path that does need `HOSTSTACK_API_KEY`. It speaks JSON-RPC, so it isn't much
+use by hand — an MCP client is what should be launching it.
+
 ## Tool inventory
 
-107 tools. The headings are the registry's own categories rather than a friendlier regrouping, so the build can diff this table against the registry and fail when the two disagree — which is how an earlier version of it came to advertise a total from three releases back and send agents to the dashboard for a `create_database` that had already shipped.
+108 tools. The headings are the registry's own categories rather than a friendlier regrouping, so the build can diff this table against the registry and fail when the two disagree — which is how an earlier version of it came to advertise a total from three releases back and send agents to the dashboard for a `create_database` that had already shipped.
 
 | Category           | Read                                                                                                                            | Write                                                                                                                                                                                                                                                            |
 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -93,7 +105,7 @@ If `HOSTSTACK_API_KEY` is set in your shell, it gets baked into the snippet; oth
 | **services**       | `list_services`, `get_service`, `get_service_metrics`, `get_service_metrics_history`, `list_dev_environments`, `list_templates` | `create_service`, `create_dev_environment`, `create_standalone_dev_environment`, `spin_up_dev_environment`, `resize_dev_environment`, `delete_dev_environment`, `update_service`, `update_service_config`, `suspend_service`, `resume_service`, `delete_service` |
 | **logs**           | `get_service_logs`, `get_service_logs_bulk`                                                                                     | —                                                                                                                                                                                                                                                                |
 | **deploys**        | `list_deploys`, `get_deploy`, `get_deploy_logs`, `diagnose_deploy`                                                              | `trigger_deploy`, `cancel_deploy`                                                                                                                                                                                                                                |
-| **environments**   | `list_environments`                                                                                                             | `create_environment`, `delete_environment`, `promote_deploy`                                                                                                                                                                                                     |
+| **environments**   | `list_environments`                                                                                                             | `create_environment`, `update_environment`, `delete_environment`, `promote_deploy`                                                                                                                                                                               |
 | **databases**      | `list_databases`, `get_database`, `get_database_cluster`, `query_database`                                                      | `create_database`, `update_database`, `delete_database`, `suspend_database`, `resume_database`, `restart_database`, `upgrade_database_to_ha`, `upgrade_database_version`                                                                                         |
 | **volumes**        | `list_volumes`                                                                                                                  | `create_volume`, `update_volume`, `delete_volume`                                                                                                                                                                                                                |
 | **resource-links** | `list_managed_resources`, `list_service_resources`                                                                              | `link_resource_to_service`, `unlink_resource_from_service`                                                                                                                                                                                                       |

package/dist/hoststack-mcp.js

@@ -8,7 +8,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { HostStack } from "@hoststack.dev/sdk";
 
 // src/version.ts
-var MCP_VERSION = true ? "0.21.0" : "0.0.0-dev";
+var MCP_VERSION = true ? "0.23.0" : "0.0.0-dev";
 var USER_AGENT = `hoststack-mcp/${MCP_VERSION}`;
 
 // src/api-client.ts
@@ -2131,6 +2131,61 @@ defineTool({
     });
   }
 });
+defineTool({
+  name: "update_environment",
+  category: "environments",
+  description: [
+    "Rename an environment, change whether it is protected, or make it the project's default.",
+    "",
+    "When to use: correcting a name, turning protection on for an env that has become production-like, or promoting a different env to default. Everything else about an environment is fixed at creation \u2014 `type` in particular cannot be changed, because the hostname suffix it drives is already baked into every service in the env.",
+    "",
+    "Inputs:",
+    "  - project_id: project publicId.",
+    "  - environment_id: environment publicId or numeric id.",
+    "  - name (optional): new name, 1\u201364 chars.",
+    "  - is_protected (optional): require admin role for destructive actions in this env.",
+    "  - is_default (optional): make this the project default. See below.",
+    "",
+    'is_default is a MOVE, not a flag. Setting it true demotes whichever env is currently default, because a project has exactly one \u2014 and for the same reason you cannot set it false: that would leave the project with none, and every create that omits an envId falls back to the default, so the next `create_service` would fail with "Project has no Production environment". To change which env is default, set is_default true on the one you want; the old one is demoted for you.',
+    "",
+    "Returns: { environment: Environment }.",
+    "",
+    'Example: update_environment({ project_id: "prj_abc", environment_id: "env_xyz", name: "Staging EU" }) \u2192 { environment: { publicId: "env_xyz", name: "Staging EU" } }'
+  ].join("\n"),
+  input: {
+    project_id: z11.string().describe("Project publicId."),
+    environment_id: z11.union([z11.string(), z11.number()]).describe("Environment publicId or numeric id."),
+    name: z11.string().min(1).max(64).optional().describe("New name (1\u201364 chars)."),
+    is_protected: z11.boolean().optional().describe("Require admin role for destructive actions in this env."),
+    is_default: z11.boolean().optional().describe(
+      "Make this the project's default, demoting the current one. Cannot be set false \u2014 promote a different env instead."
+    )
+  },
+  handler: async (args2, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const input = {};
+    if (args2.name !== void 0) input.name = args2.name;
+    if (args2.is_protected !== void 0) input.isProtected = args2.is_protected;
+    if (args2.is_default !== void 0) input.isDefault = args2.is_default;
+    if (Object.keys(input).length === 0) {
+      return respondError(
+        "Nothing to update. Pass at least one of name, is_protected or is_default."
+      );
+    }
+    const response = await ctx.hoststack.environments.update(
+      teamId,
+      args2.project_id,
+      args2.environment_id,
+      input
+    );
+    const data = { environment: shape(response.environment) };
+    const fields = Object.keys(input).join(", ");
+    return respond({
+      summary: `Updated ${fields} on environment ${response.environment.name}.`,
+      data
+    });
+  }
+});
 defineTool({
   name: "delete_environment",
   category: "environments",
@@ -5335,10 +5390,38 @@ function createMcpServer(options) {
 
 // src/cli.ts
 var args = process.argv.slice(2);
+var PRINT_CONFIG_TARGETS = ["claude-desktop", "cursor", "claude-code"];
+var USAGE = `hoststack-mcp ${MCP_VERSION} \u2014 the HostStack MCP server (stdio transport).
+
+Usage:
+  hoststack-mcp                          Serve on stdio. This is what an MCP client runs;
+                                         it speaks JSON-RPC, so it is not useful by hand.
+  hoststack-mcp --print-config <client>  Emit a ready-to-paste config snippet.
+                                         <client>: ${PRINT_CONFIG_TARGETS.join(" | ")}
+  hoststack-mcp --help                   This text.
+  hoststack-mcp --version                Print the version and exit.
+
+Environment:
+  HOSTSTACK_API_KEY    Required to SERVE. An hs_live_\u2026 or hs_test_\u2026 key from
+                       hoststack.dev \u2192 Settings \u2192 API keys. Not needed for
+                       --help, --version or --print-config.
+  HOSTSTACK_BASE_URL   API host. Default https://hoststack.dev.
+  HOSTSTACK_MCP_TRACE  Set to 1 to write one NDJSON line per tool call to
+                       stderr, for a local trace (2> mcp-trace.log).
+`;
+if (args.includes("--help") || args.includes("-h")) {
+  process.stdout.write(USAGE);
+  process.exit(0);
+}
+if (args.includes("--version") || args.includes("-v")) {
+  process.stdout.write(`${MCP_VERSION}
+`);
+  process.exit(0);
+}
 var printIdx = args.indexOf("--print-config");
 if (printIdx !== -1) {
   const target = args[printIdx + 1];
-  const validTargets = /* @__PURE__ */ new Set(["claude-desktop", "cursor", "claude-code"]);
+  const validTargets = new Set(PRINT_CONFIG_TARGETS);
   if (!target || !validTargets.has(target)) {
     console.error(
       `Usage: hoststack-mcp --print-config <${[...validTargets].join("|")}>
@@ -5371,9 +5454,18 @@ if (printIdx !== -1) {
     process.exit(0);
   }
 }
+var unknownFlag = args.find((arg) => arg.startsWith("-"));
+if (unknownFlag) {
+  console.error(`hoststack-mcp: unknown option ${unknownFlag}
+
+${USAGE}`);
+  process.exit(1);
+}
 var apiKey = process.env["HOSTSTACK_API_KEY"];
 if (!apiKey) {
-  console.error("HOSTSTACK_API_KEY environment variable is required");
+  console.error(
+    "hoststack-mcp: HOSTSTACK_API_KEY is required to serve.\nCreate one at hoststack.dev \u2192 Settings \u2192 API keys, then either export it\nor put it in your client config: hoststack-mcp --print-config claude-code\n(--help, --version and --print-config need no key.)"
+  );
   process.exit(1);
 }
 var baseUrl = process.env["HOSTSTACK_BASE_URL"] ?? "https://hoststack.dev";