wopee-mcp 1.2.1 → 1.3.0

package/README.md

@@ -0,0 +1,257 @@
+# 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.
+
+## Setup
+
+### Prerequisites
+
+- Node.js (v18 or higher recommended)
+- An IDE that supports MCP (Model Context Protocol), such as Cursor or VSCode
+
+### MCP Server Configuration
+
+Add this server to your MCP configuration.
+
+### Configuration Example
+
+```json
+{
+  "mcpServers": {
+    "wopee": {
+      "command": "npx wopee-mcp",
+      "env": {
+        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
+        "WOPEE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Required Environment Variables
+
+- **`WOPEE_PROJECT_UUID`** - Your Wopee project UUID. This identifies which project you're working with.
+- **`WOPEE_API_KEY`** - Your Wopee API key. You can create one at [cmd.wopee.io](https://cmd.wopee.io), in your project's settings.
+
+#### Optional Environment Variables
+
+- **`WOPEE_API_URL`** - The Wopee API endpoint URL. Should be specified only for testing/development purposes.
+
+## Getting Started
+
+Most tools in this MCP server require a `suiteUuid` to operate. You have two options to get started:
+
+### Option 1: Use Existing Suites
+
+Start by fetching your existing analysis suites:
+
+```
+Use the wopee_fetch_analysis_suites tool to retrieve all available suites for your project.
+```
+
+This will return a list of all analysis suites with their UUIDs, which you can then use with other tools.
+
+### Option 2: Create a New Suite
+
+If you don't have any suites yet, create a fresh analysis suite:
+
+```
+Use the wopee_dispatch_analysis tool to create and dispatch a new analysis/crawling suite.
+```
+
+This will create a new suite and return its UUID, which you can use for subsequent operations.
+
+## Available Tools
+
+### Suite Management
+
+#### `wopee_fetch_analysis_suites`
+
+Fetches all analysis suites for your project. This is a good starting point to see what suites are available.
+
+- **Returns:** Array of analysis suites with their UUIDs, names, statuses, and metadata
+
+**Example Usage:**
+
+```
+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.
+
+- **Returns:** Success message with the created suite information
+
+**Example Usage:**
+
+```
+Dispatch a new analysis suite
+```
+
+### Generation Tools
+
+These tools generate various artifacts for a specific suite. All require a `suiteUuid`.
+
+#### `wopee_generate_app_context`
+
+Generates an application context markdown file for the selected suite. This provides a comprehensive overview of the application being analyzed.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite to generate context for
+- **Returns:** Generated output in case of successful generation
+
+**Example Usage:**
+
+```
+Generate app context for suite abc-123-def-456
+```
+
+#### `wopee_generate_general_user_stories`
+
+Generates general user stories markdown file for the selected suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** Generated output in case of successful generation
+
+**Example Usage:**
+
+```
+Generate general user stories for my latest suite
+```
+
+#### `wopee_generate_user_stories`
+
+Generates detailed user stories JSON file for the selected suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** Generated output in case of successful generation
+
+**Example Usage:**
+
+```
+Generate user stories for suite abc-123-def-456
+```
+
+#### `wopee_generate_test_cases`
+
+Generates test cases for the selected suite based on the analysis and user stories.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** Generated output in case of successful generation
+
+**Example Usage:**
+
+```
+Generate test cases for suite abc-123-def-456
+```
+
+### Fetch Tools
+
+These tools retrieve generated artifacts for a specific suite. All require a `suiteUuid`.
+
+#### `wopee_fetch_app_context`
+
+Fetches the application context markdown file for a suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** The application context markdown content
+
+**Example Usage:**
+
+```
+Fetch app context for my latest suite
+```
+
+#### `wopee_fetch_general_user_stories`
+
+Fetches the general user stories markdown file for a suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** The general user stories markdown content
+
+**Example Usage:**
+
+```
+Fetch general user stories for suite abc-123-def-456
+```
+
+#### `wopee_fetch_user_stories`
+
+Fetches the user stories JSON file for a suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** The user stories JSON content
+
+**Example Usage:**
+
+```
+Fetch user stories for suite abc-123-def-456
+```
+
+#### `wopee_fetch_test_cases`
+
+Fetches the test cases JSON file for a suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite
+- **Returns:** The test cases JSON content
+
+**Example Usage:**
+
+```
+Fetch test cases for suite abc-123-def-456
+```
+
+### Agent Testing
+
+#### `wopee_dispatch_agent`
+
+Dispatches an autonomous testing agent to execute test cases for a selected suite.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the suite containing the test cases
+  - `analysisIdentifier` - The analysis identifier for the suite
+  - `testCases` - Array of test case objects to execute, each containing:
+    - `testCaseId` - The ID of the test case
+    - `userStoryId` - The ID of the associated user story
+- **Returns:** Success message indicating the agent has been dispatched
+
+**Example Usage:**
+
+```
+Dispatch agent for my latest suite's user story US001 and test case TC003
+```
+
+## Typical Workflow
+
+1. **Start with a suite:**
+
+   - Use `wopee_fetch_analysis_suites` to see existing suites, OR
+   - Use `wopee_dispatch_analysis` to create a new suite
+
+2. **Generate artifacts:**
+
+   - Generate app context: `wopee_generate_app_context`
+   - Generate user stories: `wopee_generate_user_stories` or `wopee_generate_general_user_stories`
+   - Generate test cases: `wopee_generate_test_cases`
+
+3. **Fetch generated content:**
+
+   - Use the fetch tools to retrieve generated markdown/JSON files
+
+4. **Run tests:**
+   - Use `wopee_dispatch_agent` to execute test cases with the autonomous testing agent
+
+## Notes
+
+- Most tools require a `suiteUuid`. Always start by fetching or creating a suite.
+- `wopee_dispatch_analysis` tool will go through whole cycle of processing - crawling the application and generating all of the artifacts one by one.
+- It is advisable to use [cmd.wopee.io](https://cmd.wopee.io) for a convenient visual representation of the generated data and results of the agent runs.

package/build/index.js

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { TOOLS } from "./tools/index.js";
+const server = new McpServer({
+    name: "wopee-mcp",
+    version: "1.0.0",
+});
+for (const { name, config, handler } of TOOLS) {
+    server.registerTool(name, config, handler);
+}
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Wopee MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Error starting Wopee MCP server:", error);
+    process.exit(1);
+});

