@mcpcloud/cli 0.10.2 → 0.11.0

package/README.md

@@ -163,22 +163,30 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `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) |
-| `mcp invoke <serverId> <tool>` | Call a tool on a deployed MCP server. Exchanges runtime-auth if needed, sends JSON-RPC `tools/call`, and prints the response. |
+| `mcp invoke <server> <tool>` | Call a tool on a deployed MCP server. Exchanges runtime-auth if needed, sends JSON-RPC `tools/call`, and prints the response. |
 | `mcp login` | Sign in via browser (default) or paste an API key |
 | `mcp logout` | Remove the saved API key from ~/.mcpcloud/config.json |
 | `mcp ui` | Interactive terminal UI: browse orgs/servers/skills, tail deployment logs, and watch the live `mcp dev` inspector |
 | `mcp update` | Check for a newer @mcpcloud/cli release and re-install it via your package manager |
 | `mcp whoami` | Show the caller identity, API key, base URL, and organizations you can access |
 
+### `mcp alias` — Manage per-profile resource shortcuts (aliases)
+
+| Command | Description |
+| --- | --- |
+| `mcp alias list` | List aliases in the active profile |
+| `mcp alias rm <name>` | Remove an alias from the active profile |
+| `mcp alias set <name> <target>` | Create or update an alias. Target is <kind>:<id\|name\|slug>. |
+
 ### `mcp api-keys` — Manage personal API keys
 
 | Command | Description |
 | --- | --- |
 | `mcp api-keys create` | Create a new API key (the secret is shown once) |
-| `mcp api-keys describe <apiKeyId>` | Show one API key (status, expiry, last used) — never the secret |
+| `mcp api-keys describe <apiKey>` | Show one API key (accepts id or name; status, expiry, last used) — never the secret |
 | `mcp api-keys list` | List active API keys for the current user |
-| `mcp api-keys revoke <apiKeyId>` | Permanently revoke an API key |
-| `mcp api-keys rotate <apiKeyId>` | Mint a replacement key and grace-expire the old one (24h window). The new secret is shown once. |
+| `mcp api-keys revoke <apiKey>` | Permanently revoke an API key (accepts id or name) |
+| `mcp api-keys rotate <apiKey>` | Mint a replacement key and grace-expire the old one (24h window; accepts id or name). The new secret is shown once. |
 
 ### `mcp audit` — Workspace audit log (admin/owner only)
 
@@ -211,20 +219,20 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 
 | Command | Description |
 | --- | --- |
-| `mcp connections add <serverId>` | Save (or replace) your upstream API key for a server — rotation is just adding again |
+| `mcp connections add <server>` | Save (or replace) your upstream API key for a server — rotation is just adding again |
 | `mcp connections list` | List your stored upstream keys across servers (hints only) |
-| `mcp connections remove <serverId>` | Revoke your stored upstream key for a server |
+| `mcp connections remove <server>` | Revoke your stored upstream key for a server |
 
 ### `mcp deployments` — Inspect deployments
 
 | Command | Description |
 | --- | --- |
-| `mcp deployments get <deploymentId>` | Show one deployment by id |
-| `mcp deployments health <deploymentId>` | Show a deployment's last health-check result (status, HTTP code, when it was checked) |
+| `mcp deployments get <deployment>` | Show one deployment by id or selector (latest \| active \| previous, with --server) |
+| `mcp deployments health <deployment>` | Show a deployment's last health-check result (status, HTTP code, when it was checked) |
 | `mcp deployments list` | List deployments in an organization |
-| `mcp deployments logs <deploymentId>` | Show recent deployment events; pass --follow to tail new ones as they arrive |
-| `mcp deployments rollback <deploymentId>` | Roll back to a prior deployment — flips a paused/undeployed deployment back to active and demotes the current latest in one shot. |
-| `mcp deployments runtime-auth <deploymentId>` | Inspect a deployment's runtime-auth posture (access mode, exchange path, edge policy) |
+| `mcp deployments logs <deployment>` | Show recent deployment events; pass --follow to tail new ones as they arrive |
+| `mcp deployments rollback <deployment>` | Roll back to a prior deployment — flips a paused/undeployed deployment back to active and demotes the current latest in one shot. |
+| `mcp deployments runtime-auth <deployment>` | Inspect a deployment's runtime-auth posture (access mode, exchange path, edge policy) |
 
 ### `mcp dev` — Run a deployed MCP server locally with hot reload + agent auto-wire
 
@@ -264,26 +272,26 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 
 | Command | Description |
 | --- | --- |
-| `mcp marketplace fork <artifactId>` | Fork a registry artifact into one of your projects as an editable draft |
-| `mcp marketplace get <artifactId>` | Show full details for one registry artifact (readme, recent versions) |
-| `mcp marketplace install <artifactId>` | Install a published registry artifact (server or skill) into your organization |
+| `mcp marketplace fork <artifact>` | Fork a registry artifact (id or name) into one of your projects as an editable draft |
+| `mcp marketplace get <artifact>` | Show full details for one registry artifact (accepts id or name; readme, recent versions) |
+| `mcp marketplace install <artifact>` | Install a published registry artifact (server or skill; accepts id or name) into your organization |
 | `mcp marketplace list` | List published artifacts in the registry |
-| `mcp marketplace publish <serverId|skillId>` | Publish a deployed server or a versioned skill to the registry (requires org admin) |
-| `mcp marketplace version <artifactId> <versionId>` | Show details for one published version of a registry artifact |
-| `mcp marketplace versions <artifactId>` | List published versions of a registry artifact (paginated) |
+| `mcp marketplace publish <server|skill>` | Publish a deployed server or a versioned skill to the registry (requires org admin) |
+| `mcp marketplace version <artifact> <versionId>` | Show details for one published version of a registry artifact (artifact accepts id or name) |
+| `mcp marketplace versions <artifact>` | List published versions of a registry artifact (accepts id or name) |
 
 ### `mcp metrics` — Aggregate deployment metrics (request volume, error rate)
 
 | Command | Description |
 | --- | --- |
-| `mcp metrics deployment <deploymentId>` | Show aggregate request metrics for a deployment over a window (CI deploy gate) |
+| `mcp metrics deployment <deployment>` | Show aggregate request metrics for a deployment over a window (CI deploy gate) |
 
 ### `mcp oauth` — Manage OAuth provider connections
 
 | Command | Description |
 | --- | --- |
 | `mcp oauth connection` | Inspect or revoke individual OAuth connections |
-| `mcp oauth connection delete <connectionId>` | Revoke an OAuth connection (best-effort upstream revoke; replay-as-success on already-revoked rows) |
+| `mcp oauth connection delete <connection>` | Revoke an OAuth connection by id or provider key (best-effort upstream revoke; replay-as-success on already-revoked rows) |
 | `mcp oauth connections` | List OAuth provider connections across the organization |
 
 ### `mcp orgs` — List and inspect the organizations you belong to
@@ -309,75 +317,75 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | Command | Description |
 | --- | --- |
 | `mcp projects api-source <apiSourceId>` | Show details for a single imported API spec |
-| `mcp projects api-sources <projectId>` | List imported API specs / source material for a project |
+| `mcp projects api-sources <project>` | List imported API specs / source material for a project |
 | `mcp projects create` | Create a new project in an organization |
-| `mcp projects delete <projectId>` | Permanently delete a project. Requires --confirm "<exact name>" and that the project is empty of servers/skills. |
-| `mcp projects get <projectId>` | Get details for a single project |
+| `mcp projects delete <project>` | Permanently delete a project. Requires --confirm "<exact name>" and that the project is empty of servers/skills. |
+| `mcp projects get <project>` | Get details for a single project (accepts id or name) |
 | `mcp projects list` | List projects in an organization |
-| `mcp projects update <projectId>` | Update a project (RFC 7396 merge patch — only listed fields change) |
+| `mcp projects update <project>` | Update a project (RFC 7396 merge patch — only listed fields change) |
 
 ### `mcp servers` — Manage MCP servers
 
 | Command | Description |
 | --- | --- |
 | `mcp servers create` | Create an empty server skeleton in a project |
-| `mcp servers delete <serverId>` | Permanently delete a server and all its data. Requires --confirm "<exact name>". |
-| `mcp servers deploy <serverId>` | Deploy a server's generated bundle to Cloudflare Workers (closes the spec → deploy loop) |
-| `mcp servers deployments <serverId>` | List a server's deployment history |
+| `mcp servers delete <server>` | Permanently delete a server and all its data. Requires --confirm "<exact name>". |
+| `mcp servers deploy <server>` | Deploy a server's generated bundle to Cloudflare Workers (closes the spec → deploy loop) |
+| `mcp servers deployments <server>` | List a server's deployment history |
 | `mcp servers env` | Manage server runtime environment bindings (encrypted secrets injected by the proxy). |
-| `mcp servers env get <serverId> <bindingName>` | Show metadata for one env binding. Plaintext is never returned — values are write-only. |
-| `mcp servers env list <serverId>` | List a server's env bindings (metadata only; values are never returned). |
-| `mcp servers env set <serverId> <bindingName> [value]` | Create or replace an env binding's value. Schedules a Cloudflare-runtime push when the server has an active deployment. |
-| `mcp servers env unset <serverId> <bindingName>` | Remove an env binding. Idempotent — succeeds even if the binding is already gone. |
-| `mcp servers export <serverId>` | Export a self-host bundle (Dockerfile + node entry + config) for a server |
-| `mcp servers generate <serverId>` | Generate the server's TypeScript bundle (the exact code `deploy` ships) and optionally write it to disk — a dry-run for the codegen path. Wraps POST /api/v1/server/generate. |
-| `mcp servers get <serverId>` | Get details for a single server |
+| `mcp servers env get <server> <bindingName>` | Show metadata for one env binding. Plaintext is never returned — values are write-only. |
+| `mcp servers env list <server>` | List a server's env bindings (metadata only; values are never returned). |
+| `mcp servers env set <server> <bindingName> [value]` | Create or replace an env binding's value. Schedules a Cloudflare-runtime push when the server has an active deployment. |
+| `mcp servers env unset <server> <bindingName>` | Remove an env binding. Idempotent — succeeds even if the binding is already gone. |
+| `mcp servers export <server>` | Export a self-host bundle (Dockerfile + node entry + config) for a server |
+| `mcp servers generate <server>` | Generate the server's TypeScript bundle (the exact code `deploy` ships) and optionally write it to disk — a dry-run for the codegen path. Wraps POST /api/v1/server/generate. |
+| `mcp servers get <server>` | Get details for a single server (accepts id, name, or slug) |
 | `mcp servers ingest` | Create a server from an OpenAPI spec (file, URL, or @- stdin) or a GraphQL endpoint. Wraps POST /api/v1/server/ingest. |
 | `mcp servers list` | List servers |
-| `mcp servers logs <serverId>` | Show recent deployment events for a server's latest deployment |
-| `mcp servers oauth-connections <serverId>` | List OAuth provider connections bound to this server |
-| `mcp servers pause <serverId>` | Pause the server's latest active deployment (traffic stops; worker is preserved) |
-| `mcp servers push-spec <serverId>` | Push a local OpenAPI spec to the cloud (regenerates the bundle; optionally deploys) |
-| `mcp servers regenerate <serverId>` | Re-fetch a server's source spec and rebuild its tools with the current codegen (preserves customizations). Wraps POST /api/v1/server/regenerate. |
-| `mcp servers resume <serverId>` | Resume the server's paused deployment (flips dispatch routing back on; only platformWorker deployments support instant resume) |
+| `mcp servers logs <server>` | Show recent deployment events for a server's latest deployment |
+| `mcp servers oauth-connections <server>` | List OAuth provider connections bound to this server |
+| `mcp servers pause <server>` | Pause the server's latest active deployment (traffic stops; worker is preserved) |
+| `mcp servers push-spec <server>` | Push a local OpenAPI spec to the cloud (regenerates the bundle; optionally deploys) |
+| `mcp servers regenerate <server>` | Re-fetch a server's source spec and rebuild its tools with the current codegen (preserves customizations). Wraps POST /api/v1/server/regenerate. |
+| `mcp servers resume <server>` | Resume the server's paused deployment (flips dispatch routing back on; only platformWorker deployments support instant resume) |
 | `mcp servers test-runs` | Inspect and trigger server sandbox test runs |
 | `mcp servers test-runs get <testRunId>` | Show one server test run with assertions, trace, and the tool response |
-| `mcp servers test-runs list <serverId>` | List sandbox test runs for a server |
-| `mcp servers test-runs new <serverId>` | Trigger a sandbox test run against a server's latest deployment (synchronous) |
+| `mcp servers test-runs list <server>` | List sandbox test runs for a server |
+| `mcp servers test-runs new <server>` | Trigger a sandbox test run against a server's latest deployment (synchronous) |
 | `mcp servers test-scenarios` | Inspect server sandbox test scenarios |
 | `mcp servers test-scenarios get <scenarioId>` | Show one server test scenario including its request and expected response |
-| `mcp servers test-scenarios list <serverId>` | List test scenarios bound to a server |
+| `mcp servers test-scenarios list <server>` | List test scenarios bound to a server |
 | `mcp servers test-suites` | Inspect server sandbox test suites (groups of scenarios) |
 | `mcp servers test-suites get <suiteId>` | Show one server test suite including its scenario membership |
-| `mcp servers test-suites list <serverId>` | List test suites bound to a server |
-| `mcp servers update <serverId>` | Update a server (v1 PATCH only carries name and description) |
-| `mcp servers version <serverId> <versionId>` | Show details for a single server version |
-| `mcp servers versions <serverId>` | List published versions of a server |
+| `mcp servers test-suites list <server>` | List test suites bound to a server |
+| `mcp servers update <server>` | Update a server (v1 PATCH only carries name and description) |
+| `mcp servers version <server> <versionId>` | Show details for a single server version |
+| `mcp servers versions <server>` | List published versions of a server |
 
 ### `mcp skills` — Manage skills
 
 | Command | Description |
 | --- | --- |
-| `mcp skills archive <skillId>` | Archive a skill (replay-as-success on already-archived rows) |
-| `mcp skills connect <skillId>` | Print (or apply) the MCP configuration that connects this skill to your coding agent |
+| `mcp skills archive <skill>` | Archive a skill (replay-as-success on already-archived rows) |
+| `mcp skills connect <skill>` | Print (or apply) the MCP configuration that connects this skill to your coding agent |
 | `mcp skills create` | Create an empty skill draft in a project |
-| `mcp skills delete <skillId>` | Permanently delete a draft skill. Requires --confirm "<exact name>". Published skills with versions/installs are rejected (archive instead). |
-| `mcp skills get <skillId>` | Get details for a single skill |
-| `mcp skills install <skillId>` | Install a skill into the caller's project |
-| `mcp skills installations <skillId>` | List the installation footprint of a skill (which orgs / users installed it) |
-| `mcp skills invoke <skillId>` | Run a deployed skill from the terminal. Resolves the skill’s MCP endpoint, auto-discovers its single tool, and calls it. |
+| `mcp skills delete <skill>` | Permanently delete a draft skill. Requires --confirm "<exact name>". Published skills with versions/installs are rejected (archive instead). |
+| `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 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 |
 | `mcp skills test-runs` | Inspect and trigger skill sandbox test runs |
 | `mcp skills test-runs get <testRunId>` | Show one skill test run with assertions, trace, and output |
