@mtaap/mcp 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # MTAAP MCP Server
 
-Standalone MCP server for managing tasks, projects, and git integration.
+Model Context Protocol (MCP) server for AI agents to interact with MTAAP - the multi-tenant collaborative agent development platform. Enables AI agents to list projects, claim tasks, track progress, create pull requests, and more.
 
 ## Installation
 
@@ -18,7 +18,7 @@ npx @mtaap/mcp
 
 | Variable | Description |
 |----------|-------------|
-| `MTAAP_API_KEY` | Your MTAAP API key. Generate one at https://app.mtaap.io/settings/api-keys |
+| `MTAAP_API_KEY` | Your MTAAP API key. Generate one at https://collab.mtaap.de/settings/api-keys |
 
 ### Optional Environment Variables
 
@@ -36,40 +36,183 @@ export GITHUB_TOKEN=ghp_xxxxx...  # Optional, for git operations
 ## Available Tools
 
 ### list_projects
+
 List accessible projects (personal + team via tags).
 
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `workspaceType` | `"TEAM"` \| `"PERSONAL"` \| `"ALL"` | No | Filter by workspace type. Defaults to `ALL`. |
+
+**Returns:** Array of projects with id, name, description, type, origin, repositoryUrl, baseBranch, tags, timestamps.
+
+---
+
 ### list_tasks
-Returns available tasks (filterable by project, state).
+
+List tasks with optional filtering.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `projectId` | string | No | Filter by project (prj_xxx format) |
+| `state` | TaskState | No | Filter by state: `BACKLOG`, `READY`, `IN_PROGRESS`, `REVIEW`, `DONE` |
+| `assigneeId` | string | No | Filter by assignee (usr_xxx format) |
+
+**Returns:** Array of tasks with full details including acceptance criteria, assignee, creator, epic, PR info.
+
+---
 
 ### get_task
-Full task details including acceptance criteria.
+
+Get full task details including acceptance criteria, progress updates, and notes.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+
+**Returns:** Complete task object with acceptance criteria, progress updates, notes, and all metadata.
+
+---
 
 ### assign_task
-Atomic claim → creates branch. Fails if already taken.
+
+Atomically claim a task and create a feature branch. Fails if task is already assigned or not in expected state.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `projectId` | string | Yes | Project ID (prj_xxx format) |
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `expectedState` | TaskState | No | Expected task state. Defaults to `READY`. |
+
+**Returns:** `{ success, taskId, branchName }` or error if task state doesn't match.
+
+---
 
 ### update_progress
-Reports status, updates checkboxes, writes checkpoint.
+
+Report progress on an assigned task. Updates acceptance criteria checkboxes and records status messages.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `statusMessage` | string | No | Progress message (max 1000 chars) |
+| `completedCheckpointIds` | string[] | No | IDs of acceptance criteria to mark complete |
+| `currentCheckpointIndex` | number | No | Current checkpoint index |
+
+**Returns:** `{ success, taskId }`
+
+---
 
 ### complete_task
-Marks complete, triggers PR, deletes local state file.
+
+Mark task as complete and create a pull request.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `projectId` | string | Yes | Project ID (prj_xxx format) |
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `pullRequestTitle` | string | No | Custom PR title (max 300 chars). Defaults to `[taskId] title`. |
+| `pullRequestBody` | string | No | Custom PR body (max 10000 chars). Defaults to description + acceptance criteria. |
+
+**Returns:** `{ success, taskId, prUrl, prNumber }`
+
+---
 
 ### check_active_task
-Check for resumable task in `.mtaap/active-task.json`.
+
+Check for a resumable task in `.mtaap/active-task.json` in the current working directory.
+
+**Parameters:** None
+
+**Returns:** `{ hasActiveTask, task }` where task contains saved context if found.
+
+---
 
 ### report_error