package/build/tools/index.js

@@ -0,0 +1,24 @@
+import { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
+import { wopeeFetchTestCases } from "./wopee_fetch_test_cases/index.js";
+import { wopeeFetchAppContext } from "./wopee_fetch_app_context/index.js";
+import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
+import { wopeeFetchUserStories } from "./wopee_fetch_user_stories/index.js";
+import { wopeeGenerateTestCases } from "./wopee_generate_test_cases/index.js";
+import { wopeeGenerateAppContext } from "./wopee_generate_app_context/index.js";
+import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
+import { wopeeGenerateUserStories } from "./wopee_generate_user_stories/index.js";
+import { wopeeFetchGeneralUserStories } from "./wopee_fetch_general_user_stories/index.js";
+import { wopeeGenerateGeneralUserStories } from "./wopee_generate_general_user_stories/index.js";
+export const TOOLS = [
+    wopeeDispatchAnalysis,
+    wopeeDispatchAgent,
+    wopeeGenerateAppContext,
+    wopeeGenerateGeneralUserStories,
+    wopeeGenerateUserStories,
+    wopeeGenerateTestCases,
+    wopeeFetchAnalysisSuites,
+    wopeeFetchAppContext,
+    wopeeFetchGeneralUserStories,
+    wopeeFetchUserStories,
+    wopeeFetchTestCases,
+];

package/build/tools/shared/factories.js

@@ -0,0 +1,32 @@
+import { getConfig } from "../../utils/getConfig.js";
+export const createFetchFileInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        projectUuid: WOPEE_PROJECT_UUID,
+        suiteUuid: input.suiteUuid,
+        bucket: input.bucket,
+    };
+};
+export const createGenerateAIDataInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        projectUuid: WOPEE_PROJECT_UUID,
+        suiteUuid: input.suiteUuid,
+        suiteAnalysisConfig: {
+            startingUrl: null,
+            username: null,
+            password: null,
+            cookiesPreference: null,
+            additionalInstructions: null,
+            additionalVariables: null,
+        },
+        continueGeneration: false,
+        extraPrompt: null,
+        selectedUserStories: null,
+        sourceSuiteUuid: null,
+    };
+};

package/build/tools/shared/gql-queries.js

