wopee-mcp 1.18.2 → 1.21.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wopee.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,12 @@
 # Wopee MCP Server
 
-A Model Context Protocol (MCP) server for interacting with Wopee.io's autonomous testing platform. This server provides tools for managing analysis suites, generating test cases, user stories, and dispatching autonomous testing agents.
+AI-powered autonomous testing for your apps -- connect Claude, Cursor, or any MCP-compatible AI agent to [Wopee.io](https://wopee.io) and generate test cases, user stories, and run autonomous tests in seconds.
+
+```bash
+npx wopee-mcp
+```
+
+> **[Documentation](https://docs.wopee.io/guides/wopee-mcp/)** | **[Landing Page](https://wopee.io/mcp/)** | **[Dashboard](https://cmd.wopee.io)**
 
 ## Setup
 
@@ -173,14 +179,18 @@ Fetch all existing analysis suites for my project
 
 #### `wopee_dispatch_analysis`
 
-Creates and dispatches a new analysis/crawling suite for your project. Use this to start a fresh analysis session.
+Creates and dispatches a new analysis/crawling suite for your project, or reruns an existing one. Use this to start a fresh analysis session or to re-trigger a previous analysis.
 
 - **Parameters:**
   - `additionalInstructions` _(optional)_ - Additional instructions to guide the agent during the analysis/crawling phase (e.g. focus areas, things to ignore, login steps, etc.)
   - `additionalVariables` _(optional)_ - Additional environment variables to pass to the analysis. Array of objects, each with:
     - `key` - Variable name, must be uppercase with underscores only (e.g. `MY_VAR`, `BASE_URL`)
     - `value` - Variable value (non-empty string)
-- **Returns:** Success message with the created suite information
+  - `rerun` _(optional)_ - If provided, reruns an existing analysis suite instead of creating a new one. Object with:
+    - `suiteUuid` - UUID of the existing suite to rerun
+    - `analysisIdentifier` - Analysis identifier of the existing suite
+    - `mode` - Rerun mode: `FULL` (reruns the entire analysis including crawling and generation) or `CRAWLING` (reruns only the crawling phase)
+- **Returns:** Success message with the created/rerun suite information
 
 **Example Usage:**
 
@@ -196,6 +206,14 @@ Dispatch a new analysis suite and focus on the checkout flow
 Dispatch a new analysis suite with additional variables CARD_FILAMENT=123321123 and AUTH_TOKEN=abc123
 ```
 
+```
+Rerun the full analysis for suite <suiteUuid> with analysis identifier <analysisIdentifier>
+```
+
+```
+Rerun only the crawling phase for suite <suiteUuid> with analysis identifier <analysisIdentifier>
+```
+
 #### `wopee_create_blank_suite`
 
 Creates a blank analysis suite for your project. Use this when you want to manually configure and populate a suite rather than having it automatically analyzed.

package/build/tools/shared/handlers.js

@@ -15,12 +15,12 @@ export async function fetchArtifact(input) {
         const result = await requestClient(FetchArtifact, {
             input: parsedInput,
         });
-        if (!result || !result?.fetchArtifact || !result?.fetchArtifact?.content)
+        if (!result?.fetchArtifact?.content)
             return {
                 content: [
                     {
                         type: "text",
-                        text: "Failed to fetch file",
+                        text: "Failed to fetch file: no content returned",
                     },
                 ],
             };
@@ -54,12 +54,12 @@ export async function generateAIDataFile(input) {
         const generationResult = await requestClient(query, {
             input: parsedInput,
         });
-        if (!generationResult || !generationResult[dataKey])
+        if (!generationResult?.[dataKey])
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Failed to generate ${description}`,
+                        text: `Failed to generate ${description}: no result returned`,
                     },
                 ],
             };
