wopee-mcp 1.23.0 → 1.23.1

package/build/tools/wopee_create_blank_suite/index.js

@@ -7,7 +7,7 @@ export const wopeeCreateBlankSuite = {
     name: ToolName.WOPEE_CREATE_BLANK_SUITE,
     config: {
         title: "Create blank analysis suite",
-        description: "Create a blank analysis suite for a project",
+        description: "Create a new empty analysis suite in the current project. Use this as the first step when starting a new testing workflow — the returned suite UUID is required by generate, fetch, update, and dispatch tools. Takes no input parameters; uses the project configured via WOPEE_PROJECT_UUID. Returns the created suite object including its UUID and metadata.",
     },
     handler: async () => {
         try {

package/build/tools/wopee_dispatch_agent/index.js

@@ -8,8 +8,8 @@ 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. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
+        title: "Dispatch autonomous testing agent",
+        description: "Run an autonomous AI testing agent on specific test cases within a suite. The agent navigates the web app, executes test steps, captures screenshots, and reports pass/fail results. Requires a suite UUID and test case ID (e.g. TC001) with its parent user story ID (e.g. US001). Use wopee_generate_artifact first to create test cases, then this tool to execute them. Rate limit: 10 seconds between dispatches per project; concurrent calls auto-retry with backoff. Returns executed test case results including status and agent report.",
         inputSchema: WopeeDispatchAgentInputSchema.shape,
     },
     handler: async (input) => {

package/build/tools/wopee_dispatch_analysis/index.js

@@ -8,8 +8,8 @@ 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. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
+        title: "Dispatch analysis crawl",
+        description: "Create a new analysis suite and dispatch an AI crawling agent to explore and analyze a web application. The agent autonomously navigates the app starting from a given URL, discovers pages, and builds a sitemap. Optionally accepts login credentials, cookie preferences, custom variables, and additional instructions to guide the crawl. Use this instead of wopee_create_blank_suite when you want to auto-analyze a web app in one step. Rate limit: 10 seconds between dispatches per project; concurrent calls auto-retry with backoff. Returns the created analysis suite.",
         inputSchema: WopeeDispatchAnalysisInputSchema.shape,
     },
     handler: async (input) => {

package/build/tools/wopee_fetch_analysis_suites/index.js

@@ -6,8 +6,8 @@ import { FetchAnalysisSuites } from "../shared/gql-queries.js";
 export const wopeeFetchAnalysisSuites = {
     name: ToolName.WOPEE_FETCH_ANALYSIS_SUITES,
     config: {
-        title: "Fetch Analysis Suites",
-        description: "Fetch project's analysis suites from Woopee",
+        title: "List analysis suites",
+        description: "List all analysis suites in the current project. Returns an array of suites with their UUIDs, names, types, and statuses. Use this to find existing suites before generating content or dispatching agents. Takes no input parameters; uses the project configured via WOPEE_PROJECT_UUID. Each suite UUID can be passed to other tools like wopee_generate_artifact, wopee_fetch_artifact, or wopee_dispatch_agent.",
     },
     handler: async () => {
         try {

package/build/tools/wopee_fetch_artifact/index.js

@@ -4,8 +4,8 @@ import { fetchArtifact } from "../shared/handlers.js";
 export const wopeeFetchArtifact = {
     name: ToolName.WOPEE_FETCH_ARTIFACT,
     config: {
-        title: "Fetch file(artifact)",
-        description: "Fetch suite's file(artifact) for selected project",
+        title: "Fetch test artifacts",
+        description: "Retrieve test artifacts from a suite. Supported types: APP_CONTEXT (application description), GENERAL_USER_STORIES (user stories without test cases), USER_STORIES (user stories with test cases), PLAYWRIGHT_CODE (Playwright test code for a specific test case — requires identifier like 'US004:TC006'), PROJECT_CONTEXT (project-level context). Use after wopee_generate_artifact to review test artifacts, or to retrieve existing artifacts for editing with wopee_update_artifact.",
         inputSchema: FetchArtifactHandlerInputSchema.shape,
     },
     handler: async (input) => await fetchArtifact(input),

package/build/tools/wopee_fetch_executed_test_cases/index.js

@@ -7,8 +7,8 @@ import { requestClient } from "../../utils/requestClient.js";
 export const wopeeFetchExecutedTestCases = {
     name: ToolName.WOPEE_FETCH_EXECUTED_TEST_CASES,
     config: {
-        title: "Fetch executed test cases",
-        description: "Fetch executed test cases and their results (agent report, code report, execution status) for a given analysis suite.",
+        title: "Fetch test execution results",
+        description: "Retrieve the results of test cases that have been executed by the autonomous agent. Returns each test case with its execution status (IN_PROGRESS, FINISHED, FAILED), agent report, and code report. Use this after wopee_dispatch_agent to check whether tests passed or failed and to review detailed findings. Requires the suite UUID; optionally accepts an analysis identifier (e.g. A068) to filter results.",
         inputSchema: WopeeFetchExecutedTestCasesInputSchema.shape,
     },
     handler: async (input) => {

package/build/tools/wopee_generate_artifact/index.js

@@ -4,8 +4,8 @@ import { generateAIDataFile } from "../shared/handlers.js";
 export const wopeeGenerateArtifact = {
     name: ToolName.WOPEE_GENERATE_ARTIFACT,
     config: {
-        title: "Generate file(artifact)",
-        description: "Generate AI data file for selected suite",
+        title: "Generate test artifacts",
+        description: "Generate AI-powered test artifacts for a suite. Supported types: APP_CONTEXT (analyze the application and create a description), GENERAL_USER_STORIES (generate user stories from app context), USER_STORIES_WITH_TEST_CASES (generate user stories with detailed test cases), TEST_CASES (generate test cases for existing user stories), TEST_CASE_STEPS (generate step-by-step instructions for test cases), REUSABLE_TEST_CASES (generate reusable/shared test cases), REUSABLE_TEST_CASE_STEPS (generate steps for reusable test cases). Typical workflow: generate APP_CONTEXT first, then USER_STORIES_WITH_TEST_CASES, then use wopee_dispatch_agent to execute them.",
         inputSchema: GenerateAIDataHandlerInputSchema.shape,
     },
     handler: async (input) => await generateAIDataFile(input),

package/build/tools/wopee_update_artifact/index.js

@@ -4,8 +4,8 @@ import { updateArtifact } from "../shared/handlers.js";
 export const wopeeUpdateArtifact = {
     name: ToolName.WOPEE_UPDATE_ARTIFACT,
     config: {
-        title: "Update file",
-        description: "Update file(artifact) in the project",
+        title: "Update test artifacts",
+        description: "Update previously generated content in a suite. Use this to refine user stories, test cases, app context, or Playwright code after reviewing them with wopee_fetch_artifact. Requires the content type (APP_CONTEXT, GENERAL_USER_STORIES, USER_STORIES, PLAYWRIGHT_CODE, or PROJECT_CONTEXT), the suite UUID, and the new content as a string. For PLAYWRIGHT_CODE, also provide the test case identifier (e.g. 'US004:TC006'). This enables an iterative workflow: generate → review → update → dispatch.",
         inputSchema: UpdateArtifactHandlerInputSchema.shape,
     },
     handler: async (input) => await updateArtifact(input),

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.23.0",
+  "version": "1.23.1",
   "mcpName": "io.github.Wopee-io/wopee-mcp",
   "description": "Wopee.io MCP server for autonomous testing platform",
   "main": "./build/index.js",