@@ -0,0 +1,106 @@
+export const FetchFile = `
+  query FetchFile($projectUuid: ID!, $suiteUuid: ID!, $bucket: String!) {
+    fetchFile(projectUuid: $projectUuid, suiteUuid: $suiteUuid, bucket: $bucket)
+  }
+`;
+export const DispatchAgent = `
+  mutation DispatchAgent(
+    $input: TestCasesInput!
+  ) {
+    dispatchAgent(input: $input)
+  }
+`;
+export const DispatchAnalysis = `
+  mutation DispatchAnalysis($input: DispatchAnalysisInput!) {
+    dispatchAnalysis(input: $input) {
+      uuid
+      name
+      createdAt
+      updatedAt
+      suiteType
+      analysisIdentifier
+      suiteRunningStatus
+      generatedAnalysisDataState {
+        suiteUuid
+        appContext {
+          status
+          isGenerated
+        }
+        generalUserStories {
+          status
+          isGenerated
+        }
+        userStories {
+          status
+          isGenerated
+        }
+        testCases {
+          status
+          isGenerated
+        }
+      }
+    }
+  }
+`;
+export const FetchAnalysisSuites = `
+  query FetchAnalysisSuites($projectUuid: ID!) {
+    fetchAnalysisSuites(projectUuid: $projectUuid) {
+      uuid
+      name
+      suiteType
+      executionStatus
+      analysisIdentifier
+      suiteRunningStatus
+      createdAt
+      updatedAt
+      generatedAnalysisDataState {
+        uuid
+        suiteUuid
+        appContext {
+          uuid
+          isGenerated
+          status
+        }
+        generalUserStories {
+          uuid
+          isGenerated
+          status
+        }
+        userStories {
+          uuid
+          isGenerated
+          status
+        }
+        testCases {
+          uuid
+          isGenerated
+          status
+        }
+      }
+    }
+  }
+`;
+export const GenerateAppContext = `
+  mutation GenerateAppContext(
+    $input: GenerateAIDataInput!
+  ) {
+    generateAppContext(input: $input)
+  }
+`;
+export const GenerateGeneralUserStories = `
+  mutation GenerateGeneralUserStories(
+    $input: GenerateAIDataInput!
+  ) {
+    generateGeneralUserStories(input: $input)
+  }
+`;
+export const GenerateTestCases = `
+ mutation GenerateTestCases($input: GenerateAIDataInput!) {
+    generateTestCases(input: $input)
+  }
+`;
+export const GenerateUserStories = `
+  mutation GenerateUserStories($input: GenerateAIDataInput!) {
+    generateUserStories(input: $input)
+  }
+`;

package/build/tools/shared/handlers.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { FetchFileInputSchema, GenerateAIDataInputSchema, } from "./schemas.js";
+import { FetchFile, GenerateTestCases, GenerateAppContext, GenerateUserStories, GenerateGeneralUserStories, } from "./gql-queries.js";
+import { createFetchFileInput, createGenerateAIDataInput, } from "./factories.js";
+import { Bucket, GenerationType } from "./types.js";
+import { requestClient } from "../../utils/requestClient.js";
+export function parseError(error) {
+    console.error(error instanceof z.ZodError ? error.issues : error);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Failed to parse input: ${error instanceof z.ZodError
+                    ? error.issues
+                        .map((issue) => `${issue.path[0] ?? "Unknown"}: ${issue.message}`)
+                        .join("\n")
+                    : error instanceof Error
+                        ? error.message
+                        : "Unknown zod validation error"}`,
+            },
+        ],
+    };
+}
+function parseGenerationType(type) {
+    switch (type) {
+        case GenerationType.APP_CONTEXT:
+            return {
+                query: GenerateAppContext,
+                dataKey: "generateAppContext",
+                bucket: Bucket.APP_CONTEXT,
+                description: "application's context markdown file for selected suite",
+            };
+        case GenerationType.GENERAL_USER_STORIES:
+            return {
+                query: GenerateGeneralUserStories,
+                dataKey: "generateGeneralUserStories",
+                bucket: Bucket.GENERAL_USER_STORIES,
+                description: "general user stories markdown file for selected suite",
+            };
+        case GenerationType.USER_STORIES:
+            return {
+                query: GenerateUserStories,
+                dataKey: "generateUserStories",
+                bucket: Bucket.USER_STORIES,
+                description: "user stories JSON file for selected suite",
+            };
+        case GenerationType.TEST_CASES:
+            return {
+                query: GenerateTestCases,
+                dataKey: "generateTestCases",
+                bucket: Bucket.USER_STORIES,
+                description: "test cases for selected suite",
+            };
+        default:
+            return {
+                query: null,
+                dataKey: null,
+                description: null,
+            };
+    }
+}
+export async function fetchFile(input) {
+    try {
+        const fetchFileInput = createFetchFileInput(input);
+        const parsedInput = FetchFileInputSchema.parse(fetchFileInput);
+        const result = await requestClient(FetchFile, parsedInput);
+        if (!result || !result.fetchFile)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Failed to fetch file",
+                    },
+                ],
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.fetchFile,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return parseError(error);
+    }
+}
+export async function generateAIDataFile(type, input) {
+    const { query, dataKey, bucket, description } = parseGenerationType(type);
+    if (!query || !dataKey || !description || !bucket)
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to parse generation type",
+                },
+            ],
+        };
+    try {
+        const generateAIDataInput = createGenerateAIDataInput(input);
+        const parsedInput = GenerateAIDataInputSchema.parse(generateAIDataInput);
+        const generationResult = await requestClient(query, {
+            input: parsedInput,
+        });
+        if (!generationResult || !generationResult[dataKey])
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to generate ${description}`,
+                    },
+                ],
+            };
+        return await fetchFile({
+            suiteUuid: parsedInput.suiteUuid,
+            bucket,
+        });
+    }
+    catch (error) {
+        return parseError(error);
+    }
+}