-| `mcp skills test-runs list <skillId>` | List sandbox test runs for a skill |
-| `mcp skills test-runs new <skillId>` | Trigger a sandbox test run against a skill (synchronous; returns terminal status) |
+| `mcp skills test-runs list <skill>` | List sandbox test runs for a skill |
+| `mcp skills test-runs new <skill>` | Trigger a sandbox test run against a skill (synchronous; returns terminal status) |
 | `mcp skills test-scenarios` | Inspect skill sandbox test scenarios |
 | `mcp skills test-scenarios get <scenarioId>` | Show one skill test scenario including its prompt and assertion body |
-| `mcp skills test-scenarios list <skillId>` | List test scenarios bound to a skill |
-| `mcp skills uninstall <skillId>` | Mark the caller's installation of this skill as removed |
-| `mcp skills update <skillId>` | Update skill metadata (name, description, visibility) |
-| `mcp skills version <skillId> <versionId>` | Show details for one published skill version (workflow summary, triggers, deps) |
-| `mcp skills versions <skillId>` | List published versions of a skill |
+| `mcp skills test-scenarios list <skill>` | List test scenarios bound to a skill |
+| `mcp skills uninstall <skill>` | Mark the caller's installation of this skill as removed |
+| `mcp skills update <skill>` | Update skill metadata (name, description, visibility) |
+| `mcp skills version <skill> <versionId>` | Show details for one published skill version (workflow summary, triggers, deps) |
+| `mcp skills versions <skill>` | List published versions of a skill |
 
 ### `mcp tools` — Inspect and edit tools on a project or server