@askqa/mcp 1.2.2 → 1.2.5

package/.claude-plugin/marketplace.json

@@ -0,0 +1,9 @@
+{
+  "plugins": [
+    {
+      "name": "askqa",
+      "version": "1.2.3",
+      "description": "AskQA skills — set up notifications and monitoring for your websites"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "askqa",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "description": "AskQA skills — set up notifications and monitoring for your websites",
   "mcpServers": {
     "askqa": {

package/README.md

@@ -54,6 +54,9 @@ Get your API key from [askqa.ai](https://askqa.ai) after signing in.
 | `list_notification_channels`  | List notification channels                              |
 | `remove_notification_channel` | Remove a notification channel                           |
 | `test_notification_channel`   | Send a test notification                                |
+| `share_test_run`              | Make a test run publicly shareable, returns a share URL |
+| `unshare_test_run`            | Revoke public sharing for a test run                    |
+| `get_shared_run`              | Fetch a shared run by URL or token (no API key needed); includes test code to recreate it |
 
 ## Example Conversations
 
@@ -75,6 +78,18 @@ The AI will use `screenshot_url` to inspect the page, write custom Playwright co
 
 The AI will call `get_test_results` and `get_test_screenshots` to analyze the failure.
 
+**Share a test run:**
+
+> "Share my latest checkout run with the client"
+
+The AI will call `get_test_results` to find the run, then `share_test_run` to generate a public link. Use `unshare_test_run` to revoke access later.
+
+**Copy a shared test into your account:**
+
+> "I got this link — can you set up the same test for my site? https://askqa.ai/r/..."
+
+The AI will call `get_shared_run` to read the test code from the shared link (no API key needed), then `create_test` to add it to your account.
+
 ## Privacy Policy
 
 This extension only makes HTTPS requests to the AskQA API. It does not access files on your computer or collect analytics.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askqa/mcp",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "description": "MCP server for AskQA — monitor websites with automated tests by chatting with AI",
   "type": "module",
   "license": "MIT",

package/server.js

@@ -1077,6 +1077,111 @@ server.registerTool(
   }
 );
 
+server.registerTool(
+  "get_shared_run",
+  {
+    description:
+      "Fetch a publicly shared test run by its share URL or token. No API key required — anyone with the link can call this. " +
+      "Returns run results, step details, and the original test config (test_code, test_template_id, test_params, test_url) " +
+      "so you can recreate the test in your own account using create_test.",
+    readOnlyHint: true,
+    inputSchema: {
+      share_url_or_token: z.string().describe("The share URL (https://askqa.ai/r/TOKEN) or just the token"),
+    },
+  },
+  async ({ share_url_or_token }) => {
+    try {
+      const token = share_url_or_token.includes("/")
+        ? share_url_or_token.split("/").pop()
+        : share_url_or_token;
+
+      const res = await fetch(`${API_URL}/api/test-runs/shared/${encodeURIComponent(token)}`);
+      if (res.status === 404) {
+        return { content: [{ type: "text", text: "Shared run not found. The link may be invalid or sharing may have been revoked." }], isError: true };
+      }
+      if (!res.ok) {
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+      }
+      const run = await res.json();
+
+      const lines = [
+        `Run #${run.id} — ${run.test_name || "Unnamed test"} | ${run.status}`,
+        `URL: ${run.test_url || "unknown"}`,
+        `Duration: ${run.result?.durationMs ? (run.result.durationMs / 1000).toFixed(1) + "s" : "N/A"}`,
+        "",
+      ];
+
+      if (run.result?.steps?.length) {
+        lines.push("Steps:");
+        for (const s of run.result.steps) {
+          lines.push(`  ${s.status === "passed" ? "✓" : "✗"} ${s.name}${s.error ? " — " + s.error : ""}`);
+        }
+        lines.push("");
+      }
+
+      if (run.test_code) {
+        lines.push("Test code (use create_test to recreate in your account):");
+        lines.push("```javascript");
+        lines.push(run.test_code);
+        lines.push("```");
+      } else if (run.test_template_id) {
+        lines.push(`Template: ${run.test_template_id}`);
+        if (run.test_params && Object.keys(run.test_params).length) {
+          lines.push(`Params: ${JSON.stringify(run.test_params)}`);
+        }
+      }
+
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.registerTool(
+  "share_test_run",
+  {
+    description: "Make a test run publicly shareable. Returns a share_url that anyone can open without logging in. Calling again on an already-shared run returns the same URL. Use unshare_test_run to revoke access.",
+    inputSchema: {
+      test_run_id: z.coerce.number().describe("The test run ID to share"),
+    },
+  },
+  async ({ test_run_id }) => {
+    try {
+      const data = await apiPost(`/api/test-runs/${test_run_id}/share`, {});
+      return { content: [{ type: "text", text: `Share URL: ${data.share_url}\n\nAnyone with this link can view the test run results without logging in.` }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.registerTool(
+  "unshare_test_run",
+  {
+    description: "Revoke public sharing for a test run. The share URL will stop working immediately.",
+    destructiveHint: true,
+    inputSchema: {
+      test_run_id: z.coerce.number().describe("The test run ID to stop sharing"),
+    },
+  },
+  async ({ test_run_id }) => {
+    try {
+      const res = await fetch(`${API_URL}/api/test-runs/${test_run_id}/share`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${API_KEY}` },
+      });
+      if (!res.ok && res.status !== 204) {
+        const text = await res.text();
+        throw new Error(`API ${res.status}: ${text}`);
+      }
+      return { content: [{ type: "text", text: `Sharing disabled for run #${test_run_id}. The public link no longer works.` }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error("AskQA MCP server running on stdio");