@statelyai/mcp 0.8.4 → 0.8.7

package/README.md

@@ -3,11 +3,69 @@
 Validate, execute, explore, compare, convert, and visualize state machines from
 an MCP-compatible agent.
 
-## Connect
+## Two ways to run it
+
+**Local (stdio).** `npx @statelyai/mcp` runs the server on your machine. Use it
+when you want the server in-process, or when you need to point the tools at your
+own Stately deployment.
+
+**Hosted (HTTP).** `https://mcp.stately.ai/mcp` needs no local install and adds
+the [hosted resource tools](#hosted-resource-tools) that read your Stately
+projects.
+
+**Both require a Stately credential.** Only `list_machines` and `get_machine`
+run entirely on your machine; every other tool sends the machine to Stately's
+HTTP API, which rejects unauthenticated calls with `Missing authentication.`
+Running locally changes *where the process lives*, not *whether you need an
+account*.
+
+### Local (stdio)
+
+Add this to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "stately": {
+      "command": "npx",
+      "args": ["-y", "@statelyai/mcp"],
+      "env": { "STATELY_ACCESS_TOKEN": "..." }
+    }
+  }
+}
+```
+
+Or install it and run the `stately-mcp` binary directly:
+
+```bash
+npm install -g @statelyai/mcp
+stately-mcp
+```
+
+Credentials are read from `STATELY_ACCESS_TOKEN`, `STATELY_API_KEY`, or the
+config written by `statelyai login`.
+
+The API defaults to `https://editor.stately.ai/api`. Point it at a self-hosted
+deployment with `STATELY_API_BASE_URL`:
+
+```json
+{
+  "mcpServers": {
+    "stately": {
+      "command": "npx",
+      "args": ["-y", "@statelyai/mcp"],
+      "env": { "STATELY_API_BASE_URL": "https://stately.internal/api" }
+    }
+  }
+}
+```
+
+## Connect to the hosted endpoint
 
 <!-- public Stately MCP URL -->
 
-Choose your client and add Stately MCP using one of these methods.
+Choose your client and add Stately MCP using one of these methods. Each ends in
+a Stately sign-in; to run the server locally instead, see [Local (stdio)](#local-stdio) above.
 
 ### Codex