@@ -86,12 +86,12 @@ export async function updateArtifact(input) {
         const updateFileResult = await requestClient(UpdateArtifact, {
             input: parsedInput,
         });
-        if (!updateFileResult || !updateFileResult.updateArtifact)
+        if (!updateFileResult?.updateArtifact)
             return {
                 content: [
                     {
                         type: "text",
-                        text: "Failed to update file",
+                        text: "Failed to update file: operation returned false",
                     },
                 ],
             };

package/build/tools/shared/helpers.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { GenerateAppContext, GenerateGeneralUserStories, GenerateReusableTestCases, GenerateReusableTestCaseSteps, GenerateTestCases, GenerateTestCaseSteps, GenerateUserStoriesWithTestCases, } from "./gql-queries.js";
 import { ArtifactType, GenerateArtifactType } from "./types.js";
+import { RequestError } from "../../utils/requestClient.js";
 export function _convertToArtifactType(type) {
     switch (type) {
         case GenerateArtifactType.APP_CONTEXT:
@@ -69,6 +70,16 @@ export function _parseGenerateArtifactType(type) {
 }
 export function _parseError(error) {
     console.error(error instanceof z.ZodError ? error.issues : error);
+    if (error instanceof RequestError) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `[${error.code}] ${error.message}${error.retryable ? " (retryable)" : ""}`,
+                },
+            ],
+        };
+    }
     return {
         content: [
             {

package/build/tools/wopee_create_blank_suite/index.js

@@ -1,5 +1,6 @@
 import { getConfig } from "../../utils/getConfig.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { _parseError } from "../shared/helpers.js";
 import { ToolName } from "../shared/types.js";
 import { CreateBlankAnalysisSuite } from "../shared/gql-queries.js";
 export const wopeeCreateBlankSuite = {
@@ -9,35 +10,40 @@ export const wopeeCreateBlankSuite = {
         description: "Create a blank analysis suite for a project",
     },
     handler: async () => {
-        const { WOPEE_PROJECT_UUID } = getConfig();
-        if (!WOPEE_PROJECT_UUID)
+        try {
+            const { WOPEE_PROJECT_UUID } = getConfig();
+            if (!WOPEE_PROJECT_UUID)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "WOPEE_PROJECT_UUID is not set",
+                        },
+                    ],
+                };
+            const result = await requestClient(CreateBlankAnalysisSuite, {
+                projectUuid: WOPEE_PROJECT_UUID,
+            });
+            if (!result?.createBlankAnalysisSuite)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to create blank suite: no data returned",
+                        },
+                    ],
+                };
             return {
                 content: [
                     {
                         type: "text",
-                        text: "WOPEE_PROJECT_UUID is not set",
+                        text: JSON.stringify(result.createBlankAnalysisSuite, null, 2),
                     },
                 ],
             };
-        const result = await requestClient(CreateBlankAnalysisSuite, {
-            projectUuid: WOPEE_PROJECT_UUID,
-        });
-        if (!result || !result.createBlankAnalysisSuite)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to fetch analysis suites",
-                    },
-                ],
-            };
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.createBlankAnalysisSuite, null, 2),
-                },
-            ],
-        };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
     },
 };

package/build/tools/wopee_dispatch_agent/index.js

