@init-computer/mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,10 +1,8 @@
 # Init MCP
 
-Use Init from any MCP-compatible assistant or development tool. Init turns a natural-language request into a deployed backend endpoint or project, then lets you run and inspect the result.
+Use Init from any MCP-compatible assistant or development tool. Init turns a natural-language request into a deployed backend endpoint or project and returns structured JSON with routes, schemas, versions, and results.
 
-Init is a programmable backend platform: describe the capability you need, and Init creates and operates the API, data, storage, and runtime behind it.
-
-Documentation: [Init.computer](https://www.init.computer)
+Documentation: [Init.computer](https://init.computer)
 
 ## Install
 
@@ -12,16 +10,118 @@ Documentation: [Init.computer](https://www.init.computer)
 npm install -g @init-computer/mcp
 ```
 
-Set `INIT_API_KEY` in the MCP process environment, then register the `init-mcp` command with your MCP client.
+Requires Node.js 18 or later.
+
+## Configure authentication
+
+The MCP server is stateless and reads the API key from its process environment. It never stores the key itself:
+
+```bash
+export INIT_API_KEY=init_sk_...
+export INIT_API_BASE_URL=https://api.init.computer
+```
+
+Keep the key in the MCP client's secret/environment configuration, not in a prompt or checked-in file.
+
+## Register with an MCP client
+
+```json
+{
+  "mcpServers": {
+    "init": {
+      "command": "init-mcp",
+      "env": {
+        "INIT_API_KEY": "init_sk_...",
+        "INIT_API_BASE_URL": "https://api.init.computer"
+      }
+    }
+  }
+}
+```
+
+Run the server directly for a stdio client:
+
+```bash
+init-mcp
+```
+
+## Tools
+
+### `init_generate`
+
+Create an endpoint, or create a new version of an existing endpoint with `resource_id`.
+
+```json
+{
+  "prompt": "Create an API that reviews source code for security issues.",
+  "resource_id": "optional-resource-id",
+  "projects": ["Security"]
+}
+```
+
+### `init_generate_project`
+
+Create a project and a cohesive endpoint suite.
+
+```json
+{
+  "name": "Customer Support",
+  "prompt": "Build ticket intake and status lookup."
+}
+```
+
+### `init_edit_project`
+
+Add endpoints or create new endpoint versions in an existing project.
+
+```json
+{
+  "project_id": "project_uuid",
+  "prompt": "Add ticket assignment."
+}
+```
+
+### `init_run`
+
+Call a generated endpoint by route, `/vN/...` path, or full URL.
+
+```json
+{
+  "route": "abc123",
+  "version": 1,
+  "input": { "topic": "sports players" },
+  "requestFormat": "json"
+}
+```
+
+### `init_list_resources`
+
+List the authenticated user's generated resources. Optional filters such as `q` and `status` are passed through.
+
+```json
+{ "q": "sales", "status": "enabled" }
+```
+
+### `init_get_resource`
+
+Fetch one resource by id:
+
+```json
+{ "id": "resource_uuid" }
+```
+
+### `init_list_packages`
+
+Inspect available runtime packages and enabled connections. Filter by `category`, for example `Database` or `Storage`.
+
+```json
+{ "category": "Database" }
+```
+
+## Protocol behavior
 
-## Available tools
+The server uses MCP stdio transport and returns JSON text content for every tool call. It does not upload repository secrets; its file tool reads and writes only the explicit `init.json` path supplied to it.
 
-- `init_generate` — create an endpoint from a prompt, optionally attaching it to existing projects.
-- `init_generate_project` — create a project and a cohesive endpoint suite.
-- `init_edit_project` — add endpoints or create new endpoint versions in a project.
-- `init_run` — call a generated endpoint.
-- `init_list_resources` — list generated endpoints.
-- `init_get_resource` — inspect one generated endpoint.
-- `init_list_packages` — inspect the available capability packages.
+## Repository init.json integration
 
-Init returns structured JSON for every tool call, including endpoint routes, schemas, versions, and results.
+Use `init_apply_project_file` with an explicit local `init.json` path and an edit request. The MCP server reads that one file, finds `project.id`, applies the edit to the matching Init project, and writes the canonical contract back to the same path. For agents that already have a parsed document, use `init_apply_project_manifest`; it returns the updated `initJson` without touching the filesystem.

package/bin/init-mcp.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
 import readline from "node:readline";
 import { InitApiError, createClient } from "../../sdk/dist/index.js";
 
@@ -34,6 +36,24 @@ const tools = [
 		inputSchema: objectSchema({ project_id: stringSchema("Project id."), prompt: stringSchema("Project change request.") }, ["project_id", "prompt"]),
 		handler: ({ project_id, prompt }) => client.project.edit(project_id, { prompt }),
 	},
+	{
+		name: "init_apply_project_manifest",
+		description: "Create a project from init.json, or apply an edit to the project identified by its init.json and return its updated canonical contract.",
+		inputSchema: objectSchema({ manifest: freeObjectSchema("The parsed init.json document."), prompt: optionalStringSchema("Change request when the manifest belongs to an existing project.") }, ["manifest"]),
+		handler: ({ manifest, prompt }) => client.project.applyInitJson(manifest, { prompt }),
+	},
+	{
+		name: "init_apply_project_file",
+		description: "Read an explicit local init.json path, apply an Init project edit, and write the returned canonical init.json back to that same path.",
+		inputSchema: objectSchema({ path: stringSchema("Absolute or working-directory-relative init.json path."), prompt: stringSchema("Project change request.") }, ["path", "prompt"]),
+		handler: async ({ path: filePath, prompt }) => {
+			const absolute = path.resolve(filePath);
+			const manifest = JSON.parse(fs.readFileSync(absolute, "utf8"));
+			const output = await client.project.applyInitJson(manifest, { prompt });
+			fs.writeFileSync(absolute, `${JSON.stringify(output.initJson, null, 2)}\n`, "utf8");
+			return { ...output.result, initJsonPath: absolute, initJsonUpdated: true };
+		},
+	},
   {
     name: "init_run",
     description: "Call a generated Init API route.",

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@init-computer/mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Init is a programmable backend platform available through MCP for generating and running backend APIs.",
   "type": "module",
   "bin": {
-    "init-mcp": "./bin/init-mcp.js"
+    "init-mcp": "bin/init-mcp.js"
   },
   "dependencies": {
-    "@init-computer/sdk": "0.1.4"
+    "@init-computer/sdk": "0.1.6"
   },
   "engines": {
     "node": ">=18"