@cloudgrid-io/mcp 0.20.13 → 0.20.15

package/src/corpus/workflows/lms.md

@@ -53,9 +53,10 @@ you build it from the guide.
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**
 per the AGENTS.md tree, and (b) fill `cloudgrid.yaml` to the shape below.
 
 ## 5. cloudgrid.yaml + wiring

package/src/corpus/workflows/marketplace.md

@@ -54,9 +54,11 @@ There is no app code to copy — you generate it from the guide.
 
 ## 4. Scaffold + fill cloudgrid.yaml
 
-`grid_create_project` an app `<name>` FIRST (creates the entity + `.cloudgrid/link.json`
-and a starter `cloudgrid.yaml` with empty `services:{}`; `plug` needs a linked
-directory). Then put the app under **`services/web/`** and set `cloudgrid.yaml` to
+`grid_create_project` an app `<name>` — it scaffolds the project folder and a
+starter `cloudgrid.yaml` with empty `services:{}` (no server entity yet; the
+first `grid plug` auto-creates it from the manifest, honoring its `name:`, and
+writes `.cloudgrid/link.json`). Then put the app under **`services/web/`** and
+set `cloudgrid.yaml` to
 the blueprint's active fields:
 
 ```yaml

package/src/corpus/workflows/membership-site.md

@@ -53,9 +53,10 @@ workflow:
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then write the app under **`services/web/`** and
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then write the app under **`services/web/`** and
 set `cloudgrid.yaml` to the active shape below.
 
 ## 5. Build the app following AGENTS.md

package/src/corpus/workflows/monitoring-dashboard.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/online-store.md

@@ -40,9 +40,9 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST.
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
 
 ## 4. Fetch the blueprint and read AGENTS.md
 

package/src/corpus/workflows/product-catalog.md

@@ -41,9 +41,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/project-management.md

@@ -42,9 +42,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/property-listings.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/quiz-platform.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/restaurant-reservations.md

@@ -56,9 +56,10 @@ so the deliverable is `cloudgrid.yaml` + `AGENTS.md`, not app code.
 
 ## 4. Scaffold + fill
 
-1. `grid_create_project` an app `<name>` — creates the entity + `.cloudgrid/link.json`
-   and a `cloudgrid.yaml` with an EMPTY `services: {}`. Run `init` FIRST (plug
-   needs a linked directory).
+1. `grid_create_project` an app `<name>` — scaffolds the project folder and a
+   `cloudgrid.yaml` with an EMPTY `services: {}`. No server entity exists yet —
+   the first `grid plug` auto-creates it from the manifest (honoring its
+   `name:`) and writes `.cloudgrid/link.json`.
 2. Write the app under **`services/web/`** (`path:` is the URL mount, NOT the
    filesystem path), following `AGENTS.md`.
 3. Set `cloudgrid.yaml` to the blueprint's active fields:

package/src/corpus/workflows/revenue-dashboard.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/semantic-search.md

@@ -42,9 +42,11 @@ the **local edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>` FIRST — it creates the entity +
-`.cloudgrid/link.json` and a starter `cloudgrid.yaml` with empty `services: {}`
-(`plug` needs a linked directory).
+`grid_create_project` an app `<name>` — it scaffolds the project folder and a
+starter `cloudgrid.yaml` with empty `services: {}`. No server entity exists yet:
+the first `grid plug` auto-creates it from the manifest (honoring its `name:`)
+and writes `.cloudgrid/link.json`; `grid plug --no-deploy` registers it without
+deploying (useful to set secrets first).
 
 ## 4. Fetch the template and READ AGENTS.md
 

package/src/corpus/workflows/simple-semantic-search.md

@@ -5,7 +5,7 @@ needs: vector, ai
 deploy: runtime
 editions: local
 capabilities_note: "vector search — needs: { vector: pgvector } (injects VECTOR_PGVECTOR_URL; #1545 shipped, verified live 2026-07-16) + ai: true (embeddings via @cloudgrid-io/runtime, no API key). Runtime app, async build, local edition only."
-summary: "One node service that embeds a document into the entity's own pgvector schema at startup and serves POST /search + a minimal UI — probe-sized vector column, idempotent background seed, /health 503-until-ready, cosine <=> ranking. grid init app --here, grid plug, live in ~3 minutes."
+summary: "One node service that embeds a document into the entity's own pgvector schema at startup and serves POST /search + a minimal UI — probe-sized vector column, idempotent background seed, /health 503-until-ready, cosine <=> ranking. grid plug (auto-creates the entity from cloudgrid.yaml), live in ~3 minutes."
 ---
 
 # Workflow: simple-semantic-search
@@ -47,13 +47,13 @@ services:
 ## 4. Deploy
 
 ```bash
-grid init app <name> --here    # registers the entity, writes .cloudgrid/link.json
-grid plug                      # async build — live URL in ~2-3 minutes
+grid plug                      # first plug registers the entity from cloudgrid.yaml
+                               # (honors its name:), then async build — live URL in ~2-3 minutes
 grid visibility set <slug> link
 ```
 
-`.cloudgrid/link.json` (entity_id / org / slug binding) is WRITTEN BY THE CLI —
-never hand-author it. If the folder was copied from someone else's project,
+`.cloudgrid/link.json` (entity_id / org / slug binding) is WRITTEN BY THE CLI on
+the first `grid plug` — never hand-author it. If the folder was copied from someone else's project,
 `rm -rf .cloudgrid` first so `grid plug` doesn't update THEIR app.
 
 ## 5. Verify like it's real