@@ -4,26 +4,27 @@ import { _parseError } from "../shared/helpers.js";
 import { createDispatchAgentInput } from "./factory.js";
 import { DispatchAgent } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { withRetry } from "../../utils/withRetry.js";
 export const wopeeDispatchAgent = {
     name: ToolName.WOPEE_DISPATCH_AGENT,
     config: {
         title: "Dispatch agent",
-        description: "Dispatch agent testing for selected suite's test cases",
+        description: "Dispatch agent testing for selected suite's test cases. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
         inputSchema: WopeeDispatchAgentInputSchema.shape,
     },
     handler: async (input) => {
         try {
             const dispatchAgentInput = createDispatchAgentInput(input);
             const parsedInput = DispatchAgentInputSchema.parse(dispatchAgentInput);
-            const result = await requestClient(DispatchAgent, {
+            const result = await withRetry(() => requestClient(DispatchAgent, {
                 input: parsedInput,
-            });
-            if (!result || result?.dispatchAgent?.length === 0)
+            }));
+            if (!result?.dispatchAgent?.length)
                 return {
                     content: [
                         {
                             type: "text",
-                            text: "Failed to dispatch agent",
+                            text: "Failed to dispatch agent: no dispatch result returned",
                         },
                     ],
                 };

package/build/tools/wopee_dispatch_analysis/factory.js

@@ -15,6 +15,6 @@ export const createDispatchAnalysisInput = (input) => {
                 ? JSON.stringify(input.additionalVariables)
                 : null,
         },
-        rerun: null,
+        rerun: input.rerun ?? null,
     };
 };

package/build/tools/wopee_dispatch_analysis/index.js

@@ -3,27 +3,28 @@ import { DispatchAnalysisInputSchema, WopeeDispatchAnalysisInputSchema, } from "
 import { createDispatchAnalysisInput } from "./factory.js";
 import { DispatchAnalysis } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { withRetry } from "../../utils/withRetry.js";
 import { ToolName } from "../shared/types.js";
 export const wopeeDispatchAnalysis = {
     name: ToolName.WOPEE_DISPATCH_ANALYSIS,
     config: {
         title: "Dispatch analysis",
-        description: "Create and dispatch analysis/crawling suite for a project",
+        description: "Create and dispatch analysis/crawling suite for a project. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
         inputSchema: WopeeDispatchAnalysisInputSchema.shape,
     },
     handler: async (input) => {
         try {
             const rawInput = createDispatchAnalysisInput(input);
             const parsedInput = DispatchAnalysisInputSchema.parse(rawInput);
-            const result = await requestClient(DispatchAnalysis, {
+            const result = await withRetry(() => requestClient(DispatchAnalysis, {
                 input: parsedInput,
-            });
-            if (!result || !result.dispatchAnalysis)
+            }));
+            if (!result?.dispatchAnalysis)
                 return {
                     content: [
                         {
                             type: "text",
-                            text: "Failed to dispatch agent",
+                            text: "Failed to dispatch agent: no analysis suite returned",
                         },
                     ],
                 };

package/build/tools/wopee_dispatch_analysis/schema.js

@@ -25,6 +25,21 @@ const AdditionalVariableSchema = z.object({
         .string({ description: "Variable value. Must be a non-empty string." })
         .min(1, "Value must be a non-empty string"),
 });
+const WopeeRerunOptionsSchema = z.object({
+    suiteUuid: z
+        .string({
+        description: "UUID of the existing suite to rerun.",
+    })
+        .min(1, "Suite UUID is required"),
+    analysisIdentifier: z
+        .string({
+        description: "Analysis identifier of the existing suite to rerun.",
+    })
+        .min(1, "Analysis identifier is required"),
+    mode: z.nativeEnum(RerunMode, {
+        description: "Rerun mode: FULL reruns the entire analysis (crawling + analysis), CRAWLING reruns only the crawling phase.",
+    }),
+});
 export const WopeeDispatchAnalysisInputSchema = z.object({
     additionalInstructions: z
         .string({ description: "Additional instructions for the agent" })
@@ -34,4 +49,5 @@ export const WopeeDispatchAnalysisInputSchema = z.object({
         description: "Additional environment variables for the analysis. Each variable needs a key (uppercase, e.g. BASE_URL) and a non-empty value.",
     })
         .nullish(),
+    rerun: WopeeRerunOptionsSchema.nullish().describe("If provided, reruns an existing analysis suite instead of creating a new one. Requires suiteUuid, analysisIdentifier, and mode."),
 });

package/build/tools/wopee_fetch_analysis_suites/index.js

@@ -1,5 +1,6 @@
 import { getConfig } from "../../utils/getConfig.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { _parseError } from "../shared/helpers.js";
 import { ToolName } from "../shared/types.js";
 import { FetchAnalysisSuites } from "../shared/gql-queries.js";
 export const wopeeFetchAnalysisSuites = {
@@ -9,35 +10,40 @@ export const wopeeFetchAnalysisSuites = {
         description: "Fetch project's analysis suites from Woopee",
     },
     handler: async () => {
-        const { WOPEE_PROJECT_UUID } = getConfig();
-        if (!WOPEE_PROJECT_UUID)
+        try {
+            const { WOPEE_PROJECT_UUID } = getConfig();
+            if (!WOPEE_PROJECT_UUID)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "WOPEE_PROJECT_UUID is not set",
+                        },
+                    ],
+                };
+            const result = await requestClient(FetchAnalysisSuites, {
+                projectUuid: WOPEE_PROJECT_UUID,
+            });
+            if (!result?.fetchAnalysisSuites)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to fetch analysis suites: no data returned",
+                        },
+                    ],
+                };
             return {
                 content: [
                     {
                         type: "text",
-                        text: "WOPEE_PROJECT_UUID is not set",
+                        text: JSON.stringify(result.fetchAnalysisSuites, null, 2),
                     },
                 ],
             };
-        const result = await requestClient(FetchAnalysisSuites, {
-            projectUuid: WOPEE_PROJECT_UUID,
-        });
-        if (!result || !result.fetchAnalysisSuites)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to fetch analysis suites",
-                    },
-                ],
-            };
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.fetchAnalysisSuites, null, 2),
-                },
-            ],
-        };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
     },
 };

package/build/utils/requestClient.js

@@ -1,37 +1,57 @@
 import { getConfig } from "./getConfig.js";
