opentestmcp 0.3.1 → 0.3.3

package/README.md

@@ -28,7 +28,7 @@ This writes an `opentest` MCP server into `~/.cursor/mcp.json`:
 }
 ```
 
-Replace `ot_live_YOUR_API_KEY_HERE` with an API key from OpenTest, then restart Cursor or toggle the MCP server off/on.
+Replace `ot_live_YOUR_API_KEY_HERE` with an API key from [OpenTest settings](https://www.flowtest.opentest.live/settings/), then restart Cursor or toggle the MCP server off/on.
 
 You can also pass the key directly:
 
@@ -56,7 +56,7 @@ npx opentestmcp install --project
 After installing, ask your coding agent:
 
 ```text
-Use OpenTest to list my endpoints.
+Use the OpenTest MCP to convert my login endpoint into an MCP tool.
 ```
 
 ```text

package/bin/cli.js

@@ -122,9 +122,9 @@ Server name: ${serverName}
 Backend: ${config.mcpServers[serverName].env.OPENTEST_BACKEND}
 
 Next steps:
-1. ${usedPlaceholder ? `Replace ${API_KEY_PLACEHOLDER} with your OpenTest API key in ${configPath}.` : "Your OpenTest API key was written to the MCP config."}
+1. ${usedPlaceholder ? `Replace ${API_KEY_PLACEHOLDER} with your OpenTest API key in ${configPath}. Find or create one at https://www.flowtest.opentest.live/settings/.` : "Your OpenTest API key was written to the MCP config."}
 2. Restart Cursor or toggle the OpenTest MCP server off/on.
-3. Ask your agent: "Use OpenTest to list my endpoints."
+3. Ask your agent: "Use the OpenTest MCP to convert my login endpoint into an MCP tool." Then open https://www.flowtest.opentest.live/ to see the session and generated MCP.
 `);
 }
 

package/dist/server.js

@@ -857,6 +857,26 @@ export function createServer() {
             });
         }
     });
+    server.tool("share_endpoints_with_ui", "Push discovered or verified endpoints into the OpenTest Flow Playground so the user can see them, test them, and convert selected endpoints into hosted MCP tools. Use this after verify_endpoints_live or when the user explicitly asks to stream endpoints to the UI.", {
+        endpoints: z.array(z.any()).describe("Endpoints to push. Each item should include method plus path/path_template/url; include schemas when available."),
+        upstream_base_url: z.string().optional().describe("Default upstream base URL for testing and MCP generation, e.g. http://127.0.0.1:8000 or https://api.example.com"),
+        intent: z.string().optional().describe("Short label for the session, e.g. 'Login endpoint' or 'Auth endpoints'"),
+        session_id: z.string().optional().describe("Optional existing session id to append/replace. Omit to create a new session."),
+    }, async (args) => {
+        try {
+            const result = await callBackend("share_endpoints_with_ui", args);
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            return toolError(e.message, inferErrorCode(e.message), {
+                next_actions: [
+                    "Make sure OPENTEST_API_KEY is set or run opentest_login, then retry.",
+                    "If the Flow UI opens but is empty, confirm OPENTEST_BACKEND points to the same backend that received this push.",
+                ],
+                related_tools: ["verify_endpoints_live", "mcp_preview", "opentest_status"],
+            });
+        }
+    });
     server.tool("mcp_preview", "Pick endpoints matching an intent and generate a tool-schema preview. Also writes the same two-pane HTML to opentest-mcp/mcp-preview-last.html and returns preview_file_url — use Cursor Simple Browser or `node opentest-mcp/scripts/open-cursor-preview.mjs` if the inline MCP app panel does not appear. LLM selection when OPENAI_API_KEY is set on the backend; else keyword match. Does NOT write to the DB.", {
         intent: z.string().describe("Free text like 'auth endpoints' or 'everything related to orders'"),
         endpoints: z.array(z.any()).describe("Candidate endpoints (typically the confirmed bucket from verify_endpoints_live)"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentestmcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Turn APIs into agent-callable MCP tools with auth, testing, and audit logs",
   "type": "module",
   "bin": {