package/src/corpus/workflows/subscription-management.md

@@ -60,9 +60,10 @@ workflow:
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then write the app under **`services/web/`** and
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then write the app under **`services/web/`** and
 set `cloudgrid.yaml` to the active shape below.
 
 ## 5. Build the app following AGENTS.md

package/src/corpus/workflows/task-manager.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/ticket-system.md

@@ -37,9 +37,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/time-tracking.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/travel-booking.md

@@ -51,9 +51,9 @@ edition** (Claude Desktop / Claude Code) or the CLI.
    `flights` / `hotels` / `bookings` / `trips` collections + the overbooking
    guard, how CloudGrid injects the DB and vault secrets, how to wire Stripe +
    auth, and the trip-reminder-cron design).
-2. `grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-   and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a
-   linked directory, so run `init` FIRST.
+2. `grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
 
 ## 4. Build the app + set cloudgrid.yaml
 

package/src/tools/deploy.js

@@ -1462,7 +1462,7 @@ export async function runPlug(ctx, input, deps = {}) {
     lines.push(`Updated in place: ${url}`);
   } else if (isInspirationCreate) {
     // Authed inspiration create — owned by the caller. Wording mirrors the drop verb.
-    lines.push(ctx.edition === "web" ? `Your app is live: ${url}` : `Published to your org: ${url}`);
+    lines.push(ctx.edition === "web" ? `Your app is live: ${url}` : `Published to your grid: ${url}`);
     if (ctx.edition !== "web") lines.push("Owned by you.");
   } else {
     lines.push(`Live: ${url}`);

package/src/tools/register.js

@@ -101,7 +101,7 @@ export function registerTools(server, ctx) {
     }));
 
     server.registerResource("cloudgrid-org-picker", GRID_PICKER_URI, {
-      description: "Org picker card — lets the user choose which organization to publish into.",
+      description: "Grid picker card — lets the user choose which grid to publish into.",
       mimeType: "text/html;profile=mcp-app",
     }, async () => ({
       contents: [{
@@ -593,7 +593,7 @@ export function registerTools(server, ctx) {
       inputSchema: {
         visibility: z.enum(["private", "space", "authenticated", "org", "link"]).describe("The new scope."),
         target: z.string().optional().describe("Entity id. Defaults to this session's last drop."),
-        org: z.string().optional().describe("Org of the entity. Defaults to the active org."),
+        org: z.string().optional().describe("Grid of the entity. Defaults to the active grid."),
       },
       outputSchema: {
         visibility: z.string().describe("The visibility that was set."),
@@ -619,11 +619,11 @@ export function registerTools(server, ctx) {
       outputSchema: {
         orgs: z.array(z.object({
           slug: z.string().describe("Org slug."),
-          name: z.string().describe("Human-readable org name."),
-          role: z.string().describe("User's role in the org."),
-          is_active: z.boolean().optional().describe("True if this is the user's currently active org."),
-          render_ready: z.boolean().describe("True if the org's DNS and TLS are provisioned and pages will load. False means the org is still being set up."),
-        })).describe("The user's org memberships."),
+          name: z.string().describe("Human-readable grid name."),
+          role: z.string().describe("User's role in the grid."),
+          is_active: z.boolean().optional().describe("True if this is the user's currently active grid."),
+          render_ready: z.boolean().describe("True if the grid's DNS and TLS are provisioned and pages will load. False means the grid is still being set up."),
+        })).describe("The user's grid memberships."),
       },
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
     },
@@ -852,7 +852,7 @@ export function registerTools(server, ctx) {
       type: z.enum(["node", "nextjs", "python", "static"]).optional().describe("Seed a web service of this type."),
       description: z.string().optional().describe("Initial one-line description."),
       dir: z.string().optional().describe("Target directory. Defaults to ./<name>."),
-      org: z.string().optional().describe("Override the active org for this init."),
+      org: z.string().optional().describe("Override the active grid for this project."),
       cwd: z.string().optional().describe("Working directory. The CLI runs in this directory. Defaults to the MCP server's working directory."),
     },
     { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
@@ -902,7 +902,7 @@ export function registerTools(server, ctx) {
 
   regTool(
     "grid_feedback",
-    "List recent feedback events for the active org. Read-only. Wraps `grid feedback list`.",
+    "List recent feedback events for the active grid. Read-only. Wraps `grid feedback list`.",
     {
       since: z.string().optional().describe("Only events newer than this, e.g. 24h, 7d."),
       limit: z.number().int().positive().max(200).optional().describe("Number of events. Default 50, max 200."),
@@ -923,7 +923,7 @@ export function registerTools(server, ctx) {
 
   regTool(
     "grid_whoami",
-    "Show the signed-in user and active org. Wraps `grid whoami`.",
+    "Show the signed-in user and active grid. Wraps `grid whoami`.",
     {},
     { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
     cliTool(() => ["whoami"]),
@@ -931,7 +931,7 @@ export function registerTools(server, ctx) {
 
   regTool(
     "grid_switch_grid",
-    "Switch the active org. Wraps `grid use`.",
+    "Switch the active grid. Wraps `grid use`.",
     { org: z.string().describe("Org slug to switch to.") },
     { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
     cliTool(({ org }) => ["use", org]),