@mtaap/mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +160 -17
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # MTAAP MCP Server
2
2
 
3
- Standalone MCP server for managing tasks, projects, and git integration.
3
+ 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.
4
4
 
5
5
  ## Installation
6
6
 
@@ -18,7 +18,7 @@ npx @mtaap/mcp
18
18
 
19
19
  | Variable | Description |
20
20
  |----------|-------------|
21
- | `MTAAP_API_KEY` | Your MTAAP API key. Generate one at https://app.mtaap.io/settings/api-keys |
21
+ | `MTAAP_API_KEY` | Your MTAAP API key. Generate one at https://collab.mtaap.de/settings/api-keys |
22
22
 
23
23
  ### Optional Environment Variables
24
24
 
@@ -36,40 +36,183 @@ export GITHUB_TOKEN=ghp_xxxxx... # Optional, for git operations
36
36
  ## Available Tools
37
37
 
38
38
  ### list_projects
39
+
39
40
  List accessible projects (personal + team via tags).
40
41
 
42
+ **Parameters:**
43
+ | Name | Type | Required | Description |
44
+ |------|------|----------|-------------|
45
+ | `workspaceType` | `"TEAM"` \| `"PERSONAL"` \| `"ALL"` | No | Filter by workspace type. Defaults to `ALL`. |
46
+
47
+ **Returns:** Array of projects with id, name, description, type, origin, repositoryUrl, baseBranch, tags, timestamps.
48
+
49
+ ---
50
+
41
51
  ### list_tasks
42
- Returns available tasks (filterable by project, state).
52
+
53
+ List tasks with optional filtering.
54
+
55
+ **Parameters:**
56
+ | Name | Type | Required | Description |
57
+ |------|------|----------|-------------|
58
+ | `projectId` | string | No | Filter by project (prj_xxx format) |
59
+ | `state` | TaskState | No | Filter by state: `BACKLOG`, `READY`, `IN_PROGRESS`, `REVIEW`, `DONE` |
60
+ | `assigneeId` | string | No | Filter by assignee (usr_xxx format) |
61
+
62
+ **Returns:** Array of tasks with full details including acceptance criteria, assignee, creator, epic, PR info.
63
+
64
+ ---
43
65
 
44
66
  ### get_task
45
- Full task details including acceptance criteria.
67
+
68
+ Get full task details including acceptance criteria, progress updates, and notes.
69
+
70
+ **Parameters:**
71
+ | Name | Type | Required | Description |
72
+ |------|------|----------|-------------|
73
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
74
+
75
+ **Returns:** Complete task object with acceptance criteria, progress updates, notes, and all metadata.
76
+
77
+ ---
46
78
 
47
79
  ### assign_task
48
- Atomic claim → creates branch. Fails if already taken.
80
+
81
+ Atomically claim a task and create a feature branch. Fails if task is already assigned or not in expected state.
82
+
83
+ **Parameters:**
84
+ | Name | Type | Required | Description |
85
+ |------|------|----------|-------------|
86
+ | `projectId` | string | Yes | Project ID (prj_xxx format) |
87
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
88
+ | `expectedState` | TaskState | No | Expected task state. Defaults to `READY`. |
89
+
90
+ **Returns:** `{ success, taskId, branchName }` or error if task state doesn't match.
91
+
92
+ ---
49
93
 
50
94
  ### update_progress
51
- Reports status, updates checkboxes, writes checkpoint.
95
+
96
+ Report progress on an assigned task. Updates acceptance criteria checkboxes and records status messages.
97
+
98
+ **Parameters:**
99
+ | Name | Type | Required | Description |
100
+ |------|------|----------|-------------|
101
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
102
+ | `statusMessage` | string | No | Progress message (max 1000 chars) |
103
+ | `completedCheckpointIds` | string[] | No | IDs of acceptance criteria to mark complete |
104
+ | `currentCheckpointIndex` | number | No | Current checkpoint index |
105
+
106
+ **Returns:** `{ success, taskId }`
107
+
108
+ ---
52
109
 
53
110
  ### complete_task
54
- Marks complete, triggers PR, deletes local state file.
111
+
112
+ Mark task as complete and create a pull request.
113
+
114
+ **Parameters:**
115
+ | Name | Type | Required | Description |
116
+ |------|------|----------|-------------|
117
+ | `projectId` | string | Yes | Project ID (prj_xxx format) |
118
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
119
+ | `pullRequestTitle` | string | No | Custom PR title (max 300 chars). Defaults to `[taskId] title`. |
120
+ | `pullRequestBody` | string | No | Custom PR body (max 10000 chars). Defaults to description + acceptance criteria. |
121
+
122
+ **Returns:** `{ success, taskId, prUrl, prNumber }`
123
+
124
+ ---
55
125
 
56
126
  ### check_active_task
57
- Check for resumable task in `.mtaap/active-task.json`.
127
+
128
+ Check for a resumable task in `.mtaap/active-task.json` in the current working directory.
129
+
130
+ **Parameters:** None
131
+
132
+ **Returns:** `{ hasActiveTask, task }` where task contains saved context if found.
133
+
134
+ ---
58
135
 
59
136
  ### report_error