package/build/tools/shared/schemas.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { Bucket } from "./types.js";
+var CookiesPreference;
+(function (CookiesPreference) {
+    CookiesPreference["ACCEPT_ALL"] = "ACCEPT_ALL";
+    CookiesPreference["DECLINE_ALL"] = "DECLINE_ALL";
+    CookiesPreference["IGNORE"] = "IGNORE";
+})(CookiesPreference || (CookiesPreference = {}));
+export const SuiteAnalysisConfigSchema = z.object({
+    startingUrl: z.string().nullable().default(null),
+    username: z.string().nullable().default(null),
+    password: z.string().nullable().default(null),
+    cookiesPreference: z.nativeEnum(CookiesPreference).nullable().default(null),
+    additionalInstructions: z.string().nullable().default(null),
+    additionalVariables: z.string().nullable().default(null),
+});
+export const GenerateAIDataHandlerInputSchema = z.object({
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+});
+export const GenerateAIDataInputSchema = z.object({
+    projectUuid: z.string().min(1, "Project UUID is required"),
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    extraPrompt: z.string().nullish(),
+    sourceSuiteUuid: z.string().nullish(),
+    selectedUserStories: z.array(z.string()).nullish(),
+    suiteAnalysisConfig: SuiteAnalysisConfigSchema,
+    continueGeneration: z.boolean().nullish().default(false),
+});
+export const FetchFileHandlerInputSchema = z.object({
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+});
+export const FetchFileFactoryInputSchema = z.object({
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    bucket: z.nativeEnum(Bucket),
+});
+export const FetchFileInputSchema = z.object({
+    projectUuid: z.string().min(1, "Project UUID is required"),
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    bucket: z.nativeEnum(Bucket),
+});

package/build/tools/shared/types.js

