@mcpcloud/cli 0.15.0 → 0.17.0-next-20260807015618

package/README.md

@@ -165,9 +165,11 @@ _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 <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 invoke <server> [tool]` | Call a tool on a deployed MCP server — or, with --local, boot this directory’s bundle once and call it there. |
 | `mcp login` | Sign in via browser (default) or paste an API key |
 | `mcp logout` | Remove the saved API key from ~/.mcpcloud/config.json |
+| `mcp pull` | Materialize a server’s working tree here: every tool as .md, every handler as .ts, plus the sync baseline `push` diffs against |
+| `mcp push` | Push local tool metadata and handler edits back to the cloud (diffed against your last pull) |
 | `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 |
@@ -347,7 +349,7 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `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 push-spec <server>` | Regenerate a server’s bundle from a local OpenAPI spec. Previews the tool changes; --apply writes them. |
 | `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 |
@@ -355,11 +357,16 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `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 generate <server>` | Seed one baseline smoke-test scenario per tool from the tools’ schemas (safe to re-run) |
 | `mcp servers test-scenarios get <scenarioId>` | Show one server test scenario including its request and expected response |
 | `mcp servers test-scenarios list <server>` | List test scenarios bound to a server |
+| `mcp servers test-scenarios new <server>` | Author a test scenario for one of the server’s tools |
+| `mcp servers test-scenarios rm <server> <scenarioId>` | Archive a test scenario |
+| `mcp servers test-scenarios update <server> <scenarioId>` | Update a test scenario (only the flags you pass change) |
 | `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 <server>` | List test suites bound to a server |
+| `mcp servers test-suites run <server>` | Run the server’s test scenarios and report the suite result |
 | `mcp servers update <server>` | Update a server (name, description, runtime token TTL) |
 | `mcp servers version <server> <versionId>` | Show details for a single server version |
 | `mcp servers versions <server>` | List published versions of a server |
@@ -372,19 +379,27 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `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 <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 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 publish <skill>` | Cut an immutable version of a skill |
 | `mcp skills pull <registryArtifactId>` | Download an installed skill as SKILL.md + mcpcloud.json for your coding agent |
+| `mcp skills set-content <skill>` | Write a skill’s authored content: instructions, dependencies, guardrails, schemas, composition graph |
 | `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 <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 generate <skill>` | Seed suggested scenarios from the skill’s examples and its dependencies’ tools (safe to re-run) |
 | `mcp skills test-scenarios get <scenarioId>` | Show one skill test scenario including its prompt and assertion body |
 | `mcp skills test-scenarios list <skill>` | List test scenarios bound to a skill |
+| `mcp skills test-scenarios new <skill>` | Author a sandbox test scenario for a skill |
+| `mcp skills test-scenarios rm <skill> <scenarioId>` | Archive a skill test scenario |
+| `mcp skills test-scenarios update <skill> <scenarioId>` | Update a skill test scenario (only the flags you pass change) |
+| `mcp skills token <skill>` | Reveal the skill’s runtime bearer token (--rotate issues a new one and invalidates the old) |
 | `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) |