@hoststack.dev/mcp 0.21.0 → 0.22.0

package/README.md

@@ -83,6 +83,18 @@ 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.

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.22.0" : "0.0.0-dev";
 var USER_AGENT = `hoststack-mcp/${MCP_VERSION}`;
 
 // src/api-client.ts
@@ -5335,10 +5335,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 +5399,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";