60
- Report unrecoverable error, displays on task in webapp.
137
+
138
+ Report an unrecoverable error on a task. The error will be displayed in the webapp.
139
+
140
+ **Parameters:**
141
+ | Name | Type | Required | Description |
142
+ |------|------|----------|-------------|
143
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
144
+ | `errorType` | ErrorType | Yes | One of: `BUILD_FAILURE`, `TEST_FAILURE`, `CONFLICT`, `AUTH_ERROR`, `OTHER` |
145
+ | `errorMessage` | string | Yes | Error description (max 1000 chars) |
146
+ | `context` | string | No | Additional context (max 2000 chars) |
147
+
148
+ **Returns:** `{ success, taskId }`
149
+
150
+ ---
61
151
 
62
152
  ### get_project_context
63
- Returns assembled context (README, stack, conventions).
153
+
154
+ Get assembled context for a project including README, tech stack, and conventions.
155
+
156
+ **Parameters:**
157
+ | Name | Type | Required | Description |
158
+ |------|------|----------|-------------|
159
+ | `projectId` | string | Yes | Project ID (prj_xxx format) |
160
+
161
+ **Returns:** `{ readme, stack, recentCompleted, conventions }` with repository README (truncated to 2000 chars), detected dependencies, recent completed tasks, and project conventions.
162
+
163
+ ---
64
164
 
65
165
  ### add_note
66
- Append implementation notes to task.
166
+
167
+ Append implementation notes to a task you are assigned to.
168
+
169
+ **Parameters:**
170
+ | Name | Type | Required | Description |
171
+ |------|------|----------|-------------|
172
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
173
+ | `content` | string | Yes | Note content (max 500 chars) |
174
+
175
+ **Returns:** `{ success, noteId }`
176
+
177
+ ---
67
178
 
68
179
  ### abandon_task
69
- Unassign self, cleanup branch, return to ready state.
180
+
181
+ Unassign yourself from a task and optionally delete the feature branch. Task returns to `READY` state if it was `IN_PROGRESS`.
182
+
183
+ **Parameters:**
184
+ | Name | Type | Required | Description |
185
+ |------|------|----------|-------------|
186
+ | `projectId` | string | Yes | Project ID (prj_xxx format) |
187
+ | `taskId` | string | Yes | Task ID (tsk_xxx format) |
188
+ | `deleteBranch` | boolean | No | Whether to delete the feature branch on GitHub |
189
+
190
+ **Returns:** `{ success, taskId, state, branchDeleted }`
191
+
192
+ ---
70
193
 
71
194
  ### create_personal_project
72
- Create project in user's personal workspace.
195
+
196
+ Create a new project in your personal workspace.
197
+
198
+ **Parameters:**
199
+ | Name | Type | Required | Description |
200
+ |------|------|----------|-------------|
201
+ | `name` | string | Yes | Project name (max 100 chars) |
202
+ | `description` | string | No | Project description (max 500 chars) |
203
+ | `repositoryUrl` | string | Yes | GitHub repository URL |
204
+
205
+ **Returns:** `{ success, projectId }`
206
+
207
+ ---
208
+
209
+ ### get_version
210
+
211
+ Get the current MTAAP MCP server version.
212
+
213
+ **Parameters:** None
214
+
215
+ **Returns:** `{ version, timestamp }`
73
216
 
74
217
  ## Usage
75
218
 
@@ -83,7 +226,7 @@ Create project in user's personal workspace.
83
226
  "command": "npx",
84
227
  "args": ["@mtaap/mcp"],
85
228
  "env": {
86
- "MTAAP_BASE_URL": "https://app.mtaap.io",
229
+ "MTAAP_BASE_URL": "https://collab.mtaap.de",
87
230
  "MTAAP_API_KEY": "your-api-key"
88
231
  }
89
232
  }
@@ -110,7 +253,7 @@ MTAAP_API_KEY=your-key pnpm start
110
253
 
111
254
  ### "MTAAP_API_KEY is required"
112
255
 
113
- You need to set the `MTAAP_API_KEY` environment variable. Generate an API key at https://app.mtaap.io/settings/api-keys
256
+ You need to set the `MTAAP_API_KEY` environment variable. Generate an API key at https://collab.mtaap.de/settings/api-keys
114
257
 
115
258
  ### "GITHUB_TOKEN is not set" warning
116
259
 
@@ -118,11 +261,11 @@ This warning appears when `GITHUB_TOKEN` is not configured. Git operations (bran
118
261
 
119
262
  ### "Invalid API key"
120
263
 
121
- Your API key may be expired or revoked. Generate a new one at https://app.mtaap.io/settings/api-keys
264
+ Your API key may be expired or revoked. Generate a new one at https://collab.mtaap.de/settings/api-keys
122
265
 
123
266
  ### Connection issues
124
267
 
125
- Ensure your firewall allows outbound connections to your MTAAP instance. By default, the server connects to `https://app.mtaap.io`.
268
+ Ensure your firewall allows outbound connections to your MTAAP instance. By default, the server connects to `https://collab.mtaap.de`.
126
269
 
127
270
  ## Publishing
128
271
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mtaap/mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "bin": {