@init-computer/mcp 0.1.1 → 0.1.2

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,114 @@ 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`
 
-## Available tools
+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" }
+```
 
-- `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.
+## Protocol behavior
 
-Init returns structured JSON for every tool call, including endpoint routes, schemas, versions, and results.
+The server uses MCP stdio transport and returns JSON text content for every tool call. It does not upload local files, read repository secrets, or manage a local project directory. Use the CLI for terminal workflows and the SDK for application code.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@init-computer/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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"
   },
   "dependencies": {
-    "@init-computer/sdk": "0.1.4"
+    "@init-computer/sdk": "0.1.5"
   },
   "engines": {
     "node": ">=18"