+export class RequestError extends Error {
+    code;
+    status;
+    retryable;
+    constructor(message, code, options) {
+        super(message);
+        this.name = "RequestError";
+        this.code = code;
+        this.status = options?.status ?? null;
+        this.retryable = options?.retryable ?? false;
+    }
+}
+function classifyGraphQLErrors(errors) {
+    const combined = errors.map((e) => e.message).join("; ");
+    const lower = combined.toLowerCase();
+    if (lower.includes("rate limit")) {
+        return new RequestError(combined, "RATE_LIMITED", { retryable: true });
+    }
+    if (lower.includes("usage limit") || lower.includes("usage_limit")) {
+        return new RequestError(combined, "USAGE_LIMIT_EXCEEDED");
+    }
+    return new RequestError(combined, "GRAPHQL_ERROR");
+}
 export const requestClient = async (query, variables) => {
     const { WOPEE_API_URL, WOPEE_API_KEY } = getConfig();
+    if (!WOPEE_API_KEY) {
+        throw new RequestError("WOPEE_API_KEY is not set", "AUTH_ERROR");
+    }
+    const headers = {
+        api_key: WOPEE_API_KEY,
+        "Content-Type": "application/json",
+    };
+    let response;
     try {
-        if (!WOPEE_API_KEY) {
-            console.error("[REQUEST_CLIENT_ERROR]: WOPEE_API_KEY is not set");
-            return null;
-        }
-        const headers = {
-            api_key: WOPEE_API_KEY,
-            "Content-Type": "application/json",
-        };
-        const response = await fetch(`${WOPEE_API_URL}`, {
+        response = await fetch(`${WOPEE_API_URL}`, {
             method: "POST",
             headers,
-            body: JSON.stringify({
-                query,
-                variables,
-            }),
+            body: JSON.stringify({ query, variables }),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            console.error("[REQUEST_CLIENT_ERROR]:", errorText);
-            return null;
-        }
-        const result = (await response.json());
-        if (result.errors && result.errors.length > 0) {
-            console.error("GraphQL errors:", result.errors);
-            return null;
-        }
-        return result.data || null;
     }
     catch (error) {
-        console.error("[REQUEST_CLIENT_ERROR]:", error);
-        return null;
+        throw new RequestError(`Network error: ${error instanceof Error ? error.message : String(error)}`, "NETWORK_ERROR", { retryable: true });
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => "");
+        const status = response.status;
+        const isRateLimit = status === 429 || errorText.toLowerCase().includes("rate limit");
+        const isRetryable = isRateLimit || status >= 500;
+        throw new RequestError(`HTTP ${status}: ${errorText || response.statusText}`, isRateLimit ? "RATE_LIMITED" : "HTTP_ERROR", { status, retryable: isRetryable });
+    }
+    const result = (await response.json());
+    if (result.errors && result.errors.length > 0) {
+        throw classifyGraphQLErrors(result.errors);
     }
+    return result.data;
 };

package/build/utils/withRetry.js

@@ -0,0 +1,24 @@
+import { RequestError } from "./requestClient.js";
+export async function withRetry(fn, options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 2000;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (error instanceof RequestError &&
+                error.retryable &&
+                attempt < maxRetries) {
+                lastError = error;
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                console.error(`[RETRY] Attempt ${attempt + 1}/${maxRetries} failed (${error.code}): ${error.message}. Retrying in ${delay}ms...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw lastError;
+}

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.18.2",
+  "version": "1.21.0",
   "mcpName": "io.github.Wopee-io/wopee-mcp",
   "description": "Wopee.io MCP server for autonomous testing platform",
   "main": "./build/index.js",
@@ -16,19 +16,30 @@
     "build",
     "README.md"
   ],
+  "homepage": "https://wopee.io/mcp/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wopee-io/wopee-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/Wopee-io/wopee-mcp/issues"
+  },
   "keywords": [
     "wopee",
-    "ai",
+    "wopee.io",
     "mcp",
-    "server",
-    "testing",
-    "automation",
-    "autonomous",
-    "quality assurance",
-    "model context protocol"
+    "model context protocol",
+    "ai testing",
+    "autonomous testing",
+    "test automation",
+    "claude",
+    "cursor",
+    "ai agent",
+    "visual testing",
+    "playwright"
   ],
   "author": "Sota Giorgadze <sota.giorgadze@wopee.io>",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.21.0",
     "undici": "^7.18.2",