@testkase/mcp-server 1.0.1 → 2.0.0

package/PAT_APIS_INVENTORY.csv

@@ -0,0 +1,27 @@
+PAT_ENABLED,MCP_IMPLEMENTED,ENDPOINT
+true,true,POST /projects/testcases/create-testcase/{projectId}
+true,true,POST /projects/testcases/create-bulk-testcase/{projectId}
+true,true,GET /projects/testcases/get-testcase/{projectId}
+true,true,GET /projects/testcases/get-testcase-detail/{projectId}/{id}
+true,true,GET /projects/testcases/get-testcase-history/{projectId}/{id}
+true,true,PATCH /projects/testcases/update-field/{projectId}
+true,true,DELETE /projects/testcases/delete-testcase/{projectId}
+true,true,POST /projects/testcases/clone/{projectId}/{id}
+true,true,POST /projects/testcases/teststeps/{projectId}/{testcaseId}
+true,true,DELETE /projects/testcases/teststeps/{testcaseId}
+true,true,GET /projects/testcases/download/{projectId}
+true,true,POST /projects/testcases/import/{projectId}
+true,true,POST /folders/create-folders
+true,true,GET /folders/get-folders
+true,true,DELETE /folders/delete/{id}
+true,true,PATCH /folders/{id}
+true,true,POST /projects/labels/create/{projectId}
+true,true,GET /projects/labels/get-label/{projectId}
+true,true,GET /user/my-projects
+true,true,GET /auth/me
+true,true,GET /my-organization
+true,true,GET /{organization_id}/{project_id}/{integration_type}/testcases/{testcase_id}/issues
+true,true,GET /{project_id}/{integration_type}/issues/search
+true,true,POST /{organization_id}/{project_id}/{testcase_id}/{integration_type}/issues/map
+true,true,GET /{project_id}/testcases/generate
+true,true,POST /projects/issues/create-issues/{projectId}

package/README.md

