nodestorm-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,27 +1,26 @@
 # nodestorm-mcp
 
-MCP (Model Context Protocol) server for NodeStorm workflow automation.
+MCP (Model Context Protocol) server for [NodeStorm](https://nodestorm.ai) workflow automation.
 
 ## Installation
 
-```bash
-npx nodestorm-mcp
-```
-
-Or install globally:
+No install step needed — MCP clients run it via `npx`:
 
 ```bash
-npm install -g nodestorm-mcp
+npx -y nodestorm-mcp
 ```
 
 ## Configuration
 
-### Claude Code / Claude Desktop
+### Claude Code
+
+From your project directory:
 
-Add to your Claude configuration file:
+```bash
+claude mcp add nodestorm -e NODESTORM_API_KEY=ns_your_access_token_here -- npx -y nodestorm-mcp
+```
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+Or add to a `.mcp.json` in your project root (or `~/.claude.json` for all projects):
 
 ```json
 {
@@ -37,6 +36,13 @@ Add to your Claude configuration file:
 }
 ```
 
+### Claude Desktop
+
+Add the same `mcpServers` block to:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
 ### Environment Variables
 
 | Variable | Required | Description |
@@ -72,10 +78,18 @@ Output: { id, name, nodes, edges, url, updated_at }
 ```
 
 ### update_flow
-Modify an existing workflow.
+Update workflow **metadata** (name, description, schedule). Does not modify nodes or edges — use `update_flow_structure` for that.
 
 ```
-Input: { id: "abc123", flow: { name, nodes, edges } }
+Input: { id: "abc123", flow: { name, description, schedule_enabled, ... } }
+Output: { id, name, nodes, edges, url, updated_at }
+```
+
+### update_flow_structure
+Apply a list of structural operations (add/update/remove nodes and edges) atomically to an existing workflow.
+
+```
+Input: { flow_id: "abc123", operations: [{ op: "add_node", ... }, ...] }
 Output: { id, name, nodes, edges, url, updated_at }
 ```
 
@@ -88,21 +102,13 @@ Output: { success: true }
 ```
 
 ### list_flows
-List all your workflows.
+List or search your workflows (`scope: "public"` searches published community entries).
 
 ```
-Input: { limit: 20, offset: 0 }
+Input: { query: "pricing", scope: "user", limit: 20 }
 Output: { flows: [...], total }
 ```
 
-### validate_flow
-Check if a workflow is valid before saving.
-
-```
-Input: { flow: { nodes, edges } }
-Output: { valid: true } or { valid: false, errors: [...] }
-```
-
 ### describe_nodes
 Get node type definitions (no API call).
 
@@ -111,6 +117,30 @@ Input: { types: ["prompt", "list"] } // optional filter
 Output: { nodes: [{ type, description, category, config_schema, handles }] }
 ```
 
+### get_flow_run
+Get details of a specific flow run, including execution results and node outputs.
+
+```
+Input: { id: "run123" }
+Output: { id, flow_id, status, node_results, started_at, finished_at }
+```
+
+### list_flow_runs
+List flow runs with optional filters, for debugging and monitoring.
+
+```
+Input: { flow_id: "abc123", status: "failed", limit: 20 }
+Output: { runs: [...], total }
+```
+
+### search_chat_history
+Semantic (meaning-based) search over your past NodeStorm chat messages.
+
+```
+Input: { query: "how did I set up the scraper flow", limit: 10 }
+Output: { messages: [...] }
+```
+
 ## Resources
 
 ### workflow-guide
@@ -131,7 +161,7 @@ Created "Competitor Pricing Analysis"
 
 User: Add 3 more URLs to the list
 
-Claude: [Uses get_flow, modifies nodes, uses update_flow]
+Claude: [Uses update_flow_structure with add_node/add_edge operations]
 Updated flow with 3 additional URLs.
 ```
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "nodestorm-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for NodeStorm workflow automation",
   "type": "module",
   "bin": {
-    "nodestorm-mcp": "./dist/index.js"
+    "nodestorm-mcp": "dist/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,7 +31,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/nodestorm/nodestorm-mcp"
+    "url": "git+https://github.com/nodestorm/nodestorm-mcp.git"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"