@yawlabs/mcph 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `@yawlabs/mcph` are documented here. This project uses [semantic versioning](https://semver.org) and a CI-gated release flow: pushing a `vX.Y.Z` tag triggers `.github/workflows/release.yml`, which publishes to npm.
 
+## 0.39.0 — 2026-04-18
+
+- **`mcph servers` CLI subcommand** — Lists the servers currently configured for your account in the mcp.hosting dashboard, hitting the same `/api/connect/config` endpoint that `runServer` polls at startup. Fills a gap between `mcph doctor` (local state: config files, clients, state.json) and the web dashboard: users can sanity-check their dashboard edits from the terminal, support engineers can ask for `mcph servers --json` output in a ticket, and scripts can pick a namespace up-front before piping into `mcph compliance` or `mcph install`. Table view groups the relevant columns (namespace, name, type, enabled/disabled, compliance grade, cached tool count) and is sorted alphabetically by namespace for diffable re-runs; `--json` emits the raw backend response verbatim. Exit codes: 0 success, 1 no token, 2 fetch error.
+
 ## 0.38.0 — 2026-04-18
 
 - **`mcph reset-learning` CLI subcommand** — Deletes `~/.mcph/state.json` so cross-session learning starts fresh; prints the entry counts that were cleared. Pairs with v0.37.0's doctor RELIABILITY section: once a namespace has been flagged flaky, the dispatch penalty branch (v0.36.0) keeps suppressing it until enough new successes pile up — but if the user has since fixed the underlying cause (rotated a token, swapped the upstream, re-authed), that history is stale and the penalty has overstayed its welcome. This gives them a direct CLI lever to clear it. Scope is all-or-nothing by design; a per-namespace flag is footgunny (user clears one, forgets the others, keeps getting silently mis-ranked). No-op with an explanatory message when `MCPH_DISABLE_PERSISTENCE` is set or the file doesn't exist, so `mcph reset-learning` never surprises. Exit 0 on success or no-op, exit 1 on I/O error (permissions, disk).

package/dist/index.js

@@ -1004,7 +1004,7 @@ function selectFlakyNamespaces(entries, limit) {
 }
 
 // src/doctor-cmd.ts
-var VERSION = true ? "0.38.0" : "dev";
+var VERSION = true ? "0.39.0" : "dev";
 async function runDoctor(opts = {}) {
   const lines = [];
   const write = opts.out ?? ((s) => process.stdout.write(s));
@@ -4065,7 +4065,7 @@ function categorizeSpawnError(err) {
 }
 async function connectToUpstream(config, onDisconnect, onListChanged) {
   const client = new Client(
-    { name: "mcph", version: true ? "0.38.0" : "dev" },
+    { name: "mcph", version: true ? "0.39.0" : "dev" },
     { capabilities: {} }
   );
   let transport;
@@ -4546,7 +4546,7 @@ var ConnectServer = class _ConnectServer {
     this.apiUrl = apiUrl6;
     this.token = token6;
     this.server = new Server(
-      { name: "mcph", version: true ? "0.38.0" : "dev" },
+      { name: "mcph", version: true ? "0.39.0" : "dev" },
       {
         capabilities: {
           tools: { listChanged: true },
@@ -6598,12 +6598,117 @@ To load the top pack in one step, call \`mcp_connect_activate\` with namespaces=
   }
 };
 
+// src/servers-cmd.ts
+function parseServersArgs(argv) {
+  let json = false;
+  for (const a of argv) {
+    if (a === "--json") {
+      json = true;
+    } else if (a === "--help" || a === "-h") {
+      return { ok: false, error: SERVERS_USAGE };
+    } else {
+      return { ok: false, error: `mcph servers: unknown argument "${a}"
+
+${SERVERS_USAGE}` };
+    }
+  }
+  return { ok: true, options: { json } };
+}
+var SERVERS_USAGE = `Usage: mcph servers [--json]
+
+  List the servers configured in your mcp.hosting dashboard.
+
+  --json   Emit machine-readable JSON instead of a table.`;
+async function runServersCommand(opts = {}) {
+  const write = opts.out ?? ((s) => process.stdout.write(s));
+  const writeErr = opts.err ?? ((s) => process.stderr.write(s));
+  const lines = [];
+  const print = (s = "") => {
+    lines.push(s);
+    write(`${s}
+`);
+  };
+  const printErr = (s) => {
+    lines.push(s);
+    writeErr(`${s}
+`);
+  };
+  const config = await loadMcphConfig({
+    cwd: opts.cwd,
+    home: opts.home,
+    env: opts.env
+  });
+  if (!config.token) {
+    printErr("mcph servers: no token resolved. Run `mcph install <client> --token mcp_pat_\u2026` or set MCPH_TOKEN.");
+    return { exitCode: 1, lines };
+  }
+  const fetcher = opts.fetcher ?? fetchConfig;
+  let backend;
+  try {
+    backend = await fetcher(config.apiBase, config.token);
+  } catch (err) {
+    const msg = err instanceof ConfigError || err instanceof Error ? err.message : String(err);
+    printErr(`mcph servers: ${msg}`);
+    return { exitCode: 2, lines };
+  }
+  if (!backend) {
+    printErr("mcph servers: backend returned no data (unexpected 304).");
+    return { exitCode: 2, lines };
+  }
+  if (opts.json) {
+    print(JSON.stringify(backend, null, 2));
+    return { exitCode: 0, lines };
+  }
+  renderTable(backend, print);
+  return { exitCode: 0, lines };
+}
+function renderTable(cfg, print) {
+  const servers = cfg.servers;
+  if (servers.length === 0) {
+    print("No servers configured yet. Visit https://mcp.hosting to add one.");
+    return;
+  }
+  const version = cfg.configVersion ? ` (config ${truncateVersion(cfg.configVersion)})` : "";
+  const active = servers.filter((s) => s.isActive).length;
+  const disabled = servers.length - active;
+  const summary = disabled === 0 ? `${servers.length} server${servers.length === 1 ? "" : "s"}` : `${servers.length} servers (${active} enabled, ${disabled} disabled)`;
+  print(`${summary}${version}`);
+  print("");
+  const rows = servers.map((s) => ({
+    namespace: s.namespace,
+    name: s.name,
+    type: s.type,
+    status: s.isActive ? "enabled" : "disabled",
+    grade: s.complianceGrade ?? "-",
+    tools: s.toolCache ? String(s.toolCache.length) : "?"
+  }));
+  const widths = {
+    namespace: Math.max("NAMESPACE".length, ...rows.map((r) => r.namespace.length)),
+    name: Math.max("NAME".length, ...rows.map((r) => r.name.length)),
+    type: Math.max("TYPE".length, ...rows.map((r) => r.type.length)),
+    status: Math.max("STATUS".length, ...rows.map((r) => r.status.length)),
+    grade: Math.max("GRADE".length, ...rows.map((r) => r.grade.length)),
+    tools: Math.max("TOOLS".length, ...rows.map((r) => r.tools.length))
+  };
+  const header = `  ${"NAMESPACE".padEnd(widths.namespace)}  ${"NAME".padEnd(widths.name)}  ${"TYPE".padEnd(widths.type)}  ${"STATUS".padEnd(widths.status)}  ${"GRADE".padEnd(widths.grade)}  ${"TOOLS".padStart(widths.tools)}`;
+  print(header);
+  const sorted = [...rows].sort((a, b) => a.namespace.localeCompare(b.namespace));
+  for (const r of sorted) {
+    const line = `  ${r.namespace.padEnd(widths.namespace)}  ${r.name.padEnd(widths.name)}  ${r.type.padEnd(widths.type)}  ${r.status.padEnd(widths.status)}  ${r.grade.padEnd(widths.grade)}  ${r.tools.padStart(widths.tools)}`;
+    print(line);
+  }
+}
+function truncateVersion(v) {
+  return v.length > 8 ? v.slice(0, 8) : v;
+}
+
 // src/index.ts
 var KNOWN_SUBCOMMANDS = [
   "compliance",
   "install",
   "doctor",
   "reset-learning",
+  "servers",
   "help",
   "--help",
   "-h",
@@ -6625,6 +6730,14 @@ if (subcommand === "compliance") {
   runDoctor().then((r) => process.exit(r.exitCode));
 } else if (subcommand === "reset-learning") {
   runResetLearning().then((r) => process.exit(r.exitCode));
+} else if (subcommand === "servers") {
+  const parsed = parseServersArgs(process.argv.slice(3));
+  if (!parsed.ok) {
+    process.stderr.write(`${parsed.error}
+`);
+    process.exit(2);
+  }
+  runServersCommand(parsed.options).then((r) => process.exit(r.exitCode));
 } else if (subcommand === "--help" || subcommand === "-h" || subcommand === "help") {
   const installBlock = `    ${INSTALL_USAGE.replace(/^Usage: /, "").replace(/\n/g, "\n    ")}`;
   process.stdout.write(
@@ -6635,6 +6748,7 @@ if (subcommand === "compliance") {
     mcph                              Run as MCP server (requires a token)
     mcph install <client> [flags]     Auto-edit an MCP client's config to launch mcph
     mcph doctor                       Print loaded config + detected clients (support diagnostic)
+    mcph servers [--json]             List servers configured in your mcp.hosting dashboard
     mcph compliance <target> [flags]  Run the compliance suite against an MCP server
     mcph reset-learning               Clear cross-session learning history (~/.mcph/state.json)
     mcph --version                    Print version
@@ -6657,7 +6771,7 @@ ${installBlock}
   );
   process.exit(0);
 } else if (subcommand === "--version" || subcommand === "-V") {
-  process.stdout.write(`mcph ${true ? "0.38.0" : "dev"}
+  process.stdout.write(`mcph ${true ? "0.39.0" : "dev"}
 `);
   process.exit(0);
 } else if (subcommand && !subcommand.startsWith("-")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcph",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "mcp.hosting — one install, all your MCP servers, managed from the cloud",
   "license": "UNLICENSED",
   "author": "Yaw Labs <contact@yaw.sh> (https://yaw.sh)",