@democratize-quality/mcp-server 1.1.7 → 1.1.9

package/README.md

@@ -18,7 +18,7 @@ npx @democratize-quality/mcp-server@latest --agents
 
 **What this does:**
 - ✅ Installs the MCP server
-- ✅ Sets up 3 AI-powered testing skills
+- ✅ Sets up 4 AI-powered testing skills
 - ✅ Configures VS Code integration automatically
 - ✅ Creates project folders (`.agents/skills/`, `.github/skills/`, `.claude/skills/`, `.vscode/`)
 - ✅ Works with: GitHub Copilot, Codex CLI, Claude Code, Cursor, and 10+ other tools
@@ -292,7 +292,7 @@ This MCP server provides **7 powerful tools** for comprehensive API testing:
 
 ## 🌐 Agent Skills (Universal AI Capabilities)
 
-When you install with `--agents`, you get 3 intelligent testing skills that work across all major AI coding tools:
+When you install with `--agents`, you get 4 intelligent testing skills that work across all major AI coding tools:
 
 ### 1. 📋 /api-planning - The Strategist
 
@@ -378,7 +378,114 @@ Sample Collection includes:
 Import into Postman and start testing!
 ```
 
-### 3. 🔬 /test-healing - The Fixer
+### 3. ⚡ /test-execution - The Runner
+
+**What it does:** Executes API tests directly from test plans without code
+
+**Best for:**
+- Running tests immediately after planning
+- Quick API validation without writing code
+- Executing specific test sections
+- Generating comprehensive HTML test reports
+
+**Example: Execute Tests from Plan**
+```
+1. After creating a test plan, type /test-execution or mention test execution
+   
+You: Execute tests from section 1 of the test plan
+
+2. Skill: I'll execute the tests from section 1 of your test plan using the api_request tool with a unique session ID. After execution, I'll generate an HTML report with all results.
+
+3. When prompted, allow the tool call "Run api_request democratize-quality (MCP Server)"
+
+Execution Results:
+✅ GET /api/v1/Books - List all books (200 OK, 145ms)
+✅ GET /api/v1/Books/1 - Get book by ID (200 OK, 98ms)
+✅ POST /api/v1/Books - Create new book (201 Created, 203ms)
+✅ PUT /api/v1/Books/1 - Update book (200 OK, 156ms)
+✅ DELETE /api/v1/Books/1 - Delete book (204 No Content, 87ms)
+
+Test Summary:
+- Total: 5 tests
+- Passed: 5 (100%)
+- Failed: 0 (0%)
+- Total Time: 689ms
+
+📊 HTML Report: ./api-test-reports/test-execution-1739597400000-report.html
+```
+
+**Example: Execute Full Test Plan**
+```
+You: /test-execution run all tests from the test plan and generate a report
+
+Skill: Executing entire test plan...
+
+Progress:
+📋 Section 1: Books API (5 tests)
+  ✅ GET /api/v1/Books
+  ✅ GET /api/v1/Books/{id}
+  ✅ POST /api/v1/Books
+  ✅ PUT /api/v1/Books/{id}
+  ✅ DELETE /api/v1/Books/{id}
+
+📋 Section 2: Authors API (4 tests)
+  ✅ GET /api/v1/Authors
+  ✅ GET /api/v1/Authors/{id}
+  ✅ POST /api/v1/Authors
+  ✅ DELETE /api/v1/Authors/{id}
+
+📋 Section 3: Users API (4 tests)  
+  ✅ GET /api/v1/Users
+  ✅ POST /api/v1/Users
+  ❌ PUT /api/v1/Users/{id} - 404 Not Found
+  ✅ DELETE /api/v1/Users/{id}
+
+Final Summary:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Total: 13 tests
+Passed: 12 (92.3%)
+Failed: 1 (7.7%)
+Total Time: 1.8s
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Comprehensive HTML Report Generated:
+./api-test-reports/full-plan-execution-report.html
+
+Open in browser for:
+- Detailed request/response logs
+- Timing analysis and charts
+- Visual pass/fail indicators
+- Validation results
+```
+
+**Example: Execute with CRUD Workflow**
+```
+You: /test-execution run the Books CRUD tests with request chaining
+
+Skill: Executing CRUD workflow with request chaining...
+
+Step 1: CREATE book
+  ✅ POST /api/v1/Books
+  📌 Extracted: bookId = 42
+
+Step 2: READ created book
+  ✅ GET /api/v1/Books/42
+  📌 Verified: Book exists with correct data
+
+Step 3: UPDATE book
+  ✅ PUT /api/v1/Books/42
+  📌 Verified: Book updated successfully
+
+Step 4: DELETE book
+  ✅ DELETE /api/v1/Books/42
+  📌 Verified: Book deleted (204 No Content)
+
+Workflow Complete: All 4 operations successful! ✅
+
+📊 Report: ./api-test-reports/crud-workflow-report.html
+```
+
+### 4. 🔬 /test-healing - The Fixer
 
 **What it does:** Automatically diagnoses and repairs failing tests
 
@@ -540,13 +647,56 @@ Import the generated collection into Postman and start testing!
 
 **Result:** Professional Postman collection ready to share with your team
 
+### Scenario 3: Quick API Validation Without Code
+
+**Goal:** Execute API tests immediately without generating code files
+
+```
+Step 1:
+/api-planning create test plan from 
+https://fakerestapi.azurewebsites.net/swagger/v1/swagger.json
+focusing on Books and Users endpoints
+
+Step 2:
+/test-execution run all tests from the test plan and generate HTML report
+
+Step 3:
+Open the generated HTML report to see detailed results!
+```
+
+**What you get:**
+- ⚡ Instant test execution without writing code
+- 📊 Interactive HTML report with:
+  - Pass/fail indicators for each endpoint
+  - Request/response details
+  - Response timing analysis
+  - Visual charts and statistics
+- ✅ Quick validation of API before writing automated tests
+- 🔄 Easy to re-run for regression testing
+
+**Use cases:**
+- Quick API health checks
+- Validating API after deployments
+- API exploration and documentation
+- Testing APIs before committing to test code
+- Sharing test results with non-technical stakeholders
+
+**Alternative workflow with specific sections:**
+```
+You: /test-execution execute section 1 (Books API) from the test plan
+
+Result:
+✅ 5/5 tests passed
+📊 Report: ./api-test-reports/books-section-report.html
+```
+
 ---
 
 ## 🔧 Calling Individual Tools
 
 ### When to Use Individual Tools
 
-**Use skills (/api-planning, /test-generation, /test-healing) when:**
+**Use skills (/api-planning, /test-generation, /test-execution, /test-healing) when:**
 - You want AI assistance and recommendations
 - You're working on complex, multi-step workflows
 - You need explanations and best practices
@@ -1242,17 +1392,22 @@ npm run dev
 
 ---
 
-## 📄 License
+## License
 
-ISC License - See [LICENSE](LICENSE) file for details
+This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
 
----
+Copyright (C) 2025 Democratize Quality
 
-## � License
+This program is free software: you can redistribute it and/or modify it under 
+the terms of the GNU Affero General Public License as published by the Free 
+Software Foundation, either version 3 of the License, or (at your option) any 
+later version.
 
-This project is licensed under the **ISC License** - see the [LICENSE](LICENSE) file for details.
+If you modify this software and run it as a network service, you must make your 
+modified source code available to users of that service under the same license.
 
-**TL;DR:** Free to use, modify, and distribute. No warranty. Use at your own risk.
+See the [LICENSE](LICENSE) file for the full license text, or visit  
+https://www.gnu.org/licenses/agpl-3.0.html
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@democratize-quality/mcp-server",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "main": "mcpServer.js",
   "bin": {
     "democratize-quality-mcp": "cli.js",
@@ -48,7 +48,7 @@
     "end-to-end-testing"
   ],
   "author": "Raj Uppadhyay",
-  "license": "ISC",
+  "license": "AGPL-3.0-or-later",
   "description": "MCP Server for democratizing quality through browser automation and comprehensive API testing capabilities",
   "homepage": "https://github.com/uppadhyayraj/democratize-quality-mcp-server#readme",
   "repository": {