schemeog-mcp 2.6.0 → 2.6.1

package/README.md

@@ -1,15 +1,16 @@
-# SchemeOG MCP Server v2.2
+# SchemeOG MCP Server v2.6
 
 MCP server for [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — create diagrams and flowcharts with AI.
 
-## 14 Commands
+## 15 Commands
 
-### Schemas (5 commands)
+### Schemas (6 commands)
 
 | Command | Description |
 |---------|-------------|
 | `list_schemas` | List all schemas |
-| `get_schema` | Get schema with data |
+| `get_schema` | Get schema by ID |
+| `get_schema_by_url` | Get schema by URL (canvas or shared link) |
 | `create_schema` | Create new schema |
 | `replace_schema` | Replace schema content |
 | `delete_schema` | Delete schema |
@@ -70,7 +71,9 @@ In `~/.claude.json` (or Cline settings):
 
 ## Schema Data Format
 
-### Full schema example
+### Full schema example (inline connections)
+
+Connections are defined **inside each element** in the `connections` array:
 
 ```json
 {
@@ -82,49 +85,65 @@ In `~/.claude.json` (or Cline settings):
       "type": "card",
       "title": "Registration Form",
       "color": "light_green",
+      "x": 100,
+      "y": 100,
       "tags": ["user"],
-      "description": "User fills in email and password"
+      "description": "User fills in email and password",
+      "connections": [
+        {"to": "validate", "label": "submit"}
+      ]
     },
     {
       "id": "validate",
       "type": "condition",
       "title": "Validate Data",
       "color": "light_yellow",
+      "x": 300,
+      "y": 100,
       "tags": ["system", "check"],
-      "description": "Check email format and password strength"
+      "description": "Check email format and password strength",
+      "connections": [
+        {"to": "save", "label": "valid"},
+        {"to": "error", "label": "invalid", "style": "dashed"}
+      ]
     },
     {
       "id": "save",
       "type": "card",
       "title": "Save to Database",
       "color": "light_blue",
+      "x": 500,
+      "y": 50,
       "tags": ["system"],
-      "description": "Create user record in database"
+      "description": "Create user record in database",
+      "connections": [
+        {"to": "success"}
+      ]
     },
     {
       "id": "error",
       "type": "card",
       "title": "Validation Error",
       "color": "light_red",
+      "x": 500,
+      "y": 150,
       "tags": ["system", "error"],
-      "description": "Show validation errors to user"
+      "description": "Show validation errors to user",
+      "connections": [
+        {"to": "start", "label": "retry"}
+      ]
     },
     {
       "id": "success",
       "type": "card",
       "title": "Registration Complete",
       "color": "light_green",
+      "x": 700,
+      "y": 100,
       "tags": ["user"],
       "description": "User successfully registered"
     }
   ],
-  "connections": [
-    {"from": "start", "to": "validate", "label": "submit"},
-    {"from": "validate", "to": "save", "label": "valid"},
-    {"from": "validate", "to": "error", "label": "invalid"},
-    {"from": "save", "to": "success"},
-    {"from": "error", "to": "start", "label": "retry"}
-  ],
   "tagsDictionary": [
     {"id": "tag-user", "name": "user", "color": "#4CAF50"},
     {"id": "tag-system", "name": "system", "color": "#2196F3"},
@@ -142,8 +161,14 @@ In `~/.claude.json` (or Cline settings):
   "type": "card",
   "title": "Card Title",
   "color": "light_blue",
+  "x": 100,
+  "y": 200,
   "tags": ["tag1", "tag2"],
-  "description": "Detailed description of the action or process"
+  "description": "Detailed description",
+  "borderColor": "blue",
+  "connections": [
+    {"to": "next_element_id", "label": "optional label"}
+  ]
 }
 ```
 
@@ -151,6 +176,10 @@ In `~/.claude.json` (or Cline settings):
 - `card` — regular process/action card
 - `condition` — decision point (diamond shape)
 
+**Coordinates (`x`, `y`):**
+- Optional but recommended for precise positioning
+- If omitted, auto-layout will arrange elements
+
 **Available colors (`color`):**
 | Color | Purpose |
 |-------|---------|
@@ -167,20 +196,19 @@ In `~/.claude.json` (or Cline settings):
 
 **Border colors (`borderColor`):** `default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
 
-**Important:** Do NOT specify `width`, `height`, `x`, `y` — they are calculated automatically!
+### Connection (inline format)
 
-### Connection
+Connections are defined inside each element's `connections` array:
 
 ```json
 {
-  "from": "source_id",
-  "to": "target_id",
-  "label": "optional label",
-  "style": "solid"
+  "connections": [
+    {"to": "target_id", "label": "optional label", "style": "solid"}
+  ]
 }
 ```
 
-**Line styles (`style`):** `solid`, `dashed`, `dotted`
+**Line styles (`style`):** `solid` (default), `dashed`, `dotted`
 
 ### Tags Dictionary (tagsDictionary)
 
@@ -198,6 +226,20 @@ In `~/.claude.json` (or Cline settings):
 - `system`, `user`, `admin`
 - `client`, `manager`, `bot`
 
+## Opening Schema by URL
+
+You can open any schema by URL using `get_schema_by_url`:
+
+```
+# Canvas URL
+https://scheme.smartlaunchhub.com/canvas?id=abc123
+
+# Shared link
+https://scheme.smartlaunchhub.com/shared/xyz789
+```
+
+Just paste the URL and the MCP will extract the schema ID automatically.
+
 ## Schema Methodology
 
 Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:
@@ -218,7 +260,7 @@ Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:
 ## Links
 
 - [SchemeOG Cloud](https://scheme.smartlaunchhub.com)
-- [GitLab](https://gitlab.com/serter2069/schemeog-cloud)
+- [GitLab](https://gitlab.com/serter2069/schemeog-mcp)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemeog-mcp",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "MCP Server for SchemeOG Cloud - Create and manage visual diagrams and flowcharts with AI assistance",
   "type": "module",
   "main": "index.js",