@@ -3,8 +3,6 @@
 [![npm version](https://img.shields.io/npm/v/@testkase/mcp-server.svg)](https://www.npmjs.com/package/@testkase/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-> ⚠️ **TEST MODE**: This package is currently in testing phase and connects to the TestKase QA environment.
-
 Model Context Protocol (MCP) server for TestKase API. Enables AI agents like Claude Desktop and GitHub Copilot to interact with your TestKase testcase management system.
 
 ## Features
@@ -34,7 +32,7 @@ npm install @testkase/mcp-server
 
 ### 1. Get Your PAT Token
 
-1. Log in to [TestKase QA](https://qa.testkase.com)
+1. Log in to [TestKase](https://apiqa.testkase.com)
 2. Navigate to **Settings → Personal Access Tokens**
 3. Click **"Generate New Token"**
 4. Copy the token (starts with `xyz_`)
@@ -95,23 +93,47 @@ Ask your AI agent:
 - "Show high priority testcases from project ABC-123"
 - "Find testcases containing 'login' in project XYZ-456"
 
-## Available Tools
-
-### `get_testcases`
-
-Retrieve testcases from a project with optional filters and pagination.
-
-**Parameters:**
-- `projectId` (required): Project UUID
-- `organizationId` (required): Organization ID
-- `page`: Page number (default: 1)
-- `limit`: Items per page (default: 20)
-- `search`: Search term
-- `searchType`: `"normal"` or `"ai_search"`
-- `filters`: JSON string with filters
-- `sortBy`: Field to sort by
-- `sortOrder`: `"asc"` or `"desc"`
-- And more...
+## Available Tools (26 Total)
+
+### Testcases (12 tools)
+- **`get_testcases`** - Retrieve testcases with filtering, pagination, and search
+- **`get_testcase_detail`** - Get detailed information about a specific testcase
+- **`get_testcase_history`** - View complete change history of a testcase
+- **`create_testcase`** - Create a new testcase with optional test steps
+- **`create_bulk_testcase`** - Create multiple testcases at once
+- **`update_testcase_field`** - Update specific fields for one or multiple testcases
+- **`delete_testcase`** - Delete single or multiple testcases
+- **`clone_testcase`** - Clone an existing testcase with all its steps
+- **`create_test_step`** - Create or update test steps for a testcase
+- **`delete_test_step`** - Delete test steps from a testcase
+- **`download_testcases`** - Download testcases as CSV file
+- **`import_testcases`** - Import testcases from CSV file
+
+### Folders (4 tools)
+- **`get_folders`** - Get folder/section structure of a project
+- **`create_folder`** - Create a new folder in a project
+- **`delete_folder`** - Delete a folder and its subfolders
+- **`update_folder`** - Rename or update folder details
+
+### Labels (2 tools)
+- **`get_labels`** - Get all labels/tags available in a project
+- **`create_label`** - Create new labels for a project
+
+### Projects (1 tool)
+- **`get_my_projects`** - Get all projects the user has access to
+
+### Auth & Organization (2 tools)
+- **`get_user_profile`** - Get current logged-in user profile information
+- **`get_organization`** - Get current user organization details
+
+### Integration (3 tools)
+- **`get_mapped_issues`** - Get mapped issues for a specific testcase
+- **`search_issues`** - Search issues from integrated platforms (Jira, GitHub, GitLab)
+- **`map_issues`** - Map integration issues to a TestKase requirement/defect
+
+### AI & Issues (2 tools)
+- **`generate_testcases`** - Generate testcases using AI from requirement text
+- **`create_issue`** - Create or update a requirement or defect issue
 
 ## Configuration
 
@@ -120,28 +142,51 @@ Retrieve testcases from a project with optional filters and pagination.
 - **`TESTKASE_API_BASE_URL`**: API base URL (default: `https://apiqa.testkase.com`)
 - **`TESTKASE_PAT_TOKEN`**: Your Personal Access Token (required)
 
-> **Note**: This package is configured for the TestKase QA environment. The API base URL is pre-configured and should not be changed unless instructed by TestKase support.
+### Using with Different Environments
+
+**Production:**
+```json
+"env": {
+  "TESTKASE_API_BASE_URL": "https://api.testkase.com",
+  "TESTKASE_PAT_TOKEN": "xyz_your_token"
+}
+```
+
+**Local Development:**
+```json
+"env": {
+  "TESTKASE_API_BASE_URL": "http://localhost:8080",
+  "TESTKASE_PAT_TOKEN": "xyz_your_token"
+}
+```
 
 ## Usage Examples
 
-### Basic Query
+### Basic Queries
 ```
 "Show me testcases for project PRJ-1030 organization 1171"
+"Get high priority active testcases from project PRJ-1030 org 1171"
+"Find testcases about 'authentication' in project PRJ-1030 org 1171"
+"Show testcases updated this week in project PRJ-1030 org 1171"
 ```
 
-### Filtered Query
+### Detailed Information
 ```
-"Get high priority active testcases from project PRJ-1030 org 1171"
+"Get detailed information about testcase TC-123 in project PRJ-1030 org 1171"
+"Show me the history of changes for testcase TC-456 in project PRJ-1030 org 1171"
 ```
 
-### Search Query
+### Project Organization
 ```
-"Find testcases about 'authentication' in project PRJ-1030 org 1171"
+"Show me all folders in project PRJ-1030 org 1171"
+"List all labels available in project PRJ-1030 org 1171"
+"Get all issues/defects for project PRJ-1030 org 1171"
 ```
 
-### Date Range
+### User Projects
 ```
-"Show testcases updated this week in project PRJ-1030 org 1171"
+"Show me all my projects"
+"List all projects I have access to"
 ```
 
 ## Troubleshooting
@@ -168,8 +213,6 @@ Retrieve testcases from a project with optional filters and pagination.
 
 ## Support
 
-> **Note**: This is a test version connecting to the QA environment at `https://apiqa.testkase.com`
-
 - 📧 Email: support@testkase.com
 - 🌐 Website: [testkase.com](https://testkase.com)
 
@@ -186,6 +229,23 @@ MIT © TestKase
 
 ## Changelog
 
+### 1.1.0 (TBD)
+- Added 6 new tools for comprehensive TestKase API access
+- `get_testcase_detail` - Get detailed testcase information
+- `get_testcase_history` - View testcase change history
+- `get_folders` - List project folders/sections
+- `get_labels` - List project labels/tags
+- `get_issues` - List project issues/defects
+- `get_my_projects` - List all accessible projects
+- Improved error handling and validation
+- Added helper functions for common operations
+
+### 1.0.1 (2026-01-30)
+- Updated README with TEST MODE warning
+- Updated PAT token generation URL to qa.testkase.com
+- Removed local development configurations
+- Added QA environment notes
+
 ### 1.0.0 (2026-01-30)
 - Initial release
 - Support for `get_testcases` tool