@qualitas-id/mcp 1.2.0 → 1.2.1

package/README.md

@@ -7,7 +7,7 @@ MCP (Model Context Protocol) server for the [Qualitas](https://qualitas.id) test
 
 ## Features
 
-- **20 tools** for complete Qualitas platform interaction
+- **22 tools** for complete Qualitas platform interaction
 - **Flow generation from scenarios** — describe a test in natural language, get a runnable flow
 - **Auto-beautify layout** — nodes are automatically arranged in clean topological order
 - **Fragment support** — create reusable flow fragments for common patterns
@@ -206,6 +206,13 @@ Add to `.vscode/mcp.json`:
 |---|---|---|
 | `extract_screenshot_text` | OCR from image URL, extract text and error messages | read-only |
 
+### Explore
+
+| Tool | Description | Annotations |
+|---|---|---|
+| `explore_page` | **Explore a web page** — discover structure, forms, buttons, links, navigation, and network requests | write |
+| `get_explore_results` | Get results of a previously started explore session | read-only |
+
 ## Flow Generation
 
 The `generate_flow_from_scenario` tool is the core feature. Describe a test scenario in natural language and get a complete, runnable flow.
@@ -241,6 +248,46 @@ Create reusable fragments for common patterns (login, registration, etc.):
 
 **Important:** Fragments MUST NOT have a `start` node. The fragment's nodes are inlined into the calling flow.
 
+## Page Exploration
+
+The `explore_page` tool discovers what's on a web page — useful for QA testers who want to understand a page before creating test scenarios.
+
+**What it returns:**
+- Detected page type (login, dashboard, form, list, settings, etc.)
+- Page headings
+- Forms with fields and submit buttons
+- Buttons with selectors
+- Links with hrefs
+- Navigation elements
+- Input fields with names, types, placeholders
+- Network requests (XHR/Fetch)
+- Console errors
+
+**Example — explore a public page:**
+
+```
+explore_page(url="https://example.com", project_id="your-project-uuid")
+```
+
+**Example — explore with login credentials:**
+
+```
+explore_page(
+  url="https://app.example.com/login",
+  project_id="your-project-uuid",
+  credentials={
+    email: "user@example.com",
+    password: "secret123"
+  }
+)
+```
+
+**How it works:**
+1. Creates a mini test flow (navigate + optional login steps)
+2. Executes with debug mode and exploration mode enabled
+3. Captures DOM snapshot, scans all interactive elements, captures network requests
+4. Returns a structured summary of the page
+
 ## Docker
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qualitas-id/mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "MCP server for Qualitas - AI-powered test automation platform",
   "type": "module",
   "main": "dist/index.js",

package/skills/qualitas.md

@@ -11,7 +11,7 @@ metadata:
 
 Use this guide when working with the Qualitas MCP server for test automation.
 
-## MCP Tools Reference (20 tools)
+## MCP Tools Reference (22 tools)
 
 ### Projects
 | Tool | Description |
@@ -53,6 +53,12 @@ Use this guide when working with the Qualitas MCP server for test automation.
 | `extract_screenshot_text` | OCR from image URL, extract text and error messages |
 | `get_run_screenshot` | Get screenshot URLs for failed steps in a run |
 
+### Explore
+| Tool | Description |
+|------|-------------|
+| `explore_page` | Explore a web page — discover structure, forms, buttons, links, navigation, network requests. Supports optional login credentials. |
+| `get_explore_results` | Get results of a previously started explore session by run ID. |
+
 ## Fragment Rules
 
 ### CRITICAL: No Start Node in Fragments