ashlr-stack-mcp 0.1.1 → 0.2.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Ashlr / Mason Wyatt
+Copyright (c) 2026 AshlrAI, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,6 +1,6 @@
 # ashlr-stack-mcp
 
-> MCP server for [Ashlr Stack](https://stack.ashlr.ai). Exposes 17 tools and 3 resources so Claude Code / Cursor / Windsurf / Codex can provision every third-party service in a project with one call.
+> MCP server for [Ashlr Stack](https://stack.ashlr.ai). Exposes 19 tools and up to 3 resources so Claude Code / Cursor / Windsurf / Codex can provision every third-party service in a project with one call.
 
 ## What it does
 
@@ -8,14 +8,14 @@
 
 ## Install
 
-One-liner (installs both `stack` and `ashlr-stack-mcp`):
+One-liner. It installs `stack`, plus `ashlr-stack-mcp` when it installs from npm or from source; when it installs the prebuilt `stack` binary from GitHub Releases, it prints how to add the MCP server (`npm i -g ashlr-stack-mcp`, or `npx -y ashlr-stack-mcp`):
 
 ```bash
 # macOS / Linux
 curl -fsSL stack.ashlr.ai/install.sh | bash
 
 # Windows (PowerShell)
-irm stack.ashlr.ai/install.ps1 | iex
+irm https://stack.ashlr.ai/install.ps1 | iex
 ```
 
 Or manually from the registry:
@@ -26,9 +26,11 @@ bun add -g ashlr-stack-mcp @ashlr/stack
 npm i -g ashlr-stack-mcp @ashlr/stack
 ```
 
+Every tool runs the `stack` CLI, so install `@ashlr/stack` alongside this package (or set `STACK_BIN` to the CLI). Without it the server starts and lists its tools, but each call returns "Could not run the 'stack' CLI" with the fix. The npm 0.1.1 release runs on Bun, so Bun must be installed. In source 0.2.1 this package depends on `@ashlr/stack` and runs that dependency's `stack` bin; the order is `STACK_BIN`, then that bin, then `stack` on PATH.
+
 ## Wire it into your agent
 
-Drop this into your project's `.mcp.json` (Claude Code, Cursor, Windsurf, Codex — all read the same shape):
+Drop this into your project's `.mcp.json` (Claude Code, Cursor and Windsurf read this shape; Codex uses `codex mcp add ashlr-stack -- ashlr-stack-mcp`, which writes `~/.codex/config.toml`):
 
 ```json
 {
@@ -47,23 +49,42 @@ If you installed from source (no global bin), point at the entry directly:
   "mcpServers": {
     "ashlr-stack": {
       "command": "bun",
-      "args": ["run", "/absolute/path/to/ashlr-stack/packages/mcp/src/server.ts"]
+      "args": ["run", "/absolute/path/to/ashlr-stack/packages/mcp/src/server.ts"],
+      "env": { "STACK_BIN": "/absolute/path/to/ashlr-stack/packages/cli/src/index.ts" }
     }
   }
 }
 ```
 
-## Tools (17)
+## Targeting a project (`cwd`)
+
+Every tool runs `stack` in the server's working directory unless you pass `cwd`. When your client starts the server outside the project (Claude Desktop, a global Cursor or Windsurf config), pass the project's absolute path:
+
+```json
+{ "name": "stack_list", "arguments": { "json": true, "cwd": "/home/me/code/my-app" } }
+```
+
+`cwd` is accepted by the project-scoped tools, the ones that read or write `.stack.toml` or other project files: `stack_init`, `stack_import`, `stack_scan`, `stack_add`, `stack_remove`, `stack_list`, `stack_info`, `stack_status`, `stack_env_show`, `stack_env_diff`, `stack_doctor`, `stack_sync`, `stack_deps`, `stack_recommend` and `stack_apply`. It must be an absolute path to an existing directory; it is resolved with realpath, and a relative path, a missing path or a file returns an `isError` result without running anything. It grants nothing beyond what the server's own working directory already does. The global tools (`stack_providers`, `stack_projects_list`, `stack_templates_list`, `stack_upgrade`) refuse `cwd` instead of ignoring it. There is no environment-variable default; start the server in the project or pass `cwd`.
+
+## Tools (19)
 
 Provisioning: `stack_init`, `stack_add`, `stack_remove`, `stack_import`, `stack_scan`.
 
-Inspection: `stack_list`, `stack_info`, `stack_providers`, `stack_deps`, `stack_doctor`.
+Inspection: `stack_list`, `stack_info`, `stack_status`, `stack_providers`, `stack_templates_list`, `stack_deps`, `stack_doctor`. `stack_list`, `stack_providers`, `stack_deps`, `stack_templates_list` and `stack_projects_list` take `json: true` to return the CLI's `--json` object instead of human text.
+
+Env: `stack_env_show`, `stack_env_diff`, `stack_sync`.
+
+`stack_info` and `stack_env_show` take `json: true` to return `stack info --json` (`ashlr.stack.info/v1`) and `stack env show --json` (`ashlr.stack.env/v1`) instead of human text.
+
+Planning: `stack_recommend`, `stack_apply`.
+
+Project registry: `stack_projects_list` (`json: true` returns `stack projects list --json`), `stack_upgrade`.
 
-Env: `stack_env_show`, `stack_env_diff`, `stack_env_set`, `stack_env_unset`.
+Every tool rejects an argument name its input schema does not declare, and lists the accepted ones, rather than running without it. A blank string (`"  "`) counts as missing for a required argument and is rejected for an optional one.
 
-Project registry: `stack_projects_list`, `stack_upgrade`.
+## Resources (up to 3)
 
-## Resources (3)
+Each is listed only when the file exists in the server's working directory (resources do not take `cwd`).
 
 - `stack://current/.stack.toml`
 - `stack://current/.stack.local.toml`
@@ -75,7 +96,7 @@ Full tool + resource reference: **[stack.ashlr.ai/docs/mcp](https://stack.ashlr.
 
 ## How secrets are handled
 
-Stack never stores secret values. Every tool call routes through [Phantom Secrets](https://phantom.ashlr.ai) on your machine. The agent only sees slot *names* (like `SUPABASE_URL`, `SUPABASE_ANON_KEY`) — never the values.
+Stack never stores secret values. Every tool call routes through [Phantom Secrets](https://phm.dev/secrets) on your machine. The agent only sees slot *names* (like `SUPABASE_URL`, `SUPABASE_ANON_KEY`) — never the values.
 
 ## Links