@mcpcloud/cli 0.22.1-next-20260907002512 → 0.22.2-next-20260909201421

package/README.md

@@ -569,7 +569,7 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `mcp skills delete <skill>` | Permanently delete a draft skill. Requires --confirm "<exact name>". Published skills with versions/installs are rejected (archive instead). |
 | `mcp skills deploy <skill>` | Deploy a published skill version as an MCP endpoint (newest version by default) |
 | `mcp skills get <skill>` | Get details for a single skill (accepts id or name) |
-| `mcp skills install <skill>` | Install a skill into the caller's project |
+| `mcp skills install <skill>` | Install a skill into the caller's project, or a marketplace skill by registry artifact id |
 | `mcp skills installations <skill>` | List the installation footprint of a skill (which orgs / users installed it) |
 | `mcp skills invoke <skill>` | Run a deployed skill from the terminal. Resolves the skill’s MCP endpoint, auto-discovers its single tool, and calls it. |
 | `mcp skills list` | List skills in an organization |

package/dist/index.js

@@ -11536,36 +11536,6 @@ function registerSkillMutationCommands(skills) {
     }
     printSuccess(`Deleted skill ${data.deleted.name} (${data.deleted.id}).`);
   }));
-  skills.command("install <skill>").description("Install a skill into the caller's project").option("--org <organizationId>", "Organization ID").option("--project <project>", "Project (id or name; defaults to the skill's project)").option("--pin <semver>", "Pin a specific skill version (sent as `version` on the wire)").option("--config <json>", "Per-installation runtime config (passed verbatim to the skill)").action(runAction(async (skillRef, opts) => {
-    const orgId = await resolveOrgId(opts.org);
-    const projectOverride = await resolveOptionalProjectId(opts.project, orgId);
-    const skillId = await resolveSkillId(skillRef, orgId, projectOverride);
-    const { projectId } = await resolveSkillProject(orgId, skillId, projectOverride);
-    const body = {
-      organizationId: orgId,
-      projectId,
-      skillId
-    };
-    if (opts.pin !== undefined)
-      body["version"] = opts.pin;
-    if (opts.config !== undefined)
-      body["config"] = opts.config;
-    const data = await api.post("/api/v1/skill/install", body);
-    if (isJsonMode()) {
-      printJson(data);
-      return;
-    }
-    const i = data.installation;
-    printSuccess(`Skill ${skillId} installed (installation ${i.id}).`);
-    printKeyValue({
-      "installation id": i.id,
-      "skill id": i.artifactId,
-      version: i.version,
-      status: i.status,
-      "project id": projectId,
-      installed: formatDate(i.createdAt)
-    });
-  }));
   skills.command("uninstall <skill>").description("Mark the caller's installation of this skill as removed").option("--org <organizationId>", "Organization ID").option("--project <project>", "Project (id or name; defaults to the skill's project)").action(runAction(async (skillRef, opts) => {
     const orgId = await resolveOrgId(opts.org);
     const projectOverride = await resolveOptionalProjectId(opts.project, orgId);
@@ -12056,6 +12026,113 @@ function invokeResultToJson(result) {
   };
 }
 
+// src/commands/skills-install.ts
+async function probeRegistryArtifact(artifactId) {
+  try {
+    const data = await api.get("/api/v1/registry/artifact", { artifactId });
+    return data.artifact ?? null;
+  } catch (error) {
+    if (error instanceof McpCloudApiError)
+      return null;
+    throw error;
+  }
+}
+function isSkillMiss(error) {
+  if (error instanceof CliExitError)
+    return true;
+  return error instanceof McpCloudApiError && error.status === 404;
+}
+async function resolveInstallTarget(ref, orgId, projectOverride) {
+  let skillMiss;
+  try {
+    const skillId = await resolveSkillId(ref, orgId, projectOverride);
+    const { projectId } = await resolveSkillProject(orgId, skillId, projectOverride);
+    return { kind: "skill", projectId, skillId };
+  } catch (error) {
+    if (!isSkillMiss(error) || !isIdShape(ref.trim()))
+      throw error;
+    skillMiss = error;
+  }
+  const artifact = await probeRegistryArtifact(ref.trim());
+  if (!artifact)
+    throw skillMiss;
+  if (artifact.artifactType !== "skill") {
+    throw new CliExitError(1, `${ref} is a marketplace ${artifact.artifactType}, not a skill. Install it with \`mcp marketplace install ${ref}\`.`);
+  }
+  return { artifact, kind: "registry" };
+}
+async function installRegistryArtifact(artifact, orgId, opts, projectOverride) {
+  if (projectOverride || opts.config !== undefined) {
+    throw new CliExitError(1, `${artifact.name} is a marketplace skill: it installs into your organization as published, so --project and --config do not apply. Re-run without them.`);
+  }
+  const data = await api.post("/api/v1/registry/install", {
+    organizationId: orgId,
+    artifactId: artifact.id,
+    ...opts.pin !== undefined ? { version: opts.pin } : {}
+  });
+  if (isJsonMode()) {
+    printJson(data);
+    return;
+  }
+  const i = data.installation;
+  printSuccess(`Installed marketplace skill ${c.bold(artifact.name)} v${i.version} (installation ${i.id}).`);
+  printKeyValue({
+    "installation id": i.id,
+    "artifact id": i.primaryArtifactId,
+    version: i.version,
+    status: i.status
+  });
+  printStep(`Fetch it for your agent: \`mcp skills pull ${artifact.id}\``);
+}
+function registerSkillInstallCommand(skills) {
+  skills.command("install <skill>").description("Install a skill into the caller's project, or a marketplace skill by registry artifact id").option("--org <organizationId>", "Organization ID").option("--project <project>", "Project (id or name; defaults to the skill's project)").option("--pin <semver>", "Pin a specific skill version (sent as `version` on the wire)").option("--config <json>", "Per-installation runtime config (passed verbatim to the skill)").addHelpText("after", [
+    "",
+    "Notes:",
+    "  <skill> is a skill in your organization (id, name, or project/name).",
+    "  A marketplace registry artifact id installs that published skill into",
+    "  your organization instead (same as `mcp marketplace install`);",
+    "  --project and --config do not apply there.",
+    "",
+    "Examples:",
+    '  $ mcp skills install "Refund flow" --pin 1.2.0',
+    "  $ mcp skills install p179hst...          # a marketplace skill, by artifact id",
+    "  $ mcp skills pull p179hst...             # then fetch its SKILL.md"
+  ].join(`
+`)).action(runAction(async (skillRef, opts) => {
+    const orgId = await resolveOrgId(opts.org);
+    const projectOverride = await resolveOptionalProjectId(opts.project, orgId);
+    const target = await resolveInstallTarget(skillRef, orgId, projectOverride);
+    if (target.kind === "registry") {
+      await installRegistryArtifact(target.artifact, orgId, opts, projectOverride);
+      return;
+    }
+    const body = {
+      organizationId: orgId,
+      projectId: target.projectId,
+      skillId: target.skillId
+    };
+    if (opts.pin !== undefined)
+      body["version"] = opts.pin;
+    if (opts.config !== undefined)
+      body["config"] = opts.config;
+    const data = await api.post("/api/v1/skill/install", body);
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    const i = data.installation;
+    printSuccess(`Skill ${target.skillId} installed (installation ${i.id}).`);
+    printKeyValue({
+      "installation id": i.id,
+      "skill id": i.artifactId,
+      version: i.version,
+      status: i.status,
+      "project id": target.projectId,
+      installed: formatDate(i.createdAt)
+    });
+  }));
+}
+
 // src/commands/skills-pull.ts
 import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync7 } from "node:fs";
 import { dirname as dirname6, isAbsolute as isAbsolute3, join as join11, resolve as resolve7 } from "node:path";
@@ -12259,6 +12336,7 @@ async function runClaudeMcpAdd(connectionName, mcpUrl, bearerToken) {
 function registerSkillCommands(program) {
   const skills = program.command("skills").description("Manage skills");
   registerSkillMutationCommands(skills);
+  registerSkillInstallCommand(skills);
   registerSkillLifecycleCommands(skills);
   registerSkillTestCommands(skills);
   registerSkillInvokeCommand(skills);

package/package.json

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