@@ -0,0 +1,60 @@
+export var ToolName;
+(function (ToolName) {
+    ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
+    ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";
+    ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
+    ToolName["WOPEE_FETCH_APP_CONTEXT"] = "wopee_fetch_app_context";
+    ToolName["WOPEE_FETCH_GENERAL_USER_STORIES"] = "wopee_fetch_general_user_stories";
+    ToolName["WOPEE_FETCH_USER_STORIES"] = "wopee_fetch_user_stories";
+    ToolName["WOPEE_FETCH_TEST_CASES"] = "wopee_fetch_test_cases";
+    ToolName["WOPEE_GENERATE_APP_CONTEXT"] = "wopee_generate_app_context";
+    ToolName["WOPEE_GENERATE_GENERAL_USER_STORIES"] = "wopee_generate_general_user_stories";
+    ToolName["WOPEE_GENERATE_USER_STORIES"] = "wopee_generate_user_stories";
+    ToolName["WOPEE_GENERATE_TEST_CASES"] = "wopee_generate_test_cases";
+})(ToolName || (ToolName = {}));
+export const Bucket = {
+    APP_CONTEXT: "project-suite-app-context",
+    GENERAL_USER_STORIES: "project-suite-general-user-stories",
+    USER_STORIES: "project-suite-user-stories",
+    PAGE_CONTENT: "screen-instance-page-content",
+    PROMPTS: "project-prompts",
+    PLAYWRIGHT_CODE: "project-suite-playwright-code",
+    UPLOADED_PAGE_DATA: "project-uploaded-page-data",
+};
+export var GenerationType;
+(function (GenerationType) {
+    GenerationType["APP_CONTEXT"] = "APP_CONTEXT";
+    GenerationType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
+    GenerationType["USER_STORIES"] = "USER_STORIES";
+    GenerationType["TEST_CASES"] = "TEST_CASES";
+})(GenerationType || (GenerationType = {}));
+export var SuiteType;
+(function (SuiteType) {
+    SuiteType["BOT"] = "BOT";
+    SuiteType["CODE"] = "CODE";
+    SuiteType["AGENT"] = "AGENT";
+    SuiteType["ANALYSIS"] = "ANALYSIS";
+    SuiteType["INTEGRATION"] = "INTEGRATION";
+    SuiteType["UPLOADED_PAGE_DATA"] = "UPLOADED_PAGE_DATA";
+})(SuiteType || (SuiteType = {}));
+export var SuiteRunningStatus;
+(function (SuiteRunningStatus) {
+    SuiteRunningStatus["IDLE"] = "IDLE";
+    SuiteRunningStatus["FINISHED"] = "FINISHED";
+    SuiteRunningStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    SuiteRunningStatus["IN_PROGRESS_MERGE"] = "IN_PROGRESS_MERGE";
+})(SuiteRunningStatus || (SuiteRunningStatus = {}));
+export var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    ExecutionStatus["FINISHED"] = "FINISHED";
+    ExecutionStatus["FAILED"] = "FAILED";
+})(ExecutionStatus || (ExecutionStatus = {}));
+export var GenerationStatus;
+(function (GenerationStatus) {
+    GenerationStatus["NOT_STARTED"] = "NOT_STARTED";
+    GenerationStatus["IN_QUEUE"] = "IN_QUEUE";
+    GenerationStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    GenerationStatus["FINISHED"] = "FINISHED";
+    GenerationStatus["FAILED"] = "FAILED";
+})(GenerationStatus || (GenerationStatus = {}));

package/build/tools/wopee_dispatch_agent/factory.js

@@ -0,0 +1,13 @@
+import { getConfig } from "../../utils/getConfig.js";
+export const createDispatchAgentInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        projectUuid: WOPEE_PROJECT_UUID,
+        suiteUuid: input.suiteUuid,
+        analysisIdentifier: input.analysisIdentifier,
+        testCases: input.testCases,
+        skipRateLimitCheck: true,
+    };
+};

package/build/tools/wopee_dispatch_agent/index.js

@@ -0,0 +1,43 @@
+import { DispatchAgentInputSchema, WopeeDispatchAgentInputSchema, } from "./schema.js";
+import { ToolName } from "../shared/types.js";
+import { parseError } from "../shared/handlers.js";
+import { createDispatchAgentInput } from "./factory.js";
+import { DispatchAgent } from "../shared/gql-queries.js";
+import { requestClient } from "../../utils/requestClient.js";
+export const wopeeDispatchAgent = {
+    name: ToolName.WOPEE_DISPATCH_AGENT,
+    config: {
+        title: "Dispatch agent",
+        description: "Dispatch agent testing for selected suite's test cases",
+        inputSchema: WopeeDispatchAgentInputSchema.shape,
+    },
+    handler: async (input) => {
+        try {
+            const dispatchAgentInput = createDispatchAgentInput(input);
+            const parsedInput = DispatchAgentInputSchema.parse(dispatchAgentInput);
+            const result = await requestClient(DispatchAgent, {
+                input: parsedInput,
+            });
+            if (!result || !result.dispatchAgent)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to dispatch agent",
+                        },
+                    ],
+                };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Agent dispatched successfully",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return parseError(error);
+        }
+    },
+};

package/build/tools/wopee_dispatch_agent/schema.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+const SelectedTestCasesSchema = z.object({
+    testCaseId: z.string().min(1, "Test case ID is required"),
+    userStoryId: z.string().min(1, "User story ID is required"),
+});
+export const WopeeDispatchAgentInputSchema = z.object({
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    analysisIdentifier: z.string().min(1, "Analysis identifier is required"),
+    testCases: z.array(SelectedTestCasesSchema),
+});
+export const DispatchAgentInputSchema = z.object({
+    projectUuid: z.string().min(1, "Project UUID is required"),
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    analysisIdentifier: z.string().min(1, "Analysis identifier is required"),
+    testCases: z.array(SelectedTestCasesSchema),
+    skipRateLimitCheck: z.boolean().nullable().default(true),
+});

