verso-mcp 0.1.5 → 0.1.7

package/index.js

@@ -195,7 +195,18 @@ async function handleMessage(message) {
       if (toolName === 'open_project') {
         activeProjectId = toolArgs.projectId
         registerProject()
-        return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text: `Switched to project ${activeProjectId}` }] } }
+        return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text: `Switched to project ${activeProjectId}. You can now use design tools.` }] } }
+      }
+
+      // Guard: require open_project first
+      if (!activeProjectId) {
+        return {
+          jsonrpc: '2.0', id,
+          result: {
+            content: [{ type: 'text', text: 'Error: No project is open. Call open_project first with a projectId from list_projects.' }],
+            isError: true,
+          },
+        }
       }
 
       try {
@@ -449,7 +460,7 @@ The user can edit this prompt manually in the inspector — always respect their
     },
     {
       name: 'list_screens',
-      description: 'List all screens in the project with their indices and active status.',
+      description: 'List all screens in the project with their indices and active status. Requires open_project first.',
       inputSchema: { type: 'object', properties: {} },
     },
     {
@@ -465,7 +476,7 @@ The user can edit this prompt manually in the inspector — always respect their
     },
     {
       name: 'get_design_settings',
-      description: 'Returns the current design system state (theme, accentColor, iconLibrary, fontFamily, device, viewport) AND the designPrompt — the master design brief for this project. IMPORTANT: Always call this before write_html to read the current designPrompt so you can update it properly. The user may have edited the prompt manually.',
+      description: 'Returns the current design system state (theme, accentColor, iconLibrary, fontFamily, device, viewport) AND the designPrompt. Requires open_project first. IMPORTANT: Always call this before write_html to read the current designPrompt so you can update it properly.',
       inputSchema: { type: 'object', properties: {} },
     },
     {
@@ -482,6 +493,43 @@ The user can edit this prompt manually in the inspector — always respect their
         },
       },
     },
+    {
+      name: 'auto_prototype',
+      description: `Gather all screens' layer trees and design context in a single call for auto-prototyping analysis.
+Returns every screen's name, index, and element tree so you can determine which interactive elements (tab bar buttons, nav buttons, CTAs, cards, back arrows) should link to which screens.
+
+After analyzing, call set_links with your mapping to apply data-ps-link attributes.`,
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'set_links',
+      description: `Apply navigation links between screens in batch. Each link sets a data-ps-link attribute on an element so that clicking it navigates to the target screen.
+
+Example input:
+{ "links": [
+  { "screenIndex": 0, "nodeId": "ps-42", "targetScreen": "Cart" },
+  { "screenIndex": 1, "nodeId": "ps-7", "targetScreen": "Home" }
+]}`,
+      inputSchema: {
+        type: 'object',
+        properties: {
+          links: {
+            type: 'array',
+            description: 'Array of link mappings to apply',
+            items: {
+              type: 'object',
+              properties: {
+                screenIndex: { type: 'number', description: 'Index of the screen containing the element' },
+                nodeId: { type: 'string', description: 'The data-ps-id of the element to make clickable' },
+                targetScreen: { type: 'string', description: 'Name of the screen to navigate to (must match exactly)' },
+              },
+              required: ['screenIndex', 'nodeId', 'targetScreen'],
+            },
+          },
+        },
+        required: ['links'],
+      },
+    },
     {
       name: 'list_projects',
       description: 'List all your Verso projects. Returns project id, name, screen count, and last updated time.',
@@ -489,7 +537,7 @@ The user can edit this prompt manually in the inspector — always respect their
     },
     {
       name: 'open_project',
-      description: 'Connect to a specific Verso project by its ID. Must be called before using any design tools.',
+      description: 'Connect to a specific Verso project by its ID. ⚠️ REQUIRED: You MUST call this before ANY other tool (except list_projects). All other tools will fail if no project is open.',
       inputSchema: {
         type: 'object',
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verso-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "MCP server for Verso — AI-powered mobile app design tool",
   "bin": {
     "verso-mcp": "./index.js"