@mcpcloud/cli 0.12.0-next-20260721180156 → 0.13.0

package/README.md

@@ -161,6 +161,7 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | --- | --- |
 | `mcp analytics` | Show the workspace analytics rollup (readiness, funnel, usage) |
 | `mcp completion <shell>` | Print a shell completion script (bash, zsh, or fish) |
+| `mcp connect-agent` | Connect your agent to the official MCPCloud MCP server (headless twin of /connect-agent) |
 | `mcp doctor` | Diagnose the CLI environment: Node, config, base URL, API key, claude CLI, and updates |
 | `mcp help [topic]` | Show extended help for a topic (auth, profiles, agents, errors) |
 | `mcp init` | Guided onboarding: pick org → pick/create project → create a server (empty skeleton, or generated from an OpenAPI/GraphQL spec via --from-spec) |

package/dist/index.js

@@ -33049,6 +33049,72 @@ Usage detail requires admin organization access.`);
   }));
 }
 
+// src/commands/connect-agent.ts
+function connectSnippet(mcpUrl, name) {
+  return [
+    `claude mcp add ${name.toLowerCase()} --transport http ${mcpUrl}`,
+    `# or any MCP client: streamable HTTP endpoint ${mcpUrl}`
+  ].join(`
+`);
+}
+function registerConnectAgentCommand(program2) {
+  program2.command("connect-agent").description("Connect your agent to the official MCPCloud MCP server (headless twin of /connect-agent)").option("--status", "Show your connection state without changing anything").option("--revoke", "Disconnect: revoke your stored credential").addHelpText("after", [
+    "",
+    "Examples:",
+    "  $ mcp connect-agent            # enroll this profile’s key + print the snippet",
+    "  $ mcp connect-agent --status",
+    "  $ mcp connect-agent --revoke"
+  ].join(`
+`)).action(runAction(async (opts) => {
+    const info = await api.get("/api/v1/official-server");
+    const { server } = info;
+    if (opts.status) {
+      if (isJsonMode()) {
+        printJson(info);
+        return;
+      }
+      printKeyValue({
+        server: server.name,
+        endpoint: server.mcpUrl ?? "(no active deployment)",
+        plane: info.callerIsMember ? "member" : server.endUserAccess === "enabled" ? "end-user" : "unavailable (end-user access disabled)",
+        connection: info.connection ? `${info.connection.status} (••••${info.connection.keyHint}${info.connection.minted ? ", platform-minted" : ""})` : "not connected"
+      });
+      return;
+    }
+    if (opts.revoke) {
+      const revoked = await api.delete("/api/v1/upstream-key", { serverId: server.id });
+      if (isJsonMode()) {
+        printJson(revoked);
+        return;
+      }
+      printKeyValue({
+        revoked: String(revoked.revoked),
+        note: revoked.revoked ? "Disconnected. Reconnect any time with `mcp connect-agent`." : "No active connection was stored."
+      });
+      return;
+    }
+    if (!info.callerIsMember && server.endUserAccess !== "enabled") {
+      throw new Error("The official server is not open to non-members in this environment yet.");
+    }
+    const saved = await api.post("/api/v1/upstream-key", { serverId: server.id, apiKey: requireApiKey() });
+    if (isJsonMode()) {
+      printJson({ ...saved, server });
+      return;
+    }
+    printKeyValue({
+      connected: String(saved.saved),
+      server: server.name,
+      key: `••••${saved.keyHint}`,
+      plane: info.callerIsMember ? "member" : "end-user",
+      endpoint: server.mcpUrl ?? "(no active deployment)"
+    });
+    if (server.mcpUrl) {
+      console.log(`
+${connectSnippet(server.mcpUrl, server.name)}`);
+    }
+  }));
+}
+
 // src/commands/connections.ts
 async function readKeyFromStdin() {
   const chunks = [];
@@ -37775,6 +37841,7 @@ function createProgram() {
   registerOrgCommands(program2);
   registerUsageCommands(program2);
   registerAnalyticsCommands(program2);
+  registerConnectAgentCommand(program2);
   registerConnectionsCommands(program2);
   registerMetricsCommands(program2);
   registerDevCommand(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpcloud/cli",
-  "version": "0.12.0-next-20260721180156",
+  "version": "0.13.0",
   "description": "The official CLI for MCPCloud — manage projects, servers, skills, and API keys from the terminal",
   "type": "module",
   "bin": {