package/build/tools/wopee_dispatch_analysis/factory.js

@@ -0,0 +1,18 @@
+import { getConfig } from "../../utils/getConfig.js";
+export const createDispatchAnalysisInput = () => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        projectUuid: WOPEE_PROJECT_UUID,
+        suiteAnalysisConfig: {
+            startingUrl: null,
+            username: null,
+            password: null,
+            cookiesPreference: null,
+            additionalInstructions: null,
+            additionalVariables: null,
+        },
+        rerun: null,
+    };
+};

package/build/tools/wopee_dispatch_analysis/index.js

@@ -0,0 +1,42 @@
+import { parseError } from "../shared/handlers.js";
+import { DispatchAnalysisInputSchema } from "./schema.js";
+import { createDispatchAnalysisInput } from "./factory.js";
+import { DispatchAnalysis } from "../shared/gql-queries.js";
+import { requestClient } from "../../utils/requestClient.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",
+    },
+    handler: async () => {
+        try {
+            const input = createDispatchAnalysisInput();
+            const parsedInput = DispatchAnalysisInputSchema.parse(input);
+            const result = await requestClient(DispatchAnalysis, {
+                input: parsedInput,
+            });
+            if (!result || !result.dispatchAnalysis)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to dispatch agent",
+                        },
+                    ],
+                };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Agent dispatched successfully",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return parseError(error);
+        }
+    },
+};

package/build/tools/wopee_dispatch_analysis/schema.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { SuiteAnalysisConfigSchema } from "../shared/schemas.js";
+var RerunMode;
+(function (RerunMode) {
+    RerunMode["FULL"] = "FULL";
+    RerunMode["CRAWLING"] = "CRAWLING";
+})(RerunMode || (RerunMode = {}));
+const RerunOptionsSchema = z.object({
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    analysisIdentifier: z.string().min(1, "Analysis identifier is required"),
+    mode: z.nativeEnum(RerunMode),
+});
+export const DispatchAnalysisInputSchema = z.object({
+    projectUuid: z.string().min(1, "Project UUID is required"),
+    suiteAnalysisConfig: SuiteAnalysisConfigSchema,
+    rerun: RerunOptionsSchema.nullable().default(null),
+});

package/build/tools/wopee_fetch_analysis_suites/index.js

@@ -0,0 +1,43 @@
+import { requestClient } from "../../utils/requestClient.js";
+import { ToolName } from "../shared/types.js";
+import { FetchAnalysisSuites } from "../shared/gql-queries.js";
+import { getConfig } from "../../utils/getConfig.js";
+export const wopeeFetchAnalysisSuites = {
+    name: ToolName.WOPEE_FETCH_ANALYSIS_SUITES,
+    config: {
+        title: "Fetch Analysis Suites",
+        description: "Fetch project's analysis suites from Woopee",
+    },
+    handler: async () => {
+        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 || !result.fetchAnalysisSuites)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Failed to fetch analysis suites",
+                    },
+                ],
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result.fetchAnalysisSuites, null, 2),
+                },
+            ],
+        };
+    },
+};

package/build/tools/wopee_fetch_app_context/index.js