-Report unrecoverable error, displays on task in webapp.
+
+Report an unrecoverable error on a task. The error will be displayed in the webapp.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `errorType` | ErrorType | Yes | One of: `BUILD_FAILURE`, `TEST_FAILURE`, `CONFLICT`, `AUTH_ERROR`, `OTHER` |
+| `errorMessage` | string | Yes | Error description (max 1000 chars) |
+| `context` | string | No | Additional context (max 2000 chars) |
+
+**Returns:** `{ success, taskId }`
+
+---
 
 ### get_project_context
-Returns assembled context (README, stack, conventions).
+
+Get assembled context for a project including README, tech stack, and conventions.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `projectId` | string | Yes | Project ID (prj_xxx format) |
+
+**Returns:** `{ readme, stack, recentCompleted, conventions }` with repository README (truncated to 2000 chars), detected dependencies, recent completed tasks, and project conventions.
+
+---
 
 ### add_note
-Append implementation notes to task.
+
+Append implementation notes to a task you are assigned to.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `content` | string | Yes | Note content (max 500 chars) |
+
+**Returns:** `{ success, noteId }`
+
+---
 
 ### abandon_task
-Unassign self, cleanup branch, return to ready state.
+
+Unassign yourself from a task and optionally delete the feature branch. Task returns to `READY` state if it was `IN_PROGRESS`.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `projectId` | string | Yes | Project ID (prj_xxx format) |
+| `taskId` | string | Yes | Task ID (tsk_xxx format) |
+| `deleteBranch` | boolean | No | Whether to delete the feature branch on GitHub |
+
+**Returns:** `{ success, taskId, state, branchDeleted }`
+
+---
 
 ### create_personal_project
-Create project in user's personal workspace.
+
+Create a new project in your personal workspace.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `name` | string | Yes | Project name (max 100 chars) |
+| `description` | string | No | Project description (max 500 chars) |
+| `repositoryUrl` | string | Yes | GitHub repository URL |
+
+**Returns:** `{ success, projectId }`
+
+---
+
+### get_version
+
+Get the current MTAAP MCP server version.
+
+**Parameters:** None
+
+**Returns:** `{ version, timestamp }`
 
 ## Usage
 
@@ -83,7 +226,7 @@ Create project in user's personal workspace.
       "command": "npx",
       "args": ["@mtaap/mcp"],
       "env": {
-        "MTAAP_BASE_URL": "https://app.mtaap.io",
+        "MTAAP_BASE_URL": "https://collab.mtaap.de",
         "MTAAP_API_KEY": "your-api-key"
       }
     }
@@ -110,7 +253,7 @@ MTAAP_API_KEY=your-key pnpm start
 
 ### "MTAAP_API_KEY is required"
 
-You need to set the `MTAAP_API_KEY` environment variable. Generate an API key at https://app.mtaap.io/settings/api-keys
+You need to set the `MTAAP_API_KEY` environment variable. Generate an API key at https://collab.mtaap.de/settings/api-keys
 
 ### "GITHUB_TOKEN is not set" warning
 
@@ -118,11 +261,11 @@ This warning appears when `GITHUB_TOKEN` is not configured. Git operations (bran
 
 ### "Invalid API key"
 
-Your API key may be expired or revoked. Generate a new one at https://app.mtaap.io/settings/api-keys
+Your API key may be expired or revoked. Generate a new one at https://collab.mtaap.de/settings/api-keys
 
 ### Connection issues
 
-Ensure your firewall allows outbound connections to your MTAAP instance. By default, the server connects to `https://app.mtaap.io`.
+Ensure your firewall allows outbound connections to your MTAAP instance. By default, the server connects to `https://collab.mtaap.de`.
 
 ## Publishing
 

package/dist/audit-B6CIQU22.js

@@ -0,0 +1,8 @@
+import {
+  logAuditEvent
+} from "./chunk-IEQQVLM4.js";
+import "./chunk-ASNGTDTC.js";
+export {
+  logAuditEvent
+};
+//# sourceMappingURL=audit-B6CIQU22.js.map

package/dist/audit-B6CIQU22.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}