@@ -0,0 +1,15 @@
+import { fetchFile } from "../shared/handlers.js";
+import { Bucket, ToolName } from "../shared/types.js";
+import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
+export const wopeeFetchAppContext = {
+    name: ToolName.WOPEE_FETCH_APP_CONTEXT,
+    config: {
+        title: "Fetch app context",
+        description: "Fetch suite's application context markdown file for selected project",
+        inputSchema: FetchFileHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchFile({
+        ...input,
+        bucket: Bucket.APP_CONTEXT,
+    }),
+};

package/build/tools/wopee_fetch_general_user_stories/index.js

@@ -0,0 +1,15 @@
+import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
+import { fetchFile } from "../shared/handlers.js";
+import { Bucket, ToolName } from "../shared/types.js";
+export const wopeeFetchGeneralUserStories = {
+    name: ToolName.WOPEE_FETCH_GENERAL_USER_STORIES,
+    config: {
+        title: "Fetch general user stories",
+        description: "Fetch suite's general user stories markdown file for selected project",
+        inputSchema: FetchFileHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchFile({
+        ...input,
+        bucket: Bucket.GENERAL_USER_STORIES,
+    }),
+};

package/build/tools/wopee_fetch_test_cases/index.js

@@ -0,0 +1,15 @@
+import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
+import { fetchFile } from "../shared/handlers.js";
+import { Bucket, ToolName } from "../shared/types.js";
+export const wopeeFetchTestCases = {
+    name: ToolName.WOPEE_FETCH_TEST_CASES,
+    config: {
+        title: "Fetch test cases",
+        description: "Fetch suite's test cases JSON file for selected project",
+        inputSchema: FetchFileHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchFile({
+        ...input,
+        bucket: Bucket.USER_STORIES,
+    }),
+};

package/build/tools/wopee_fetch_user_stories/index.js

@@ -0,0 +1,15 @@
+import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
+import { fetchFile } from "../shared/handlers.js";
+import { Bucket, ToolName } from "../shared/types.js";
+export const wopeeFetchUserStories = {
+    name: ToolName.WOPEE_FETCH_USER_STORIES,
+    config: {
+        title: "Fetch user stories",
+        description: "Fetch suite's user stories JSON file for selected project",
+        inputSchema: FetchFileHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchFile({
+        ...input,
+        bucket: Bucket.USER_STORIES,
+    }),
+};

package/build/tools/wopee_generate_app_context/index.js

@@ -0,0 +1,12 @@
+import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
+import { generateAIDataFile } from "../shared/handlers.js";
+import { GenerationType, ToolName } from "../shared/types.js";
+export const wopeeGenerateAppContext = {
+    name: ToolName.WOPEE_GENERATE_APP_CONTEXT,
+    config: {
+        title: "Generate app context",
+        description: "Generate application's context markdown file for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(GenerationType.APP_CONTEXT, input),
+};

package/build/tools/wopee_generate_general_user_stories/index.js

@@ -0,0 +1,12 @@
+import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
+import { generateAIDataFile } from "../shared/handlers.js";
+import { GenerationType, ToolName } from "../shared/types.js";
+export const wopeeGenerateGeneralUserStories = {
+    name: ToolName.WOPEE_GENERATE_GENERAL_USER_STORIES,
+    config: {
+        title: "Generate general user stories",
+        description: "Generate general user stories markdown file for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(GenerationType.GENERAL_USER_STORIES, input),
+};

package/build/tools/wopee_generate_test_cases/index.js

@@ -0,0 +1,12 @@
+import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
+import { generateAIDataFile } from "../shared/handlers.js";
+import { GenerationType, ToolName } from "../shared/types.js";
+export const wopeeGenerateTestCases = {
+    name: ToolName.WOPEE_GENERATE_TEST_CASES,
+    config: {
+        title: "Generate test cases",
+        description: "Generate test cases for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(GenerationType.TEST_CASES, input),
+};

package/build/tools/wopee_generate_user_stories/index.js

@@ -0,0 +1,12 @@
+import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
+import { generateAIDataFile } from "../shared/handlers.js";
+import { GenerationType, ToolName } from "../shared/types.js";
+export const wopeeGenerateUserStories = {
+    name: ToolName.WOPEE_GENERATE_USER_STORIES,
+    config: {
+        title: "Generate user stories",
+        description: "Generate user stories JSON file for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(GenerationType.USER_STORIES, input),
+};

package/build/utils/getConfig.js

@@ -0,0 +1,10 @@
+export const getConfig = () => {
+    const WOPEE_API_URL = process.env.WOPEE_API_URL ?? "https://api.wopee.io";
+    const WOPEE_API_KEY = process.env.WOPEE_API_KEY ?? null;
+    const WOPEE_PROJECT_UUID = process.env.WOPEE_PROJECT_UUID ?? null;
+    return {
+        WOPEE_API_URL,
+        WOPEE_API_KEY,
+        WOPEE_PROJECT_UUID,
+    };
+};

package/build/utils/requestClient.js

@@ -0,0 +1,37 @@
+import { getConfig } from "./getConfig.js";
+export const requestClient = async (query, variables) => {
+    const { WOPEE_API_URL, WOPEE_API_KEY } = getConfig();
+    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}`, {
+            method: "POST",
+            headers,
+            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;
+    }
+};

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {